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
|
<?php /** * Interface ServiceContainer. * * @package AmpProject\AmpWP */
namespace AmpProject\AmpWP\Infrastructure;
use AmpProject\AmpWP\Exception\InvalidService; use ArrayAccess; use Countable; use Traversable;
/** * The service container collects all services to manage them. * * This is based on PSR-11 and should extend that one if Composer dependencies * are being used. Relying on a standardized interface like PSR-11 means you'll * be able to easily swap out the implementation for something else later on. * * @see https://www.php-fig.org/psr/psr-11/ * @since 2.0 * @internal */ interface ServiceContainer extends Traversable, Countable, ArrayAccess {
/** * Find a service of the container by its identifier and return it. * * @param string $id Identifier of the service to look for. * * @throws InvalidService If the service could not be found. * * @return Service Service that was requested. */ public function get( $id );
/** * Check whether the container can return a service for the given * identifier. * * @param string $id Identifier of the service to look for. * * @return bool */ public function has( $id );
/** * Put a service into the container for later retrieval. * * @param string $id Identifier of the service to put into the * container. * @param Service $service Service to put into the container. */ public function put( $id, Service $service ); }
|