vendor/symfony/config/Definition/Processor.php line 46

  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <fabien@symfony.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\Component\Config\Definition;
  14. /**
  15.  * This class is the entry point for config normalization/merging/finalization.
  16.  *
  17.  * @author Johannes M. Schmitt <schmittjoh@gmail.com>
  18.  *
  19.  * @final
  20.  */
  21. class Processor
  22. {
  23.     /**
  24.      * Processes an array of configurations.
  25.      *
  26.      * @param array $configs An array of configuration items to process
  27.      */
  28.     public function process(NodeInterface $configTree, array $configs): array
  29.     {
  30.         $currentConfig = [];
  31.         foreach ($configs as $config) {
  32.             $config = $configTree->normalize($config);
  33.             $currentConfig = $configTree->merge($currentConfig, $config);
  34.         }
  36.         return $configTree->finalize($currentConfig);
  37.     }
  39.     /**
  40.      * Processes an array of configurations.
  41.      *
  42.      * @param array $configs An array of configuration items to process
  43.      */
  44.     public function processConfiguration(ConfigurationInterface $configuration, array $configs): array
  45.     {
  46.         return $this->process($configuration->getConfigTreeBuilder()->buildTree(), $configs);
  47.     }
  49.     /**
  50.      * Normalizes a configuration entry.
  51.      *
  52.      * This method returns a normalize configuration array for a given key
  53.      * to remove the differences due to the original format (YAML and XML mainly).
  54.      *
  55.      * Here is an example.
  56.      *
  57.      * The configuration in XML:
  58.      *
  59.      * <twig:extension>twig.extension.foo</twig:extension>
  60.      * <twig:extension>twig.extension.bar</twig:extension>
  61.      *
  62.      * And the same configuration in YAML:
  63.      *
  64.      * extensions: ['twig.extension.foo', 'twig.extension.bar']
  65.      *
  66.      * @param array       $config A config array
  67.      * @param string      $key    The key to normalize
  68.      * @param string|null $plural The plural form of the key if it is irregular
  69.      */
  70.     public static function normalizeConfig(array $config, string $key, string $plural = null): array
  71.     {
  72.         $plural ??= $key.'s';
  74.         if (isset($config[$plural])) {
  75.             return $config[$plural];
  76.         }
  78.         if (isset($config[$key])) {
  79.             if (\is_string($config[$key]) || !\is_int(key($config[$key]))) {
  80.                 // only one
  81.                 return [$config[$key]];
  82.             }
  84.             return $config[$key];
  85.         }
  87.         return [];
  88.     }
  89. }