vendor/symfony/form/Symfony/Component/Form/Extension/Core/DataTransformer/DataTransformerChain.php

   1 <?php
   2
   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  */
  11
  12 namespace Symfony\Component\Form\Extension\Core\DataTransformer;
  13
  14 use Symfony\Component\Form\DataTransformerInterface;
  15 use Symfony\Component\Form\Exception\TransformationFailedException;
  16
  17 /**
  18  * Passes a value through multiple value transformers
  19  *
  20  * @author Bernhard Schussek <bschussek@gmail.com>
  21  */
  22 class DataTransformerChain implements DataTransformerInterface
  23 {
  24     /**
  25      * The value transformers
  26      * @var DataTransformerInterface[]
  27      */
  28     protected $transformers;
  29
  30     /**
  31      * Uses the given value transformers to transform values
  32      *
  33      * @param array $transformers
  34      */
  35     public function __construct(array $transformers)
  36     {
  37         $this->transformers = $transformers;
  38     }
  39
  40     /**
  41      * Passes the value through the transform() method of all nested transformers
  42      *
  43      * The transformers receive the value in the same order as they were passed
  44      * to the constructor. Each transformer receives the result of the previous
  45      * transformer as input. The output of the last transformer is returned
  46      * by this method.
  47      *
  48      * @param mixed $value The original value
  49      *
  50      * @return mixed The transformed value
  51      *
  52      * @throws TransformationFailedException
  53      */
  54     public function transform($value)
  55     {
  56         foreach ($this->transformers as $transformer) {
  57             $value = $transformer->transform($value);
  58         }
  59
  60         return $value;
  61     }
  62
  63     /**
  64      * Passes the value through the reverseTransform() method of all nested
  65      * transformers
  66      *
  67      * The transformers receive the value in the reverse order as they were passed
  68      * to the constructor. Each transformer receives the result of the previous
  69      * transformer as input. The output of the last transformer is returned
  70      * by this method.
  71      *
  72      * @param mixed $value The transformed value
  73      *
  74      * @return mixed The reverse-transformed value
  75      *
  76      * @throws TransformationFailedException
  77      */
  78     public function reverseTransform($value)
  79     {
  80         for ($i = count($this->transformers) - 1; $i >= 0; --$i) {
  81             $value = $this->transformers[$i]->reverseTransform($value);
  82         }
  83
  84         return $value;
  85     }
  86 }