1 | <?php |
||
12 | class DI implements DIInterface |
||
13 | { |
||
14 | /** |
||
15 | * @var array $loaded Store all lazy loaded services, ready to be |
||
16 | * instantiated. |
||
17 | * @var array $active A service is instantiated into this array, |
||
18 | * once its accessed. |
||
19 | */ |
||
20 | protected $loaded = []; |
||
21 | protected $active = []; |
||
22 | |||
23 | |||
24 | |||
25 | /** |
||
26 | * Finds an entry in the container by its identifier and returns it. |
||
27 | * If the service is active/singelton then that instance is returned, |
||
28 | * else the service is loaded and a new instance is returned. |
||
29 | * |
||
30 | * @param string $service Identifier of the entry to look for. |
||
31 | * |
||
32 | * @throws NotFoundException No entry was found for this identifier. |
||
33 | * @throws Exception Error while retrieving the entry. |
||
34 | * |
||
35 | * @return mixed Entry. |
||
36 | */ |
||
37 | 8 | public function get($service) |
|
50 | |||
51 | |||
52 | |||
53 | /** |
||
54 | * Load a prepared service object and create an instance of it. |
||
55 | * |
||
56 | * @param string $service as a service label, naming this service. |
||
57 | * |
||
58 | * @throws Exception when service could not be loaded. |
||
59 | * |
||
60 | * @return object as instance of the service object. |
||
61 | */ |
||
62 | 8 | protected function load($service) |
|
63 | { |
||
64 | 8 | $sol = isset($this->loaded[$service]['loader']) |
|
65 | 8 | ? $this->loaded[$service]['loader'] |
|
66 | 8 | : null; |
|
67 | |||
68 | 8 | if (is_callable($sol)) { |
|
69 | // Load by calling a function |
||
70 | try { |
||
71 | 6 | $this->active[$service] = $sol(); |
|
72 | } catch (\Exception $e) { |
||
73 | throw new Exception( |
||
74 | "Could not load service '$service'." |
||
75 | . "Failed in the callback that instantiates the service. " |
||
76 | 6 | . $e->getMessage() |
|
77 | ); |
||
78 | } |
||
79 | 2 | } elseif (is_object($sol)) { |
|
80 | // Load by pre-instantiated object |
||
81 | 1 | $this->active[$service] = $sol; |
|
82 | 1 | } elseif (is_string($sol)) { |
|
83 | // Load by creating a new object from class-string |
||
84 | 1 | if (!class_exists($sol)) { |
|
85 | throw new Exception( |
||
86 | "Could not load service '$service'." |
||
87 | . "Class '$sol' does not exists." |
||
88 | ); |
||
89 | } |
||
90 | 1 | $this->active[$service] = new $sol(); |
|
91 | } else { |
||
92 | throw new Exception("The service '$service' has no init mechanism."); |
||
93 | } |
||
94 | |||
95 | 8 | $this->$service = $this->active[$service]; |
|
96 | 8 | return $this->active[$service]; |
|
97 | } |
||
98 | |||
99 | |||
100 | |||
101 | /** |
||
102 | * Returns true if the container can return an entry for the given |
||
103 | * identifier, otherwise false |
||
104 | * |
||
105 | * @param string $service Identifier of the entry to look for. |
||
106 | * |
||
107 | * @return boolean |
||
108 | */ |
||
109 | 8 | public function has($service) |
|
113 | |||
114 | |||
115 | |||
116 | /** |
||
117 | * Set a service and connect it to a task which creates the object |
||
118 | * (lazy loading). |
||
119 | * |
||
120 | * @param string $service as a service label, naming this service. |
||
121 | * @param mixed $loader contains a pre-defined object, a string with |
||
122 | * class name or an callable which returns an |
||
123 | * instance of the service object. Its the way |
||
124 | * to actually load, insantiate, the service |
||
125 | * object. |
||
126 | * |
||
127 | * @return void |
||
128 | */ |
||
129 | 8 | public function set($service, $loader) |
|
134 | |||
135 | |||
136 | |||
137 | /** |
||
138 | * Set a singleton service and connect it to a task which creates the |
||
139 | * object (lazy loading). |
||
140 | * |
||
141 | * @param string $service as a service label, naming this service. |
||
142 | * @param mixed $loader contains a pre-defined object, a string with |
||
143 | * class name or an callable which returns an |
||
144 | * instance of the service object. Its the way |
||
145 | * to actually load, insantiate, the service |
||
146 | * object. |
||
147 | * |
||
148 | * @return void |
||
149 | */ |
||
150 | 8 | public function setShared($service, $loader) |
|
155 | |||
156 | |||
157 | |||
158 | /** |
||
159 | * Return an arry with all loaded services names. |
||
160 | * |
||
161 | * @return void |
||
162 | */ |
||
163 | 3 | public function getServices() |
|
167 | |||
168 | |||
169 | |||
170 | /** |
||
171 | * Return an arry with all active services names. |
||
172 | * |
||
173 | * @return void |
||
174 | */ |
||
175 | public function getActiveServices() |
||
179 | } |
||
180 |