Civi.php

   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    * @var array
  22    * ```
  23    * `Civi::$statics[__CLASS__]['foo'] = 'bar';
  24    * ```
  25    */
  26   public static $statics = array();
  27
  28   /**
  29    * Retrieve a named cache instance.
  30    *
  31    * @param string $name
  32    *   The name of the cache. The 'default' cache is biased toward
  33    *   high-performance caches (eg memcache/redis/apc) when
  34    *   available and falls back to single-request (static) caching.
  35    *   Ex: 'short' or 'default' is useful for high-speed, short-lived cache data.
  36    *       This is appropriate if you believe that latency (millisecond-level
  37    *       read time) is the main factor. For example: caching data from
  38    *       a couple SQL queries.
  39    *   Ex: 'long' can be useful for longer-lived cache data. It's appropriate if
  40    *       you believe that longevity (e.g. surviving for several hours or a day)
  41    *       is more important than  millisecond-level access time. For example:
  42    *       caching the result of a simple metadata-query.
  43    *
  44    * @return CRM_Utils_Cache_Interface
  45    *   NOTE: Beginning in CiviCRM v5.4, the cache instance complies with
  46    *   PSR-16 (\Psr\SimpleCache\CacheInterface).
  47    */
  48   public static function cache($name = 'default') {
  49     return \Civi\Core\Container::singleton()->get('cache.' . $name);
  50   }
  51
  52   /**
  53    * Get the service container.
  54    *
  55    * @return \Symfony\Component\DependencyInjection\ContainerInterface
  56    */
  57   public static function container() {
  58     return Civi\Core\Container::singleton();
  59   }
  60
  61   /**
  62    * Get the event dispatcher.
  63    *
  64    * @return \Symfony\Component\EventDispatcher\EventDispatcherInterface
  65    */
  66   public static function dispatcher() {
  67     return Civi\Core\Container::singleton()->get('dispatcher');
  68   }
  69
  70   /**
  71    * @return \Civi\Core\Lock\LockManager
  72    */
  73   public static function lockManager() {
  74     return \Civi\Core\Container::getBootService('lockManager');
  75   }
  76
  77   /**
  78    * @return \CRM_Core_Error_Log
  79    */
  80   public static function log() {
  81     return Civi\Core\Container::singleton()->get('psr_log');
  82   }
  83
  84   /**
  85    * Obtain the core file/path mapper.
  86    *
  87    * @return \Civi\Core\Paths
  88    */
  89   public static function paths() {
  90     return \Civi\Core\Container::getBootService('paths');
  91   }
  92
  93   /**
  94    * Fetch a service from the container.
  95    *
  96    * @param string $id
  97    *   The service ID.
  98    * @return mixed
  99    */
 100   public static function service($id) {
 101     return \Civi\Core\Container::singleton()->get($id);
 102   }
 103
 104   /**
 105    * Reset all ephemeral system state, e.g. statics,
 106    * singletons, containers.
 107    */
 108   public static function reset() {
 109     self::$statics = array();
 110     Civi\Core\Container::singleton();
 111   }
 112
 113   /**
 114    * @return CRM_Core_Resources
 115    */
 116   public static function resources() {
 117     return CRM_Core_Resources::singleton();
 118   }
 119
 120   /**
 121    * Obtain the contact's personal settings.
 122    *
 123    * @param NULL|int $contactID
 124    *   For the default/active user's contact, leave $domainID as NULL.
 125    * @param NULL|int $domainID
 126    *   For the default domain, leave $domainID as NULL.
 127    * @return \Civi\Core\SettingsBag
 128    * @throws CRM_Core_Exception
 129    *   If there is no contact, then there's no SettingsBag, and we'll throw
 130    *   an exception.
 131    */
 132   public static function contactSettings($contactID = NULL, $domainID = NULL) {
 133     return \Civi\Core\Container::getBootService('settings_manager')->getBagByContact($domainID, $contactID);
 134   }
 135
 136   /**
 137    * Obtain the domain settings.
 138    *
 139    * @param int|null $domainID
 140    *   For the default domain, leave $domainID as NULL.
 141    * @return \Civi\Core\SettingsBag
 142    */
 143   public static function settings($domainID = NULL) {
 144     return \Civi\Core\Container::getBootService('settings_manager')->getBagByDomain($domainID);
 145   }
 146
 147 }