DoctrineExtension.php 19KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467
  1. <?php
  2. /*
  3. * This file is part of the Doctrine Bundle
  4. *
  5. * The code was originally distributed inside the Symfony framework.
  6. *
  7. * (c) Fabien Potencier <fabien@symfony.com>
  8. * (c) Doctrine Project, Benjamin Eberlei <kontakt@beberlei.de>
  9. *
  10. * For the full copyright and license information, please view the LICENSE
  11. * file that was distributed with this source code.
  12. */
  13. namespace Doctrine\Bundle\DoctrineBundle\DependencyInjection;
  14. use Symfony\Component\DependencyInjection\Alias;
  15. use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
  16. use Symfony\Component\DependencyInjection\ContainerBuilder;
  17. use Symfony\Component\DependencyInjection\Definition;
  18. use Symfony\Component\DependencyInjection\DefinitionDecorator;
  19. use Symfony\Component\DependencyInjection\Reference;
  20. use Symfony\Bridge\Doctrine\DependencyInjection\AbstractDoctrineExtension;
  21. use Symfony\Component\Config\FileLocator;
  22. /**
  23. * DoctrineExtension is an extension for the Doctrine DBAL and ORM library.
  24. *
  25. * @author Jonathan H. Wage <jonwage@gmail.com>
  26. * @author Fabien Potencier <fabien@symfony.com>
  27. * @author Benjamin Eberlei <kontakt@beberlei.de>
  28. */
  29. class DoctrineExtension extends AbstractDoctrineExtension
  30. {
  31. private $defaultConnection;
  32. private $entityManagers;
  33. /**
  34. * {@inheritDoc}
  35. */
  36. public function load(array $configs, ContainerBuilder $container)
  37. {
  38. $configuration = $this->getConfiguration($configs, $container);
  39. $config = $this->processConfiguration($configuration, $configs);
  40. if (!empty($config['dbal'])) {
  41. $this->dbalLoad($config['dbal'], $container);
  42. }
  43. if (!empty($config['orm'])) {
  44. $this->ormLoad($config['orm'], $container);
  45. }
  46. }
  47. /**
  48. * Loads the DBAL configuration.
  49. *
  50. * Usage example:
  51. *
  52. * <doctrine:dbal id="myconn" dbname="sfweb" user="root" />
  53. *
  54. * @param array $config An array of configuration settings
  55. * @param ContainerBuilder $container A ContainerBuilder instance
  56. */
  57. protected function dbalLoad(array $config, ContainerBuilder $container)
  58. {
  59. $loader = new XmlFileLoader($container, new FileLocator(__DIR__.'/../Resources/config'));
  60. $loader->load('dbal.xml');
  61. if (empty($config['default_connection'])) {
  62. $keys = array_keys($config['connections']);
  63. $config['default_connection'] = reset($keys);
  64. }
  65. $this->defaultConnection = $config['default_connection'];
  66. $container->setAlias('database_connection', sprintf('doctrine.dbal.%s_connection', $this->defaultConnection));
  67. $container->setAlias('doctrine.dbal.event_manager', new Alias(sprintf('doctrine.dbal.%s_connection.event_manager', $this->defaultConnection), false));
  68. $container->setParameter('doctrine.dbal.connection_factory.types', $config['types']);
  69. $connections = array();
  70. foreach (array_keys($config['connections']) as $name) {
  71. $connections[$name] = sprintf('doctrine.dbal.%s_connection', $name);
  72. }
  73. $container->setParameter('doctrine.connections', $connections);
  74. $container->setParameter('doctrine.default_connection', $this->defaultConnection);
  75. foreach ($config['connections'] as $name => $connection) {
  76. $this->loadDbalConnection($name, $connection, $container);
  77. }
  78. }
  79. /**
  80. * Loads a configured DBAL connection.
  81. *
  82. * @param string $name The name of the connection
  83. * @param array $connection A dbal connection configuration.
  84. * @param ContainerBuilder $container A ContainerBuilder instance
  85. */
  86. protected function loadDbalConnection($name, array $connection, ContainerBuilder $container)
  87. {
  88. // configuration
  89. $configuration = $container->setDefinition(sprintf('doctrine.dbal.%s_connection.configuration', $name), new DefinitionDecorator('doctrine.dbal.connection.configuration'));
  90. $logger = null;
  91. if ($connection['logging']) {
  92. $logger = new Reference('doctrine.dbal.logger');
  93. }
  94. unset ($connection['logging']);
  95. if ($connection['profiling']) {
  96. $profilingLoggerId = 'doctrine.dbal.logger.profiling.'.$name;
  97. $container->setDefinition($profilingLoggerId, new DefinitionDecorator('doctrine.dbal.logger.profiling'));
  98. $logger = new Reference($profilingLoggerId);
  99. $container->getDefinition('data_collector.doctrine')->addMethodCall('addLogger', array($name, $logger));
  100. if (null !== $logger) {
  101. $chainLogger = new DefinitionDecorator('doctrine.dbal.logger.chain');
  102. $chainLogger->addMethodCall('addLogger', array($logger));
  103. $loggerId = 'doctrine.dbal.logger.chain.'.$name;
  104. $container->setDefinition($loggerId, $chainLogger);
  105. $logger = new Reference($loggerId);
  106. }
  107. }
  108. unset($connection['profiling']);
  109. if (isset($connection['schema_filter']) && $connection['schema_filter']) {
  110. $configuration->addMethodCall('setFilterSchemaAssetsExpression', array($connection['schema_filter']));
  111. }
  112. unset($connection['schema_filter']);
  113. if ($logger) {
  114. $configuration->addMethodCall('setSQLLogger', array($logger));
  115. }
  116. // event manager
  117. $def = $container->setDefinition(sprintf('doctrine.dbal.%s_connection.event_manager', $name), new DefinitionDecorator('doctrine.dbal.connection.event_manager'));
  118. // connection
  119. // PDO ignores the charset property before 5.3.6 so the init listener has to be used instead.
  120. if (isset($connection['charset']) && version_compare(PHP_VERSION, '5.3.6', '<')) {
  121. if ((isset($connection['driver']) && stripos($connection['driver'], 'mysql') !== false) ||
  122. (isset($connection['driver_class']) && stripos($connection['driver_class'], 'mysql') !== false)) {
  123. $mysqlSessionInit = new Definition('%doctrine.dbal.events.mysql_session_init.class%');
  124. $mysqlSessionInit->setArguments(array($connection['charset']));
  125. $mysqlSessionInit->setPublic(false);
  126. $mysqlSessionInit->addTag('doctrine.event_subscriber', array('connection' => $name));
  127. $container->setDefinition(
  128. sprintf('doctrine.dbal.%s_connection.events.mysqlsessioninit', $name),
  129. $mysqlSessionInit
  130. );
  131. unset($connection['charset']);
  132. }
  133. }
  134. $options = $this->getConnectionOptions($connection);
  135. $container
  136. ->setDefinition(sprintf('doctrine.dbal.%s_connection', $name), new DefinitionDecorator('doctrine.dbal.connection'))
  137. ->setArguments(array(
  138. $options,
  139. new Reference(sprintf('doctrine.dbal.%s_connection.configuration', $name)),
  140. new Reference(sprintf('doctrine.dbal.%s_connection.event_manager', $name)),
  141. $connection['mapping_types'],
  142. ))
  143. ;
  144. }
  145. protected function getConnectionOptions($connection)
  146. {
  147. $options = $connection;
  148. if (isset($options['platform_service'])) {
  149. $options['platform'] = new Reference($options['platform_service']);
  150. unset($options['platform_service']);
  151. }
  152. unset($options['mapping_types']);
  153. foreach (array(
  154. 'options' => 'driverOptions',
  155. 'driver_class' => 'driverClass',
  156. 'wrapper_class' => 'wrapperClass',
  157. 'keep_slave' => 'keepSlave',
  158. ) as $old => $new) {
  159. if (isset($options[$old])) {
  160. $options[$new] = $options[$old];
  161. unset($options[$old]);
  162. }
  163. }
  164. if (!empty($options['slaves'])) {
  165. $nonRewrittenKeys = array(
  166. 'driver' => true, 'driverOptions' => true, 'driverClass' => true,
  167. 'wrapperClass' => true, 'keepSlave' => true,
  168. 'platform' => true, 'slaves' => true, 'master' => true,
  169. // included by safety but should have been unset already
  170. 'logging' => true, 'profiling' => true, 'mapping_types' => true, 'platform_service' => true,
  171. );
  172. foreach ($options as $key => $value) {
  173. if (isset($nonRewrittenKeys[$key])) {
  174. continue;
  175. }
  176. $options['master'][$key] = $value;
  177. unset($options[$key]);
  178. }
  179. if (empty($options['wrapperClass'])) {
  180. // Change the wrapper class only if the user does not already forced using a custom one.
  181. $options['wrapperClass'] = 'Doctrine\\DBAL\\Connections\\MasterSlaveConnection';
  182. }
  183. } else {
  184. unset($options['slaves']);
  185. }
  186. return $options;
  187. }
  188. /**
  189. * Loads the Doctrine ORM configuration.
  190. *
  191. * Usage example:
  192. *
  193. * <doctrine:orm id="mydm" connection="myconn" />
  194. *
  195. * @param array $config An array of configuration settings
  196. * @param ContainerBuilder $container A ContainerBuilder instance
  197. */
  198. protected function ormLoad(array $config, ContainerBuilder $container)
  199. {
  200. $loader = new XmlFileLoader($container, new FileLocator(__DIR__.'/../Resources/config'));
  201. $loader->load('orm.xml');
  202. $this->entityManagers = array();
  203. foreach (array_keys($config['entity_managers']) as $name) {
  204. $this->entityManagers[$name] = sprintf('doctrine.orm.%s_entity_manager', $name);
  205. }
  206. $container->setParameter('doctrine.entity_managers', $this->entityManagers);
  207. if (empty($config['default_entity_manager'])) {
  208. $tmp = array_keys($this->entityManagers);
  209. $config['default_entity_manager'] = reset($tmp);
  210. }
  211. $container->setParameter('doctrine.default_entity_manager', $config['default_entity_manager']);
  212. $options = array('auto_generate_proxy_classes', 'proxy_dir', 'proxy_namespace');
  213. foreach ($options as $key) {
  214. $container->setParameter('doctrine.orm.'.$key, $config[$key]);
  215. }
  216. $container->setAlias('doctrine.orm.entity_manager', sprintf('doctrine.orm.%s_entity_manager', $config['default_entity_manager']));
  217. foreach ($config['entity_managers'] as $name => $entityManager) {
  218. $entityManager['name'] = $name;
  219. $this->loadOrmEntityManager($entityManager, $container);
  220. }
  221. if ($config['resolve_target_entities']) {
  222. $def = $container->findDefinition('doctrine.orm.listeners.resolve_target_entity');
  223. foreach ($config['resolve_target_entities'] as $name => $implementation) {
  224. $def->addMethodCall('addResolveTargetEntity', array(
  225. $name, $implementation, array()
  226. ));
  227. }
  228. $def->addTag('doctrine.event_listener', array('event' => 'loadClassMetadata'));
  229. }
  230. }
  231. /**
  232. * Loads a configured ORM entity manager.
  233. *
  234. * @param array $entityManager A configured ORM entity manager.
  235. * @param ContainerBuilder $container A ContainerBuilder instance
  236. */
  237. protected function loadOrmEntityManager(array $entityManager, ContainerBuilder $container)
  238. {
  239. if ($entityManager['auto_mapping'] && count($this->entityManagers) > 1) {
  240. throw new \LogicException('You cannot enable "auto_mapping" when several entity managers are defined.');
  241. }
  242. $ormConfigDef = $container->setDefinition(sprintf('doctrine.orm.%s_configuration', $entityManager['name']), new DefinitionDecorator('doctrine.orm.configuration'));
  243. $this->loadOrmEntityManagerMappingInformation($entityManager, $ormConfigDef, $container);
  244. $this->loadOrmCacheDrivers($entityManager, $container);
  245. $methods = array(
  246. 'setMetadataCacheImpl' => new Reference(sprintf('doctrine.orm.%s_metadata_cache', $entityManager['name'])),
  247. 'setQueryCacheImpl' => new Reference(sprintf('doctrine.orm.%s_query_cache', $entityManager['name'])),
  248. 'setResultCacheImpl' => new Reference(sprintf('doctrine.orm.%s_result_cache', $entityManager['name'])),
  249. 'setMetadataDriverImpl' => new Reference('doctrine.orm.'.$entityManager['name'].'_metadata_driver'),
  250. 'setProxyDir' => '%doctrine.orm.proxy_dir%',
  251. 'setProxyNamespace' => '%doctrine.orm.proxy_namespace%',
  252. 'setAutoGenerateProxyClasses' => '%doctrine.orm.auto_generate_proxy_classes%',
  253. 'setClassMetadataFactoryName' => $entityManager['class_metadata_factory_name'],
  254. 'setDefaultRepositoryClassName' => $entityManager['default_repository_class'],
  255. );
  256. // check for version to keep BC
  257. if (version_compare(\Doctrine\ORM\Version::VERSION, "2.3.0-DEV") >= 0) {
  258. $methods = array_merge($methods, array(
  259. 'setNamingStrategy' => new Reference($entityManager['naming_strategy']),
  260. ));
  261. }
  262. foreach ($methods as $method => $arg) {
  263. $ormConfigDef->addMethodCall($method, array($arg));
  264. }
  265. foreach ($entityManager['hydrators'] as $name => $class) {
  266. $ormConfigDef->addMethodCall('addCustomHydrationMode', array($name, $class));
  267. }
  268. if (!empty($entityManager['dql'])) {
  269. foreach ($entityManager['dql']['string_functions'] as $name => $function) {
  270. $ormConfigDef->addMethodCall('addCustomStringFunction', array($name, $function));
  271. }
  272. foreach ($entityManager['dql']['numeric_functions'] as $name => $function) {
  273. $ormConfigDef->addMethodCall('addCustomNumericFunction', array($name, $function));
  274. }
  275. foreach ($entityManager['dql']['datetime_functions'] as $name => $function) {
  276. $ormConfigDef->addMethodCall('addCustomDatetimeFunction', array($name, $function));
  277. }
  278. }
  279. $enabledFilters = array();
  280. foreach ($entityManager['filters'] as $name => $filter) {
  281. $ormConfigDef->addMethodCall('addFilter', array($name, $filter['class']));
  282. if ($filter['enabled']) {
  283. $enabledFilters[] = $name;
  284. }
  285. }
  286. $managerConfiguratorName = sprintf('doctrine.orm.%s_manager_configurator', $entityManager['name']);
  287. $managerConfiguratorDef = $container
  288. ->setDefinition($managerConfiguratorName, new DefinitionDecorator('doctrine.orm.manager_configurator.abstract'))
  289. ->replaceArgument(0, $enabledFilters)
  290. ;
  291. if (!isset($entityManager['connection'])) {
  292. $entityManager['connection'] = $this->defaultConnection;
  293. }
  294. $container
  295. ->setDefinition(sprintf('doctrine.orm.%s_entity_manager', $entityManager['name']), new DefinitionDecorator('doctrine.orm.entity_manager.abstract'))
  296. ->setArguments(array(
  297. new Reference(sprintf('doctrine.dbal.%s_connection', $entityManager['connection'])),
  298. new Reference(sprintf('doctrine.orm.%s_configuration', $entityManager['name']))
  299. ))
  300. ->setConfigurator(array(new Reference($managerConfiguratorName), 'configure'))
  301. ;
  302. $container->setAlias(
  303. sprintf('doctrine.orm.%s_entity_manager.event_manager', $entityManager['name']),
  304. new Alias(sprintf('doctrine.dbal.%s_connection.event_manager', $entityManager['connection']), false)
  305. );
  306. }
  307. /**
  308. * Loads an ORM entity managers bundle mapping information.
  309. *
  310. * There are two distinct configuration possibilities for mapping information:
  311. *
  312. * 1. Specify a bundle and optionally details where the entity and mapping information reside.
  313. * 2. Specify an arbitrary mapping location.
  314. *
  315. * @example
  316. *
  317. * doctrine.orm:
  318. * mappings:
  319. * MyBundle1: ~
  320. * MyBundle2: yml
  321. * MyBundle3: { type: annotation, dir: Entities/ }
  322. * MyBundle4: { type: xml, dir: Resources/config/doctrine/mapping }
  323. * MyBundle5:
  324. * type: yml
  325. * dir: [bundle-mappings1/, bundle-mappings2/]
  326. * alias: BundleAlias
  327. * arbitrary_key:
  328. * type: xml
  329. * dir: %kernel.dir%/../src/vendor/DoctrineExtensions/lib/DoctrineExtensions/Entities
  330. * prefix: DoctrineExtensions\Entities\
  331. * alias: DExt
  332. *
  333. * In the case of bundles everything is really optional (which leads to autodetection for this bundle) but
  334. * in the mappings key everything except alias is a required argument.
  335. *
  336. * @param array $entityManager A configured ORM entity manager
  337. * @param Definition $ormConfigDef A Definition instance
  338. * @param ContainerBuilder $container A ContainerBuilder instance
  339. */
  340. protected function loadOrmEntityManagerMappingInformation(array $entityManager, Definition $ormConfigDef, ContainerBuilder $container)
  341. {
  342. // reset state of drivers and alias map. They are only used by this methods and children.
  343. $this->drivers = array();
  344. $this->aliasMap = array();
  345. $this->loadMappingInformation($entityManager, $container);
  346. $this->registerMappingDrivers($entityManager, $container);
  347. $ormConfigDef->addMethodCall('setEntityNamespaces', array($this->aliasMap));
  348. }
  349. /**
  350. * {@inheritDoc}
  351. */
  352. protected function getObjectManagerElementName($name)
  353. {
  354. return 'doctrine.orm.'.$name;
  355. }
  356. protected function getMappingObjectDefaultName()
  357. {
  358. return 'Entity';
  359. }
  360. /**
  361. * {@inheritDoc}
  362. */
  363. protected function getMappingResourceConfigDirectory()
  364. {
  365. return 'Resources/config/doctrine';
  366. }
  367. /**
  368. * {@inheritDoc}
  369. */
  370. protected function getMappingResourceExtension()
  371. {
  372. return 'orm';
  373. }
  374. /**
  375. * Loads a configured entity managers cache drivers.
  376. *
  377. * @param array $entityManager A configured ORM entity manager.
  378. * @param ContainerBuilder $container A ContainerBuilder instance
  379. */
  380. protected function loadOrmCacheDrivers(array $entityManager, ContainerBuilder $container)
  381. {
  382. $this->loadObjectManagerCacheDriver($entityManager, $container, 'metadata_cache');
  383. $this->loadObjectManagerCacheDriver($entityManager, $container, 'result_cache');
  384. $this->loadObjectManagerCacheDriver($entityManager, $container, 'query_cache');
  385. }
  386. /**
  387. * {@inheritDoc}
  388. */
  389. public function getXsdValidationBasePath()
  390. {
  391. return __DIR__.'/../Resources/config/schema';
  392. }
  393. /**
  394. * {@inheritDoc}
  395. */
  396. public function getNamespace()
  397. {
  398. return 'http://symfony.com/schema/dic/doctrine';
  399. }
  400. /**
  401. * {@inheritDoc}
  402. */
  403. public function getConfiguration(array $config, ContainerBuilder $container)
  404. {
  405. return new Configuration($container->getParameter('kernel.debug'));
  406. }
  407. }