123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119 |
- <?php
- /*
- * This file is part of the Symfony package.
- *
- * (c) Fabien Potencier <fabien@symfony.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
- namespace Symfony\Component\DependencyInjection\Extension;
- use Symfony\Component\DependencyInjection\Container;
- use Symfony\Component\DependencyInjection\Exception\BadMethodCallException;
- use Symfony\Component\DependencyInjection\Exception\InvalidArgumentException;
- use Symfony\Component\Config\Resource\FileResource;
- use Symfony\Component\DependencyInjection\ContainerBuilder;
- use Symfony\Component\Config\Definition\Processor;
- use Symfony\Component\Config\Definition\ConfigurationInterface;
- /**
- * Provides useful features shared by many extensions.
- *
- * @author Fabien Potencier <fabien@symfony.com>
- */
- abstract class Extension implements ExtensionInterface, ConfigurationExtensionInterface
- {
- /**
- * {@inheritdoc}
- */
- public function getXsdValidationBasePath()
- {
- return false;
- }
- /**
- * {@inheritdoc}
- */
- public function getNamespace()
- {
- return 'http://example.org/schema/dic/'.$this->getAlias();
- }
- /**
- * Returns the recommended alias to use in XML.
- *
- * This alias is also the mandatory prefix to use when using YAML.
- *
- * This convention is to remove the "Extension" postfix from the class
- * name and then lowercase and underscore the result. So:
- *
- * AcmeHelloExtension
- *
- * becomes
- *
- * acme_hello
- *
- * This can be overridden in a sub-class to specify the alias manually.
- *
- * @return string The alias
- *
- * @throws BadMethodCallException When the extension name does not follow conventions
- */
- public function getAlias()
- {
- $className = get_class($this);
- if (substr($className, -9) != 'Extension') {
- throw new BadMethodCallException('This extension does not follow the naming convention; you must overwrite the getAlias() method.');
- }
- $classBaseName = substr(strrchr($className, '\\'), 1, -9);
- return Container::underscore($classBaseName);
- }
- /**
- * {@inheritdoc}
- */
- public function getConfiguration(array $config, ContainerBuilder $container)
- {
- $reflected = new \ReflectionClass($this);
- $namespace = $reflected->getNamespaceName();
- $class = $namespace.'\\Configuration';
- if (class_exists($class)) {
- $r = new \ReflectionClass($class);
- $container->addResource(new FileResource($r->getFileName()));
- if (!method_exists($class, '__construct')) {
- return new $class();
- }
- }
- }
- final protected function processConfiguration(ConfigurationInterface $configuration, array $configs)
- {
- $processor = new Processor();
- return $processor->processConfiguration($configuration, $configs);
- }
- /**
- * @param ContainerBuilder $container
- * @param array $config
- *
- * @return bool Whether the configuration is enabled
- *
- * @throws InvalidArgumentException When the config is not enableable
- */
- protected function isConfigEnabled(ContainerBuilder $container, array $config)
- {
- if (!array_key_exists('enabled', $config)) {
- throw new InvalidArgumentException("The config array has no 'enabled' key.");
- }
- return (bool) $container->getParameterBag()->resolveValue($config['enabled']);
- }
- }
|