4 use Civi\API\Provider\ActionObjectProvider
;
5 use Civi\Core\Event\SystemInstallEvent
;
6 use Civi\Core\Lock\LockManager
;
7 use Doctrine\Common\Annotations\AnnotationReader
;
8 use Doctrine\Common\Annotations\AnnotationRegistry
;
9 use Doctrine\Common\Annotations\FileCacheReader
;
10 use Doctrine\Common\Cache\FilesystemCache
;
11 use Doctrine\ORM\EntityManager
;
12 use Doctrine\ORM\Mapping\Driver\AnnotationDriver
;
13 use Doctrine\ORM\Tools\Setup
;
14 use Symfony\Component\Config\ConfigCache
;
15 use Symfony\Component\DependencyInjection\ContainerBuilder
;
16 use Symfony\Component\DependencyInjection\ContainerInterface
;
17 use Symfony\Component\DependencyInjection\Definition
;
18 use Symfony\Component\DependencyInjection\Dumper\PhpDumper
;
19 use Symfony\Component\DependencyInjection\Reference
;
20 use Symfony\Component\EventDispatcher\ContainerAwareEventDispatcher
;
21 use Symfony\Component\EventDispatcher\DependencyInjection\RegisterListenersPass
;
23 // TODO use Symfony\Component\DependencyInjection\Loader\YamlFileLoader;
31 const SELF
= 'civi_container_factory';
35 * Whether to forcibly rebuild the entire container.
36 * @return \Symfony\Component\DependencyInjection\TaggedContainerInterface
38 public static function singleton($reset = FALSE) {
39 if ($reset ||
!isset(\Civi
::$statics[__CLASS__
]['container'])) {
42 return \Civi
::$statics[__CLASS__
]['container'];
46 * Find a cached container definition or construct a new one.
48 * There are many weird contexts in which Civi initializes (eg different
49 * variations of multitenancy and different permutations of CMS/CRM bootstrap),
50 * and hook_container may fire a bit differently in each context. To mitigate
51 * risk of leaks between environments, we compute a unique envID
52 * (md5(DB_NAME, HTTP_HOST, SCRIPT_FILENAME, etc)) and use separate caches for
53 * each (eg "templates_c/CachedCiviContainer.$ENVID.php").
56 * - CIVICRM_CONTAINER_CACHE -- 'always' [default], 'never', 'auto'
59 * - CIVICRM_TEMPLATE_COMPILEDIR
61 * @return ContainerInterface
63 public function loadContainer() {
64 // Note: The container's raison d'etre is to manage construction of other
65 // services. Consequently, we assume a minimal service available -- the classloader
66 // has been setup, and civicrm.settings.php is loaded, but nothing else works.
68 $cacheMode = defined('CIVICRM_CONTAINER_CACHE') ? CIVICRM_CONTAINER_CACHE
: 'auto';
70 // In pre-installation environments, don't bother with caching.
71 if (!defined('CIVICRM_TEMPLATE_COMPILEDIR') ||
!defined('CIVICRM_DSN') ||
$cacheMode === 'never' || \CRM_Utils_System
::isInUpgradeMode()) {
72 $containerBuilder = $this->createContainer();
73 $containerBuilder->compile();
74 return $containerBuilder;
77 $envId = \CRM_Core_Config_Runtime
::getId();
78 $file = CIVICRM_TEMPLATE_COMPILEDIR
. "/CachedCiviContainer.{$envId}.php";
79 $containerConfigCache = new ConfigCache($file, $cacheMode === 'auto');
80 if (!$containerConfigCache->isFresh()) {
81 $containerBuilder = $this->createContainer();
82 $containerBuilder->compile();
83 $dumper = new PhpDumper($containerBuilder);
84 $containerConfigCache->write(
85 $dumper->dump(array('class' => 'CachedCiviContainer')),
86 $containerBuilder->getResources()
91 $c = new \
CachedCiviContainer();
96 * Construct a new container.
98 * @var ContainerBuilder
99 * @return \Symfony\Component\DependencyInjection\ContainerBuilder
101 public function createContainer() {
102 $civicrm_base_path = dirname(dirname(__DIR__
));
103 $container = new ContainerBuilder();
104 $container->addCompilerPass(new RegisterListenersPass('dispatcher'));
105 $container->addObjectResource($this);
106 $container->setParameter('civicrm_base_path', $civicrm_base_path);
107 //$container->set(self::SELF, $this);
109 $container->addResource(new \Symfony\Component\Config\
Resource\
FileResource(__FILE__
));
111 $container->setDefinition(self
::SELF
, new Definition(
112 'Civi\Core\Container',
116 // TODO Move configuration to an external file; define caching structure
117 // if (empty($configDirectories)) {
118 // throw new \Exception(__CLASS__ . ': Missing required properties (civicrmRoot, configDirectories)');
120 // $locator = new FileLocator($configDirectories);
121 // $loaderResolver = new LoaderResolver(array(
122 // new YamlFileLoader($container, $locator)
124 // $delegatingLoader = new DelegatingLoader($loaderResolver);
125 // foreach (array('services.yml') as $file) {
126 // $yamlUserFiles = $locator->locate($file, NULL, FALSE);
127 // foreach ($yamlUserFiles as $file) {
128 // $delegatingLoader->load($file);
132 $container->setDefinition('angular', new Definition(
133 'Civi\Angular\Manager',
136 ->setFactory(array(new Reference(self
::SELF
), 'createAngularManager'));
138 $container->setDefinition('dispatcher', new Definition(
139 'Civi\Core\CiviEventDispatcher',
140 array(new Reference('service_container'))
142 ->setFactory(array(new Reference(self
::SELF
), 'createEventDispatcher'));
144 $container->setDefinition('magic_function_provider', new Definition(
145 'Civi\API\Provider\MagicFunctionProvider',
149 $container->setDefinition('civi_api_kernel', new Definition(
151 array(new Reference('dispatcher'), new Reference('magic_function_provider'))
153 ->setFactory(array(new Reference(self
::SELF
), 'createApiKernel'));
155 $container->setDefinition('cxn_reg_client', new Definition(
156 'Civi\Cxn\Rpc\RegistrationClient',
159 ->setFactory('CRM_Cxn_BAO_Cxn::createRegistrationClient');
161 $container->setDefinition('psr_log', new Definition('CRM_Core_Error_Log', array()));
163 $basicCaches = array(
164 'js_strings' => 'js_strings',
165 'community_messages' => 'community_messages',
166 'checks' => 'checks',
167 'session' => 'CiviCRM Session',
170 foreach ($basicCaches as $cacheSvc => $cacheGrp) {
171 $container->setDefinition("cache.{$cacheSvc}", new Definition(
172 'CRM_Utils_Cache_Interface',
176 'type' => array('*memory*', 'SqlGroup', 'ArrayCache'),
179 ))->setFactory('CRM_Utils_Cache::create');
182 $container->setDefinition('sql_triggers', new Definition(
183 'Civi\Core\SqlTriggers',
187 $container->setDefinition('asset_builder', new Definition(
188 'Civi\Core\AssetBuilder',
192 $container->setDefinition('pear_mail', new Definition('Mail'))
193 ->setFactory('CRM_Utils_Mail::createMailer');
195 if (empty(\Civi
::$statics[__CLASS__
]['boot'])) {
196 throw new \
RuntimeException("Cannot initialize container. Boot services are undefined.");
198 foreach (\Civi
::$statics[__CLASS__
]['boot'] as $bootService => $def) {
199 $container->setDefinition($bootService, new Definition())->setSynthetic(TRUE);
202 // Expose legacy singletons as services in the container.
204 'httpClient' => 'CRM_Utils_HttpClient',
205 'cache.default' => 'CRM_Utils_Cache',
206 'i18n' => 'CRM_Core_I18n',
207 // Maybe? 'config' => 'CRM_Core_Config',
208 // Maybe? 'smarty' => 'CRM_Core_Smarty',
210 foreach ($singletons as $name => $class) {
211 $container->setDefinition($name, new Definition(
214 ->setFactory(array($class, 'singleton'));
216 $container->setAlias('cache.short', 'cache.default');
218 $container->setDefinition('resources', new Definition(
219 'CRM_Core_Resources',
220 [new Reference('service_container')]
221 ))->setFactory(array(new Reference(self
::SELF
), 'createResources'));
223 $container->setDefinition('prevnext', new Definition(
224 'CRM_Core_PrevNextCache_Interface',
225 [new Reference('service_container')]
226 ))->setFactory(array(new Reference(self
::SELF
), 'createPrevNextCache'));
228 $container->setDefinition('prevnext.driver.sql', new Definition(
229 'CRM_Core_PrevNextCache_Sql',
233 $container->setDefinition('civi.mailing.triggers', new Definition(
234 'Civi\Core\SqlTrigger\TimestampTriggers',
235 array('civicrm_mailing', 'Mailing')
236 ))->addTag('kernel.event_listener', array('event' => 'hook_civicrm_triggerInfo', 'method' => 'onTriggerInfo'));
238 $container->setDefinition('civi.activity.triggers', new Definition(
239 'Civi\Core\SqlTrigger\TimestampTriggers',
240 array('civicrm_activity', 'Activity')
241 ))->addTag('kernel.event_listener', array('event' => 'hook_civicrm_triggerInfo', 'method' => 'onTriggerInfo'));
243 $container->setDefinition('civi.case.triggers', new Definition(
244 'Civi\Core\SqlTrigger\TimestampTriggers',
245 array('civicrm_case', 'Case')
246 ))->addTag('kernel.event_listener', array('event' => 'hook_civicrm_triggerInfo', 'method' => 'onTriggerInfo'));
248 $container->setDefinition('civi.case.staticTriggers', new Definition(
249 'Civi\Core\SqlTrigger\StaticTriggers',
253 'upgrade_check' => array('table' => 'civicrm_case', 'column' => 'modified_date'),
254 'table' => 'civicrm_case_activity',
256 'event' => array('INSERT'),
257 'sql' => "\nUPDATE civicrm_case SET modified_date = CURRENT_TIMESTAMP WHERE id = NEW.case_id;\n",
260 'upgrade_check' => array('table' => 'civicrm_case', 'column' => 'modified_date'),
261 'table' => 'civicrm_activity',
263 'event' => array('UPDATE', 'DELETE'),
264 '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",
269 ->addTag('kernel.event_listener', array('event' => 'hook_civicrm_triggerInfo', 'method' => 'onTriggerInfo'));
271 $container->setDefinition('civi_token_compat', new Definition(
272 'Civi\Token\TokenCompatSubscriber',
274 ))->addTag('kernel.event_subscriber');
275 $container->setDefinition("crm_mailing_action_tokens", new Definition(
276 "CRM_Mailing_ActionTokens",
278 ))->addTag('kernel.event_subscriber');
280 foreach (array('Activity', 'Contribute', 'Event', 'Mailing', 'Member') as $comp) {
281 $container->setDefinition("crm_" . strtolower($comp) . "_tokens", new Definition(
282 "CRM_{$comp}_Tokens",
284 ))->addTag('kernel.event_subscriber');
287 if (\CRM_Utils_Constant
::value('CIVICRM_FLEXMAILER_HACK_SERVICES')) {
288 \Civi\Core\Resolver
::singleton()->call(CIVICRM_FLEXMAILER_HACK_SERVICES
, array($container));
291 \CRM_Utils_Hook
::container($container);
297 * @return \Civi\Angular\Manager
299 public function createAngularManager() {
300 return new \Civi\Angular\
Manager(\CRM_Core_Resources
::singleton());
304 * @param ContainerInterface $container
305 * @return \Symfony\Component\EventDispatcher\ContainerAwareEventDispatcher
307 public function createEventDispatcher($container) {
308 $dispatcher = new CiviEventDispatcher($container);
309 $dispatcher->addListener(SystemInstallEvent
::EVENT_NAME
, array('\Civi\Core\InstallationCanary', 'check'));
310 $dispatcher->addListener(SystemInstallEvent
::EVENT_NAME
, array('\Civi\Core\DatabaseInitializer', 'initialize'));
311 $dispatcher->addListener(SystemInstallEvent
::EVENT_NAME
, array('\Civi\Core\LocalizationInitializer', 'initialize'));
312 $dispatcher->addListener('hook_civicrm_pre', array('\Civi\Core\Event\PreEvent', 'dispatchSubevent'), 100);
313 $dispatcher->addListener('hook_civicrm_post', array('\Civi\Core\Event\PostEvent', 'dispatchSubevent'), 100);
314 $dispatcher->addListener('hook_civicrm_post::Activity', array('\Civi\CCase\Events', 'fireCaseChange'));
315 $dispatcher->addListener('hook_civicrm_post::Case', array('\Civi\CCase\Events', 'fireCaseChange'));
316 $dispatcher->addListener('hook_civicrm_caseChange', array('\Civi\CCase\Events', 'delegateToXmlListeners'));
317 $dispatcher->addListener('hook_civicrm_caseChange', array('\Civi\CCase\SequenceListener', 'onCaseChange_static'));
318 $dispatcher->addListener('hook_civicrm_eventDefs', array('\Civi\Core\CiviEventInspector', 'findBuiltInEvents'));
319 // TODO We need a better code-convention for metadata about non-hook events.
320 $dispatcher->addListener('hook_civicrm_eventDefs', array('\Civi\API\Events', 'hookEventDefs'));
321 $dispatcher->addListener('hook_civicrm_eventDefs', array('\Civi\Core\Event\SystemInstallEvent', 'hookEventDefs'));
322 $dispatcher->addListener('hook_civicrm_buildAsset', array('\Civi\Angular\Page\Modules', 'buildAngularModules'));
323 $dispatcher->addListener('hook_civicrm_buildAsset', array('\CRM_Utils_VisualBundle', 'buildAssetJs'));
324 $dispatcher->addListener('hook_civicrm_buildAsset', array('\CRM_Utils_VisualBundle', 'buildAssetCss'));
325 $dispatcher->addListener('civi.dao.postInsert', array('\CRM_Core_BAO_RecurringEntity', 'triggerInsert'));
326 $dispatcher->addListener('civi.dao.postUpdate', array('\CRM_Core_BAO_RecurringEntity', 'triggerUpdate'));
327 $dispatcher->addListener('civi.dao.postDelete', array('\CRM_Core_BAO_RecurringEntity', 'triggerDelete'));
328 $dispatcher->addListener('hook_civicrm_unhandled_exception', array(
329 'CRM_Core_LegacyErrorHandler',
332 $dispatcher->addListener(\Civi\ActionSchedule\Events
::MAPPINGS
, array('CRM_Activity_ActionMapping', 'onRegisterActionMappings'));
333 $dispatcher->addListener(\Civi\ActionSchedule\Events
::MAPPINGS
, array('CRM_Contact_ActionMapping', 'onRegisterActionMappings'));
334 $dispatcher->addListener(\Civi\ActionSchedule\Events
::MAPPINGS
, array('CRM_Contribute_ActionMapping_ByPage', 'onRegisterActionMappings'));
335 $dispatcher->addListener(\Civi\ActionSchedule\Events
::MAPPINGS
, array('CRM_Contribute_ActionMapping_ByType', 'onRegisterActionMappings'));
336 $dispatcher->addListener(\Civi\ActionSchedule\Events
::MAPPINGS
, array('CRM_Event_ActionMapping', 'onRegisterActionMappings'));
337 $dispatcher->addListener(\Civi\ActionSchedule\Events
::MAPPINGS
, array('CRM_Member_ActionMapping', 'onRegisterActionMappings'));
339 if (\CRM_Utils_Constant
::value('CIVICRM_FLEXMAILER_HACK_LISTENERS')) {
340 \Civi\Core\Resolver
::singleton()->call(CIVICRM_FLEXMAILER_HACK_LISTENERS
, array($dispatcher));
347 * @return LockManager
349 public static function createLockManager() {
350 // Ideally, downstream implementers could override any definitions in
351 // the container. For now, we'll make-do with some define()s.
352 $lm = new LockManager();
354 ->register('/^cache\./', defined('CIVICRM_CACHE_LOCK') ? CIVICRM_CACHE_LOCK
: array('CRM_Core_Lock', 'createScopedLock'))
355 ->register('/^data\./', defined('CIVICRM_DATA_LOCK') ? CIVICRM_DATA_LOCK
: array('CRM_Core_Lock', 'createScopedLock'))
356 ->register('/^worker\.mailing\.send\./', defined('CIVICRM_WORK_LOCK') ? CIVICRM_WORK_LOCK
: array('CRM_Core_Lock', 'createCivimailLock'))
357 ->register('/^worker\./', defined('CIVICRM_WORK_LOCK') ? CIVICRM_WORK_LOCK
: array('CRM_Core_Lock', 'createScopedLock'));
359 // Registrations may use complex resolver expressions, but (as a micro-optimization)
360 // the default factory is specified as an array.
366 * @param \Symfony\Component\EventDispatcher\EventDispatcher $dispatcher
367 * @param $magicFunctionProvider
369 * @return \Civi\API\Kernel
371 public function createApiKernel($dispatcher, $magicFunctionProvider) {
372 $dispatcher->addSubscriber(new \Civi\API\Subscriber\
ChainSubscriber());
373 $dispatcher->addSubscriber(new \Civi\API\Subscriber\
TransactionSubscriber());
374 $dispatcher->addSubscriber(new \Civi\API\Subscriber\
I18nSubscriber());
375 $dispatcher->addSubscriber($magicFunctionProvider);
376 $dispatcher->addSubscriber(new \Civi\API\Subscriber\
PermissionCheck());
377 $dispatcher->addSubscriber(new \Civi\API\Subscriber\
APIv3SchemaAdapter());
378 $dispatcher->addSubscriber(new \Civi\API\Subscriber\
WrapperAdapter(array(
379 \CRM_Utils_API_HTMLInputCoder
::singleton(),
380 \CRM_Utils_API_NullOutputCoder
::singleton(),
381 \CRM_Utils_API_ReloadOption
::singleton(),
382 \CRM_Utils_API_MatchOption
::singleton(),
384 $dispatcher->addSubscriber(new \Civi\API\Subscriber\
XDebugSubscriber());
385 $kernel = new \Civi\API\
Kernel($dispatcher);
387 $reflectionProvider = new \Civi\API\Provider\
ReflectionProvider($kernel);
388 $dispatcher->addSubscriber($reflectionProvider);
390 $dispatcher->addSubscriber(new \Civi\API\Subscriber\
DynamicFKAuthorization(
393 array('create', 'get', 'delete'),
394 // Given a file ID, determine the entity+table it's attached to.
395 'SELECT if(cf.id,1,0) as is_valid, cef.entity_table, cef.entity_id
397 LEFT JOIN civicrm_entity_file cef ON cf.id = cef.file_id
399 // Get a list of custom fields (field_name,table_name,extends)
400 'SELECT concat("custom_",fld.id) as field_name,
401 grp.table_name as table_name,
402 grp.extends as extends
403 FROM civicrm_custom_field fld
404 INNER JOIN civicrm_custom_group grp ON fld.custom_group_id = grp.id
405 WHERE fld.data_type = "File"
407 array('civicrm_activity', 'civicrm_mailing', 'civicrm_contact', 'civicrm_grant')
410 $kernel->setApiProviders(array(
412 $magicFunctionProvider,
419 * @param ContainerInterface $container
420 * @return \CRM_Core_Resources
422 public static function createResources($container) {
423 $sys = \CRM_Extension_System
::singleton();
424 return new \
CRM_Core_Resources(
426 $container->get('cache.js_strings'),
427 \CRM_Core_Config
::isUpgradeMode() ?
NULL : 'resCacheCode'
432 * @param ContainerInterface $container
433 * @return \CRM_Core_PrevNextCache_Interface
435 public static function createPrevNextCache($container) {
436 $cacheDriver = \CRM_Utils_Cache
::getCacheDriver();
437 $service = 'prevnext.driver.' . strtolower($cacheDriver);
438 return $container->has($service)
439 ?
$container->get($service)
440 : $container->get('prevnext.driver.sql');
444 * Get a list of boot services.
446 * These are services which must be setup *before* the container can operate.
448 * @param bool $loadFromDB
449 * @throws \CRM_Core_Exception
451 public static function boot($loadFromDB) {
452 // Array(string $serviceId => object $serviceInstance).
453 $bootServices = array();
454 \Civi
::$statics[__CLASS__
]['boot'] = &$bootServices;
456 $bootServices['runtime'] = $runtime = new \
CRM_Core_Config_Runtime();
457 $runtime->initialize($loadFromDB);
459 $bootServices['paths'] = new \Civi\Core\
Paths();
461 $class = $runtime->userFrameworkClass
;
462 $bootServices['userSystem'] = $userSystem = new $class();
463 $userSystem->initialize();
465 $userPermissionClass = 'CRM_Core_Permission_' . $runtime->userFramework
;
466 $bootServices['userPermissionClass'] = new $userPermissionClass();
468 $bootServices['cache.settings'] = \CRM_Utils_Cache
::create(array(
469 'name' => 'settings',
470 'type' => array('*memory*', 'SqlGroup', 'ArrayCache'),
473 $bootServices['settings_manager'] = new \Civi\Core\
SettingsManager($bootServices['cache.settings']);
475 $bootServices['lockManager'] = self
::createLockManager();
477 if ($loadFromDB && $runtime->dsn
) {
478 \CRM_Core_DAO
::init($runtime->dsn
);
479 \CRM_Utils_Hook
::singleton(TRUE);
480 \CRM_Extension_System
::singleton(TRUE);
481 \CRM_Extension_System
::singleton(TRUE)->getClassLoader()->register();
483 $runtime->includeCustomPath();
486 $container = $c->loadContainer();
487 foreach ($bootServices as $name => $obj) {
488 $container->set($name, $obj);
490 \Civi
::$statics[__CLASS__
]['container'] = $container;
494 public static function getBootService($name) {
495 return \Civi
::$statics[__CLASS__
]['boot'][$name];
499 * Determine whether the container services are available.
503 public static function isContainerBooted() {
504 return isset(\Civi
::$statics[__CLASS__
]['container']);