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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
<?php
/**
* Matomo - free/libre analytics platform
*
* @link https://matomo.org
* @license https://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
*/
namespace Piwik\Container;
use Piwik\Container\Container;
use Piwik\Exception\DI\DependencyException;
use Piwik\Exception\DI\NotFoundException;
/**
* This class provides a static access to the container.
*
* @internal
* This class is introduced only to keep BC with the current static architecture. It might be removed in a future version.
* - it is global state (that class makes the container a global variable)
* - using the container directly is the "service locator" anti-pattern (which is not dependency injection)
*/
class StaticContainer
{
/**
* @var Container[]
*/
private static $containerStack = array();
/**
* Definitions to register in the container.
*
* @var array[]
*/
private static $definitions = array();
/**
* @return Container
*/
public static function getContainer()
{
if (empty(self::$containerStack)) {
throw new ContainerDoesNotExistException("The root container has not been created yet.");
}
return end(self::$containerStack);
}
public static function clearContainer()
{
self::pop();
}
/**
* Only use this in tests.
*
*/
public static function push(Container $container)
{
self::$containerStack[] = $container;
}
public static function pop()
{
array_pop(self::$containerStack);
}
public static function addDefinitions(array $definitions)
{
self::$definitions[] = $definitions;
}
/**
* Proxy to Container::get()
*
* @template T of object
* @param class-string<T>|string $name Container entry name.
* @return ($name is class-string<T> ? T : mixed)
* @throws NotFoundException|DependencyException
*/
public static function get($name)
{
try {
return self::getContainer()->get($name);
} catch (\DI\NotFoundException $e) {
throw new NotFoundException($e->getMessage(), $e->getCode(), $e);
} catch (\DI\DependencyException $e) {
throw new DependencyException($e->getMessage(), $e->getCode(), $e);
}
}
public static function getDefinitions()
{
return self::$definitions;
}
}
|
