Civi/Core/Container.php

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