Commit | Line | Data |
---|---|---|
711aa5d7 TO |
1 | <?php |
2 | ||
3 | /** | |
4 | * Class Civi | |
5 | * | |
6 | * The "Civi" class provides a facade for accessing major subsystems, | |
7 | * such as the service-container and settings manager. It serves as a | |
8 | * bridge which allows procedural code to access important objects. | |
9 | * | |
10 | * General principles: | |
11 | * - Each function provides access to a major subsystem. | |
12 | * - Each function performs a simple lookup. | |
13 | * - Each function returns an interface. | |
14 | * - Whenever possible, interfaces should be well-known (e.g. based | |
15 | * on a standard or well-regarded provider). | |
16 | */ | |
17 | class Civi { | |
18 | ||
19 | /** | |
20 | * A central location for static variable storage. | |
21 | * | |
22 | * @code | |
23 | * `Civi::$statics[__CLASS__]['foo'] = 'bar'; | |
24 | * @endcode | |
25 | */ | |
26 | public static $statics = array(); | |
27 | ||
7b5937fe TO |
28 | /** |
29 | * EXPERIMENTAL. Retrieve a named cache instance. | |
30 | * | |
31 | * This interface is flagged as experimental due to political | |
32 | * ambiguity in PHP community -- PHP-FIG has an open but | |
33 | * somewhat controversial draft standard for caching. Based on | |
34 | * the current draft, it's expected that this function could | |
35 | * simultaneously support both CRM_Utils_Cache_Interface and | |
36 | * PSR-6, but that depends on whether PSR-6 changes any more. | |
37 | * | |
38 | * @param string $name | |
39 | * The name of the cache. The 'default' cache is biased toward | |
40 | * high-performance caches (eg memcache/redis/apc) when | |
41 | * available and falls back to single-request (static) caching. | |
42 | * @return CRM_Utils_Cache_Interface | |
43 | */ | |
44 | public static function cache($name = 'default') { | |
45 | return \Civi\Core\Container::singleton()->get('cache.' . $name); | |
46 | } | |
47 | ||
711aa5d7 TO |
48 | /** |
49 | * Get the service container. | |
50 | * | |
51 | * @return \Symfony\Component\DependencyInjection\ContainerInterface | |
52 | */ | |
53 | public static function container() { | |
54 | return Civi\Core\Container::singleton(); | |
55 | } | |
56 | ||
83617886 TO |
57 | /** |
58 | * @return \Civi\Core\Lock\LockManager | |
59 | */ | |
60 | public static function lockManager() { | |
61 | return \Civi\Core\Container::getBootService('lockManager'); | |
62 | } | |
63 | ||
6e5ad5ee TO |
64 | /** |
65 | * @return \Psr\Log\LoggerInterface | |
66 | */ | |
67 | public static function log() { | |
68 | return Civi\Core\Container::singleton()->get('psr_log'); | |
69 | } | |
70 | ||
e3d28c74 TO |
71 | /** |
72 | * Obtain the core file/path mapper. | |
73 | * | |
74 | * @return \Civi\Core\Paths | |
75 | */ | |
76 | public static function paths() { | |
d4330c62 | 77 | return \Civi\Core\Container::getBootService('paths'); |
e3d28c74 TO |
78 | } |
79 | ||
711aa5d7 TO |
80 | /** |
81 | * Fetch a service from the container. | |
82 | * | |
83 | * @param string $id | |
84 | * The service ID. | |
85 | * @return mixed | |
86 | */ | |
87 | public static function service($id) { | |
88 | return \Civi\Core\Container::singleton()->get($id); | |
89 | } | |
90 | ||
91 | /** | |
92 | * Reset all ephemeral system state, e.g. statics, | |
93 | * singletons, containers. | |
94 | */ | |
95 | public static function reset() { | |
711aa5d7 | 96 | self::$statics = array(); |
7f835399 | 97 | Civi\Core\Container::singleton(); |
711aa5d7 TO |
98 | } |
99 | ||
e3d28c74 TO |
100 | /** |
101 | * @return CRM_Core_Resources | |
102 | */ | |
103 | public static function resources() { | |
104 | return CRM_Core_Resources::singleton(); | |
105 | } | |
106 | ||
3a84c0ab TO |
107 | /** |
108 | * Obtain the domain settings. | |
109 | * | |
110 | * @param int|null $domainID | |
111 | * For the default domain, leave $domainID as NULL. | |
112 | * @return \Civi\Core\SettingsBag | |
113 | */ | |
114 | public static function settings($domainID = NULL) { | |
83617886 | 115 | return \Civi\Core\Container::getBootService('settings_manager')->getBagByDomain($domainID); |
3a84c0ab TO |
116 | } |
117 | ||
711aa5d7 | 118 | } |