ContainerInterface.php
2.05 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
<?php
/**
* @license GPL-2.0-or-later
*
* Modified by learndash on 10-July-2023 using Strauss.
* @see https://github.com/BrianHenryIE/strauss
*/ declare( strict_types=1 );
namespace StellarWP\Learndash\StellarWP\ContainerContract;
/**
* Describes the interface of a container that exposes methods to read its entries.
*/
interface ContainerInterface {
/**
* Binds an interface, a class or a string slug to an implementation.
*
* Existing implementations are replaced.
*
* @param string|class-string $id Identifier of the entry to look for.
* @param mixed $implementation The implementation that should be bound to the alias(es); can be a
* class name, an object or a closure.
*
* @return void
*/
public function bind( string $id, $implementation = null );
/**
* Finds an entry of the container by its identifier and returns it.
*
* @template T
*
* @param string|class-string<T> $id Identifier of the entry to look for.
*
* @return ($id is class-string<T> ? T : mixed) Entry.
*/
public function get( string $id );
/**
* Returns true if the container can return an entry for the given identifier.
* Returns false otherwise.
*
* `has($id)` returning true does not mean that `get($id)` will not throw an exception.
* It does however mean that `get($id)` will not throw a `NotFoundExceptionInterface`.
*
* @param string|class-string $id Identifier of the entry to look for.
*
* @return bool
*/
public function has( string $id );
/**
* Binds an interface a class or a string slug to an implementation and will always return the same instance.
*
* @param string|class-string $id Identifier of the entry to look for.
* @param mixed $implementation The implementation that should be bound to the alias(es); can be a
* class name, an object or a closure.
*
* @return void This method does not return any value.
*/
public function singleton( string $id, $implementation = null );
}