vendor/sensio/framework-extra-bundle/Request/ParamConverter/ParamConverterManager.php line 92

Open in your IDE?
  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 Sensio\Bundle\FrameworkExtraBundle\Request\ParamConverter;
  14. use Sensio\Bundle\FrameworkExtraBundle\Configuration\ParamConverter;
  15. use Symfony\Component\HttpFoundation\Request;
  17. /**
  18.  * Managers converters.
  19.  *
  20.  * @author Fabien Potencier <fabien@symfony.com>
  21.  * @author Henrik Bjornskov <henrik@bjrnskov.dk>
  22.  */
  23. class ParamConverterManager
  24. {
  25.     /**
  26.      * @var array
  27.      */
  28.     private $converters = [];
  30.     /**
  31.      * @var array
  32.      */
  33.     private $namedConverters = [];
  35.     /**
  36.      * Applies all converters to the passed configurations and stops when a
  37.      * converter is applied it will move on to the next configuration and so on.
  38.      *
  39.      * @param array|object $configurations
  40.      */
  41.     public function apply(Request $request, $configurations)
  42.     {
  43.         if (\is_object($configurations)) {
  44.             $configurations = [$configurations];
  45.         }
  47.         foreach ($configurations as $configuration) {
  48.             $this->applyConverter($request, $configuration);
  49.         }
  50.     }
  52.     /**
  53.      * Applies converter on request based on the given configuration.
  54.      */
  55.     private function applyConverter(Request $request, ParamConverter $configuration)
  56.     {
  57.         $value = $request->attributes->get($configuration->getName());
  58.         $className = $configuration->getClass();
  60.         // If the value is already an instance of the class we are trying to convert it into
  61.         // we should continue as no conversion is required
  62.         if (\is_object($value) && $value instanceof $className) {
  63.             return;
  64.         }
  66.         if ($converterName = $configuration->getConverter()) {
  67.             if (!isset($this->namedConverters[$converterName])) {
  68.                 throw new \RuntimeException(sprintf(
  69.                     "No converter named '%s' found for conversion of parameter '%s'.",
  70.                     $converterName,
  71.                     $configuration->getName()
  72.                 ));
  73.             }
  75.             $converter = $this->namedConverters[$converterName];
  77.             if (!$converter->supports($configuration)) {
  78.                 throw new \RuntimeException(sprintf(
  79.                     "Converter '%s' does not support conversion of parameter '%s'.",
  80.                     $converterName,
  81.                     $configuration->getName()
  82.                 ));
  83.             }
  85.             $converter->apply($request, $configuration);
  87.             return;
  88.         }
  90.         foreach ($this->all() as $converter) {
  91.             if ($converter->supports($configuration)) {
  92.                 if ($converter->apply($request, $configuration)) {
  93.                     return;
  94.                 }
  95.             }
  96.         }
  97.     }
  99.     /**
  100.      * Adds a parameter converter.
  101.      *
  102.      * Converters match either explicitly via $name or by iteration over all
  103.      * converters with a $priority. If you pass a $priority = null then the
  104.      * added converter will not be part of the iteration chain and can only
  105.      * be invoked explicitly.
  106.      *
  107.      * @param int    $priority the priority (between -10 and 10)
  108.      * @param string $name     name of the converter
  109.      */
  110.     public function add(ParamConverterInterface $converter, $priority = 0, $name = null)
  111.     {
  112.         if (null !== $priority) {
  113.             if (!isset($this->converters[$priority])) {
  114.                 $this->converters[$priority] = [];
  115.             }
  117.             $this->converters[$priority][] = $converter;
  118.         }
  120.         if (null !== $name) {
  121.             $this->namedConverters[$name] = $converter;
  122.         }
  123.     }
  125.     /**
  126.      * Returns all registered param converters.
  127.      *
  128.      * @return array An array of param converters
  129.      */
  130.     public function all()
  131.     {
  132.         krsort($this->converters);
  134.         $converters = [];
  135.         foreach ($this->converters as $all) {
  136.             $converters = array_merge($converters, $all);
  137.         }
  139.         return $converters;
  140.     }
  141. }