Civi/Core/Container.php

   1 <?php
   2 namespace Civi\Core;
   3
   4 use Civi\Core\Event\SystemInstallEvent;
   5 use Civi\Core\Lock\LockManager;
   6 use Symfony\Component\Config\ConfigCache;
   7 use Symfony\Component\DependencyInjection\ContainerBuilder;
   8 use Symfony\Component\DependencyInjection\Definition;
   9 use Symfony\Component\DependencyInjection\Dumper\PhpDumper;
  10 use Symfony\Component\DependencyInjection\Reference;
  11 use Symfony\Component\EventDispatcher\DependencyInjection\RegisterListenersPass;
  12
  13 // TODO use Symfony\Component\DependencyInjection\Loader\YamlFileLoader;
  14
  15 /**
  16  * Class Container
  17  * @package Civi\Core
  18  */
  19 class Container {
  20
  21   const SELF = 'civi_container_factory';
  22
  23   /**
  24    * @param bool $reset
  25    *   Whether to forcibly rebuild the entire container.
  26    * @return \Symfony\Component\DependencyInjection\TaggedContainerInterface
  27    */
  28   public static function singleton($reset = FALSE) {
  29     if ($reset || !isset(\Civi::$statics[__CLASS__]['container'])) {
  30       self::boot(TRUE);
  31     }
  32     return \Civi::$statics[__CLASS__]['container'];
  33   }
  34
  35   /**
  36    * Find a cached container definition or construct a new one.
  37    *
  38    * There are many weird contexts in which Civi initializes (eg different
  39    * variations of multitenancy and different permutations of CMS/CRM bootstrap),
  40    * and hook_container may fire a bit differently in each context. To mitigate
  41    * risk of leaks between environments, we compute a unique envID
  42    * (md5(DB_NAME, HTTP_HOST, SCRIPT_FILENAME, etc)) and use separate caches for
  43    * each (eg "templates_c/CachedCiviContainer.$ENVID.php").
  44    *
  45    * Constants:
  46    *   - CIVICRM_CONTAINER_CACHE -- 'always' [default], 'never', 'auto'
  47    *   - CIVICRM_DSN
  48    *   - CIVICRM_DOMAIN_ID
  49    *   - CIVICRM_TEMPLATE_COMPILEDIR
  50    *
  51    * @return \Symfony\Component\DependencyInjection\ContainerInterface
  52    */
  53   public function loadContainer() {
  54     // Note: The container's raison d'etre is to manage construction of other
  55     // services. Consequently, we assume a minimal service available -- the classloader
  56     // has been setup, and civicrm.settings.php is loaded, but nothing else works.
  57
  58     $cacheMode = defined('CIVICRM_CONTAINER_CACHE') ? CIVICRM_CONTAINER_CACHE : 'auto';
  59
  60     // In pre-installation environments, don't bother with caching.
  61     if (!defined('CIVICRM_TEMPLATE_COMPILEDIR') || !defined('CIVICRM_DSN') || $cacheMode === 'never' || \CRM_Utils_System::isInUpgradeMode()) {
  62       $containerBuilder = $this->createContainer();
  63       $containerBuilder->compile();
  64       return $containerBuilder;
  65     }
  66
  67     $envId = \CRM_Core_Config_Runtime::getId();
  68     $file = CIVICRM_TEMPLATE_COMPILEDIR . "/CachedCiviContainer.{$envId}.php";
  69     $containerConfigCache = new ConfigCache($file, $cacheMode === 'auto');
  70     if (!$containerConfigCache->isFresh()) {
  71       $containerBuilder = $this->createContainer();
  72       $containerBuilder->compile();
  73       $dumper = new PhpDumper($containerBuilder);
  74       $containerConfigCache->write(
  75         $dumper->dump(['class' => 'CachedCiviContainer']),
  76         $containerBuilder->getResources()
  77       );
  78     }
  79
  80     require_once $file;
  81     $c = new \CachedCiviContainer();
  82     return $c;
  83   }
  84
  85   /**
  86    * Construct a new container.
  87    *
  88    * @var \Symfony\Component\DependencyInjection\ContainerBuilder
  89    * @return \Symfony\Component\DependencyInjection\ContainerBuilder
  90    */
  91   public function createContainer() {
  92     $civicrm_base_path = dirname(dirname(__DIR__));
  93     $container = new ContainerBuilder();
  94     $container->addCompilerPass(new RegisterListenersPass('dispatcher'));
  95     $container->addObjectResource($this);
  96     $container->setParameter('civicrm_base_path', $civicrm_base_path);
  97     //$container->set(self::SELF, $this);
  98
  99     $container->addResource(new \Symfony\Component\Config\Resource\FileResource(__FILE__));
 100
 101     $container->setDefinition(self::SELF, new Definition(
 102       'Civi\Core\Container',
 103       []
 104     ));
 105
 106     // TODO Move configuration to an external file; define caching structure
 107     //    if (empty($configDirectories)) {
 108     //      throw new \Exception(__CLASS__ . ': Missing required properties (civicrmRoot, configDirectories)');
 109     //    }
 110     //    $locator = new FileLocator($configDirectories);
 111     //    $loaderResolver = new LoaderResolver(array(
 112     //      new YamlFileLoader($container, $locator)
 113     //    ));
 114     //    $delegatingLoader = new DelegatingLoader($loaderResolver);
 115     //    foreach (array('services.yml') as $file) {
 116     //      $yamlUserFiles = $locator->locate($file, NULL, FALSE);
 117     //      foreach ($yamlUserFiles as $file) {
 118     //        $delegatingLoader->load($file);
 119     //      }
 120     //    }
 121
 122     $container->setDefinition('angular', new Definition(
 123       'Civi\Angular\Manager',
 124       []
 125     ))
 126       ->setFactory([new Reference(self::SELF), 'createAngularManager']);
 127
 128     $container->setDefinition('dispatcher', new Definition(
 129       'Civi\Core\CiviEventDispatcher',
 130       [new Reference('service_container')]
 131     ))
 132       ->setFactory([new Reference(self::SELF), 'createEventDispatcher']);
 133
 134     $container->setDefinition('magic_function_provider', new Definition(
 135       'Civi\API\Provider\MagicFunctionProvider',
 136       []
 137     ));
 138
 139     $container->setDefinition('civi_api_kernel', new Definition(
 140       'Civi\API\Kernel',
 141       [new Reference('dispatcher'), new Reference('magic_function_provider')]
 142     ))
 143       ->setFactory([new Reference(self::SELF), 'createApiKernel']);
 144
 145     $container->setDefinition('cxn_reg_client', new Definition(
 146       'Civi\Cxn\Rpc\RegistrationClient',
 147       []
 148     ))
 149       ->setFactory('CRM_Cxn_BAO_Cxn::createRegistrationClient');
 150
 151     $container->setDefinition('psr_log', new Definition('CRM_Core_Error_Log', []));
 152
 153     $basicCaches = [
 154       'js_strings' => 'js_strings',
 155       'community_messages' => 'community_messages',
 156       'checks' => 'checks',
 157       'session' => 'CiviCRM Session',
 158       'long' => 'long',
 159       'groups' => 'contact groups',
 160     ];
 161     foreach ($basicCaches as $cacheSvc => $cacheGrp) {
 162       $definitionParams = [
 163         'name' => $cacheGrp,
 164         'type' => ['*memory*', 'SqlGroup', 'ArrayCache'],
 165       ];
 166       // For Caches that we don't really care about the ttl for and/or maybe accessed
 167       // fairly often we use the fastArrayDecorator which improves reads and writes, these
 168       // caches should also not have concurrency risk.
 169       $fastArrayCaches = ['groups'];
 170       if (in_array($cacheSvc, $fastArrayCaches)) {
 171         $definitionParams['withArray'] = 'fast';
 172       }
 173       $container->setDefinition("cache.{$cacheSvc}", new Definition(
 174         'CRM_Utils_Cache_Interface',
 175         [$definitionParams]
 176       ))->setFactory('CRM_Utils_Cache::create');
 177     }
 178
 179     // PrevNextCache cannot use memory or array cache at the moment because the
 180     // Code in CRM_Core_BAO_PrevNextCache assumes that this cache is sql backed.
 181     $container->setDefinition("cache.prevNextCache", new Definition(
 182       'CRM_Utils_Cache_Interface',
 183       [
 184         [
 185           'name' => 'CiviCRM Search PrevNextCache',
 186           'type' => ['SqlGroup'],
 187         ],
 188       ]
 189     ))->setFactory('CRM_Utils_Cache::create');
 190
 191     $container->setDefinition('sql_triggers', new Definition(
 192       'Civi\Core\SqlTriggers',
 193       []
 194     ));
 195
 196     $container->setDefinition('asset_builder', new Definition(
 197       'Civi\Core\AssetBuilder',
 198       []
 199     ));
 200
 201     $container->setDefinition('themes', new Definition(
 202       'Civi\Core\Themes',
 203       []
 204     ));
 205
 206     $container->setDefinition('pear_mail', new Definition('Mail'))
 207       ->setFactory('CRM_Utils_Mail::createMailer');
 208
 209     if (empty(\Civi::$statics[__CLASS__]['boot'])) {
 210       throw new \RuntimeException("Cannot initialize container. Boot services are undefined.");
 211     }
 212     foreach (\Civi::$statics[__CLASS__]['boot'] as $bootService => $def) {
 213       $container->setDefinition($bootService, new Definition())->setSynthetic(TRUE);
 214     }
 215
 216     // Expose legacy singletons as services in the container.
 217     $singletons = [
 218       'httpClient' => 'CRM_Utils_HttpClient',
 219       'cache.default' => 'CRM_Utils_Cache',
 220       'i18n' => 'CRM_Core_I18n',
 221       // Maybe? 'config' => 'CRM_Core_Config',
 222       // Maybe? 'smarty' => 'CRM_Core_Smarty',
 223     ];
 224     foreach ($singletons as $name => $class) {
 225       $container->setDefinition($name, new Definition(
 226         $class
 227       ))
 228         ->setFactory([$class, 'singleton']);
 229     }
 230     $container->setAlias('cache.short', 'cache.default');
 231
 232     $container->setDefinition('resources', new Definition(
 233       'CRM_Core_Resources',
 234       [new Reference('service_container')]
 235     ))->setFactory([new Reference(self::SELF), 'createResources']);
 236
 237     $container->setDefinition('prevnext', new Definition(
 238       'CRM_Core_PrevNextCache_Interface',
 239       [new Reference('service_container')]
 240     ))->setFactory([new Reference(self::SELF), 'createPrevNextCache']);
 241
 242     $container->setDefinition('prevnext.driver.sql', new Definition(
 243       'CRM_Core_PrevNextCache_Sql',
 244       []
 245     ));
 246
 247     $container->setDefinition('prevnext.driver.redis', new Definition(
 248       'CRM_Core_PrevNextCache_Redis',
 249       [new Reference('cache_config')]
 250     ));
 251
 252     $container->setDefinition('cache_config', new Definition('ArrayObject'))
 253       ->setFactory([new Reference(self::SELF), 'createCacheConfig']);
 254
 255     $container->setDefinition('civi.mailing.triggers', new Definition(
 256       'Civi\Core\SqlTrigger\TimestampTriggers',
 257       ['civicrm_mailing', 'Mailing']
 258     ))->addTag('kernel.event_listener', ['event' => 'hook_civicrm_triggerInfo', 'method' => 'onTriggerInfo']);
 259
 260     $container->setDefinition('civi.activity.triggers', new Definition(
 261       'Civi\Core\SqlTrigger\TimestampTriggers',
 262       ['civicrm_activity', 'Activity']
 263     ))->addTag('kernel.event_listener', ['event' => 'hook_civicrm_triggerInfo', 'method' => 'onTriggerInfo']);
 264
 265     $container->setDefinition('civi.case.triggers', new Definition(
 266       'Civi\Core\SqlTrigger\TimestampTriggers',
 267       ['civicrm_case', 'Case']
 268     ))->addTag('kernel.event_listener', ['event' => 'hook_civicrm_triggerInfo', 'method' => 'onTriggerInfo']);
 269
 270     $container->setDefinition('civi.case.staticTriggers', new Definition(
 271       'Civi\Core\SqlTrigger\StaticTriggers',
 272       [
 273         [
 274           [
 275             'upgrade_check' => ['table' => 'civicrm_case', 'column' => 'modified_date'],
 276             'table' => 'civicrm_case_activity',
 277             'when' => 'AFTER',
 278             'event' => ['INSERT'],
 279             'sql' => "\nUPDATE civicrm_case SET modified_date = CURRENT_TIMESTAMP WHERE id = NEW.case_id;\n",
 280           ],
 281           [
 282             'upgrade_check' => ['table' => 'civicrm_case', 'column' => 'modified_date'],
 283             'table' => 'civicrm_activity',
 284             'when' => 'BEFORE',
 285             'event' => ['UPDATE', 'DELETE'],
 286             'sql' => "\nUPDATE civicrm_case SET modified_date = CURRENT_TIMESTAMP WHERE id IN (SELECT ca.case_id FROM civicrm_case_activity ca WHERE ca.activity_id = OLD.id);\n",
 287           ],
 288         ],
 289       ]
 290     ))
 291       ->addTag('kernel.event_listener', ['event' => 'hook_civicrm_triggerInfo', 'method' => 'onTriggerInfo']);
 292
 293     $container->setDefinition('civi_token_compat', new Definition(
 294       'Civi\Token\TokenCompatSubscriber',
 295       []
 296     ))->addTag('kernel.event_subscriber');
 297     $container->setDefinition("crm_mailing_action_tokens", new Definition(
 298       "CRM_Mailing_ActionTokens",
 299       []
 300     ))->addTag('kernel.event_subscriber');
 301
 302     foreach (['Activity', 'Contribute', 'Event', 'Mailing', 'Member'] as $comp) {
 303       $container->setDefinition("crm_" . strtolower($comp) . "_tokens", new Definition(
 304         "CRM_{$comp}_Tokens",
 305         []
 306       ))->addTag('kernel.event_subscriber');
 307     }
 308
 309     if (\CRM_Utils_Constant::value('CIVICRM_FLEXMAILER_HACK_SERVICES')) {
 310       \Civi\Core\Resolver::singleton()->call(CIVICRM_FLEXMAILER_HACK_SERVICES, [$container]);
 311     }
 312
 313     \CRM_Utils_Hook::container($container);
 314
 315     return $container;
 316   }
 317
 318   /**
 319    * @return \Civi\Angular\Manager
 320    */
 321   public function createAngularManager() {
 322     return new \Civi\Angular\Manager(\CRM_Core_Resources::singleton());
 323   }
 324
 325   /**
 326    * @param \Symfony\Component\DependencyInjection\ContainerInterface $container
 327    * @return \Symfony\Component\EventDispatcher\ContainerAwareEventDispatcher
 328    */
 329   public function createEventDispatcher($container) {
 330     $dispatcher = new CiviEventDispatcher($container);
 331     $dispatcher->addListener(SystemInstallEvent::EVENT_NAME, ['\Civi\Core\InstallationCanary', 'check']);
 332     $dispatcher->addListener(SystemInstallEvent::EVENT_NAME, ['\Civi\Core\DatabaseInitializer', 'initialize']);
 333     $dispatcher->addListener(SystemInstallEvent::EVENT_NAME, ['\Civi\Core\LocalizationInitializer', 'initialize']);
 334     $dispatcher->addListener('hook_civicrm_pre', ['\Civi\Core\Event\PreEvent', 'dispatchSubevent'], 100);
 335     $dispatcher->addListener('hook_civicrm_post', ['\Civi\Core\Event\PostEvent', 'dispatchSubevent'], 100);
 336     $dispatcher->addListener('hook_civicrm_post::Activity', ['\Civi\CCase\Events', 'fireCaseChange']);
 337     $dispatcher->addListener('hook_civicrm_post::Case', ['\Civi\CCase\Events', 'fireCaseChange']);
 338     $dispatcher->addListener('hook_civicrm_caseChange', ['\Civi\CCase\Events', 'delegateToXmlListeners']);
 339     $dispatcher->addListener('hook_civicrm_caseChange', ['\Civi\CCase\SequenceListener', 'onCaseChange_static']);
 340     $dispatcher->addListener('hook_civicrm_eventDefs', ['\Civi\Core\CiviEventInspector', 'findBuiltInEvents']);
 341     // TODO We need a better code-convention for metadata about non-hook events.
 342     $dispatcher->addListener('hook_civicrm_eventDefs', ['\Civi\API\Events', 'hookEventDefs']);
 343     $dispatcher->addListener('hook_civicrm_eventDefs', ['\Civi\Core\Event\SystemInstallEvent', 'hookEventDefs']);
 344     $dispatcher->addListener('hook_civicrm_buildAsset', ['\Civi\Angular\Page\Modules', 'buildAngularModules']);
 345     $dispatcher->addListener('hook_civicrm_buildAsset', ['\CRM_Utils_VisualBundle', 'buildAssetJs']);
 346     $dispatcher->addListener('hook_civicrm_buildAsset', ['\CRM_Utils_VisualBundle', 'buildAssetCss']);
 347     $dispatcher->addListener('hook_civicrm_buildAsset', ['\CRM_Core_Resources', 'renderMenubarStylesheet']);
 348     $dispatcher->addListener('hook_civicrm_coreResourceList', ['\CRM_Utils_System', 'appendCoreResources']);
 349     $dispatcher->addListener('hook_civicrm_getAssetUrl', ['\CRM_Utils_System', 'alterAssetUrl']);
 350     $dispatcher->addListener('civi.dao.postInsert', ['\CRM_Core_BAO_RecurringEntity', 'triggerInsert']);
 351     $dispatcher->addListener('civi.dao.postUpdate', ['\CRM_Core_BAO_RecurringEntity', 'triggerUpdate']);
 352     $dispatcher->addListener('civi.dao.postDelete', ['\CRM_Core_BAO_RecurringEntity', 'triggerDelete']);
 353     $dispatcher->addListener('hook_civicrm_unhandled_exception', [
 354       'CRM_Core_LegacyErrorHandler',
 355       'handleException',
 356     ], -200);
 357     $dispatcher->addListener(\Civi\ActionSchedule\Events::MAPPINGS, ['CRM_Activity_ActionMapping', 'onRegisterActionMappings']);
 358     $dispatcher->addListener(\Civi\ActionSchedule\Events::MAPPINGS, ['CRM_Contact_ActionMapping', 'onRegisterActionMappings']);
 359     $dispatcher->addListener(\Civi\ActionSchedule\Events::MAPPINGS, ['CRM_Contribute_ActionMapping_ByPage', 'onRegisterActionMappings']);
 360     $dispatcher->addListener(\Civi\ActionSchedule\Events::MAPPINGS, ['CRM_Contribute_ActionMapping_ByType', 'onRegisterActionMappings']);
 361     $dispatcher->addListener(\Civi\ActionSchedule\Events::MAPPINGS, ['CRM_Event_ActionMapping', 'onRegisterActionMappings']);
 362     $dispatcher->addListener(\Civi\ActionSchedule\Events::MAPPINGS, ['CRM_Member_ActionMapping', 'onRegisterActionMappings']);
 363
 364     if (\CRM_Utils_Constant::value('CIVICRM_FLEXMAILER_HACK_LISTENERS')) {
 365       \Civi\Core\Resolver::singleton()->call(CIVICRM_FLEXMAILER_HACK_LISTENERS, [$dispatcher]);
 366     }
 367
 368     return $dispatcher;
 369   }
 370
 371   /**
 372    * @return \Civi\Core\Lock\LockManager
 373    */
 374   public static function createLockManager() {
 375     // Ideally, downstream implementers could override any definitions in
 376     // the container. For now, we'll make-do with some define()s.
 377     $lm = new LockManager();
 378     $lm
 379       ->register('/^cache\./', defined('CIVICRM_CACHE_LOCK') ? CIVICRM_CACHE_LOCK : ['CRM_Core_Lock', 'createScopedLock'])
 380       ->register('/^data\./', defined('CIVICRM_DATA_LOCK') ? CIVICRM_DATA_LOCK : ['CRM_Core_Lock', 'createScopedLock'])
 381       ->register('/^worker\.mailing\.send\./', defined('CIVICRM_WORK_LOCK') ? CIVICRM_WORK_LOCK : ['CRM_Core_Lock', 'createCivimailLock'])
 382       ->register('/^worker\./', defined('CIVICRM_WORK_LOCK') ? CIVICRM_WORK_LOCK : ['CRM_Core_Lock', 'createScopedLock']);
 383
 384     // Registrations may use complex resolver expressions, but (as a micro-optimization)
 385     // the default factory is specified as an array.
 386
 387     return $lm;
 388   }
 389
 390   /**
 391    * @param \Symfony\Component\EventDispatcher\EventDispatcher $dispatcher
 392    * @param $magicFunctionProvider
 393    *
 394    * @return \Civi\API\Kernel
 395    */
 396   public function createApiKernel($dispatcher, $magicFunctionProvider) {
 397     $dispatcher->addSubscriber(new \Civi\API\Subscriber\ChainSubscriber());
 398     $dispatcher->addSubscriber(new \Civi\API\Subscriber\TransactionSubscriber());
 399     $dispatcher->addSubscriber(new \Civi\API\Subscriber\I18nSubscriber());
 400     $dispatcher->addSubscriber($magicFunctionProvider);
 401     $dispatcher->addSubscriber(new \Civi\API\Subscriber\PermissionCheck());
 402     $dispatcher->addSubscriber(new \Civi\API\Subscriber\APIv3SchemaAdapter());
 403     $dispatcher->addSubscriber(new \Civi\API\Subscriber\WrapperAdapter([
 404       \CRM_Utils_API_HTMLInputCoder::singleton(),
 405       \CRM_Utils_API_NullOutputCoder::singleton(),
 406       \CRM_Utils_API_ReloadOption::singleton(),
 407       \CRM_Utils_API_MatchOption::singleton(),
 408     ]));
 409     $dispatcher->addSubscriber(new \Civi\API\Subscriber\XDebugSubscriber());
 410     $kernel = new \Civi\API\Kernel($dispatcher);
 411
 412     $reflectionProvider = new \Civi\API\Provider\ReflectionProvider($kernel);
 413     $dispatcher->addSubscriber($reflectionProvider);
 414
 415     $dispatcher->addSubscriber(new \Civi\API\Subscriber\DynamicFKAuthorization(
 416       $kernel,
 417       'Attachment',
 418       ['create', 'get', 'delete'],
 419       // Given a file ID, determine the entity+table it's attached to.
 420       'SELECT if(cf.id,1,0) as is_valid, cef.entity_table, cef.entity_id
 421          FROM civicrm_file cf
 422          LEFT JOIN civicrm_entity_file cef ON cf.id = cef.file_id
 423          WHERE cf.id = %1',
 424       // Get a list of custom fields (field_name,table_name,extends)
 425       'SELECT concat("custom_",fld.id) as field_name,
 426         grp.table_name as table_name,
 427         grp.extends as extends
 428        FROM civicrm_custom_field fld
 429        INNER JOIN civicrm_custom_group grp ON fld.custom_group_id = grp.id
 430        WHERE fld.data_type = "File"
 431       ',
 432       ['civicrm_activity', 'civicrm_mailing', 'civicrm_contact', 'civicrm_grant']
 433     ));
 434
 435     $kernel->setApiProviders([
 436       $reflectionProvider,
 437       $magicFunctionProvider,
 438     ]);
 439
 440     return $kernel;
 441   }
 442
 443   /**
 444    * @param \Symfony\Component\DependencyInjection\ContainerInterface $container
 445    * @return \CRM_Core_Resources
 446    */
 447   public static function createResources($container) {
 448     $sys = \CRM_Extension_System::singleton();
 449     return new \CRM_Core_Resources(
 450       $sys->getMapper(),
 451       $container->get('cache.js_strings'),
 452       \CRM_Core_Config::isUpgradeMode() ? NULL : 'resCacheCode'
 453     );
 454   }
 455
 456   /**
 457    * @param \Symfony\Component\DependencyInjection\ContainerInterface $container
 458    * @return \CRM_Core_PrevNextCache_Interface
 459    */
 460   public static function createPrevNextCache($container) {
 461     $setting = \Civi::settings()->get('prevNextBackend');
 462     if ($setting === 'default') {
 463       // For initial release (5.8.x), continue defaulting to SQL.
 464       $isTransitional = version_compare(\CRM_Utils_System::version(), '5.9.alpha1', '<');
 465       $cacheDriver = \CRM_Utils_Cache::getCacheDriver();
 466       $service = 'prevnext.driver.' . strtolower($cacheDriver);
 467       return $container->has($service) && !$isTransitional
 468         ? $container->get($service)
 469         : $container->get('prevnext.driver.sql');
 470     }
 471     else {
 472       return $container->get('prevnext.driver.' . $setting);
 473     }
 474   }
 475
 476   public static function createCacheConfig() {
 477     $driver = \CRM_Utils_Cache::getCacheDriver();
 478     $settings = \CRM_Utils_Cache::getCacheSettings($driver);
 479     $settings['driver'] = $driver;
 480     return new \ArrayObject($settings);
 481   }
 482
 483   /**
 484    * Get a list of boot services.
 485    *
 486    * These are services which must be setup *before* the container can operate.
 487    *
 488    * @param bool $loadFromDB
 489    * @throws \CRM_Core_Exception
 490    */
 491   public static function boot($loadFromDB) {
 492     // Array(string $serviceId => object $serviceInstance).
 493     $bootServices = [];
 494     \Civi::$statics[__CLASS__]['boot'] = &$bootServices;
 495
 496     $bootServices['runtime'] = $runtime = new \CRM_Core_Config_Runtime();
 497     $runtime->initialize($loadFromDB);
 498
 499     $bootServices['paths'] = new \Civi\Core\Paths();
 500
 501     $class = $runtime->userFrameworkClass;
 502     $bootServices['userSystem'] = $userSystem = new $class();
 503     $userSystem->initialize();
 504
 505     $userPermissionClass = 'CRM_Core_Permission_' . $runtime->userFramework;
 506     $bootServices['userPermissionClass'] = new $userPermissionClass();
 507
 508     $bootServices['cache.settings'] = \CRM_Utils_Cache::create([
 509       'name' => 'settings',
 510       'type' => ['*memory*', 'SqlGroup', 'ArrayCache'],
 511     ]);
 512
 513     $bootServices['settings_manager'] = new \Civi\Core\SettingsManager($bootServices['cache.settings']);
 514
 515     $bootServices['lockManager'] = self::createLockManager();
 516
 517     if ($loadFromDB && $runtime->dsn) {
 518       \CRM_Core_DAO::init($runtime->dsn);
 519       \CRM_Utils_Hook::singleton(TRUE);
 520       \CRM_Extension_System::singleton(TRUE);
 521       \CRM_Extension_System::singleton(TRUE)->getClassLoader()->register();
 522
 523       $runtime->includeCustomPath();
 524
 525       $c = new self();
 526       $container = $c->loadContainer();
 527       foreach ($bootServices as $name => $obj) {
 528         $container->set($name, $obj);
 529       }
 530       \Civi::$statics[__CLASS__]['container'] = $container;
 531     }
 532   }
 533
 534   public static function getBootService($name) {
 535     return \Civi::$statics[__CLASS__]['boot'][$name];
 536   }
 537
 538   /**
 539    * Determine whether the container services are available.
 540    *
 541    * @return bool
 542    */
 543   public static function isContainerBooted() {
 544     return isset(\Civi::$statics[__CLASS__]['container']);
 545   }
 546
 547 }