vendor/symfony/doctrine-bridge/Form/ChoiceList/DoctrineChoiceLoader.php line 24

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 Symfony\Bridge\Doctrine\Form\ChoiceList;
  14. use Doctrine\Persistence\ObjectManager;
  15. use Symfony\Component\Form\ChoiceList\ArrayChoiceList;
  16. use Symfony\Component\Form\ChoiceList\ChoiceListInterface;
  17. use Symfony\Component\Form\ChoiceList\Loader\ChoiceLoaderInterface;
  19. /**
  20.  * Loads choices using a Doctrine object manager.
  21.  *
  22.  * @author Bernhard Schussek <bschussek@gmail.com>
  23.  */
  24. class DoctrineChoiceLoader implements ChoiceLoaderInterface
  25. {
  26.     private $manager;
  27.     private $class;
  28.     private $idReader;
  29.     private $objectLoader;
  31.     /**
  32.      * @var ChoiceListInterface
  33.      */
  34.     private $choiceList;
  36.     /**
  37.      * Creates a new choice loader.
  38.      *
  39.      * Optionally, an implementation of {@link EntityLoaderInterface} can be
  40.      * passed which optimizes the object loading for one of the Doctrine
  41.      * mapper implementations.
  42.      *
  43.      * @param string $class The class name of the loaded objects
  44.      */
  45.     public function __construct(ObjectManager $manager, string $class, IdReader $idReader = null, EntityLoaderInterface $objectLoader = null)
  46.     {
  47.         $classMetadata = $manager->getClassMetadata($class);
  49.         if ($idReader && !$idReader->isSingleId()) {
  50.             @trigger_error(sprintf('Passing an instance of "%s" to "%s" with an entity class "%s" that has a composite id is deprecated since Symfony 4.3 and will throw an exception in 5.0.', IdReader::class, __CLASS__, $class), \E_USER_DEPRECATED);
  52.             // In Symfony 5.0
  53.             // throw new \InvalidArgumentException(sprintf('The second argument `$idReader` of "%s" must be null when the query cannot be optimized because of composite id fields.', __METHOD__));
  54.         }
  56.         if ((5 > \func_num_args() || false !== func_get_arg(4)) && null === $idReader) {
  57.             $idReader = new IdReader($manager, $classMetadata);
  59.             if ($idReader->isSingleId()) {
  60.                 @trigger_error(sprintf('Not explicitly passing an instance of "%s" to "%s" when it can optimize single id entity "%s" has been deprecated in 4.3 and will not apply any optimization in 5.0.', IdReader::class, __CLASS__, $class), \E_USER_DEPRECATED);
  61.             } else {
  62.                 $idReader = null;
  63.             }
  64.         }
  66.         $this->manager = $manager;
  67.         $this->class = $classMetadata->getName();
  68.         $this->idReader = $idReader;
  69.         $this->objectLoader = $objectLoader;
  70.     }
  72.     /**
  73.      * {@inheritdoc}
  74.      */
  75.     public function loadChoiceList($value = null)
  76.     {
  77.         if ($this->choiceList) {
  78.             return $this->choiceList;
  79.         }
  81.         $objects = $this->objectLoader
  82.             ? $this->objectLoader->getEntities()
  83.             : $this->manager->getRepository($this->class)->findAll();
  85.         return $this->choiceList = new ArrayChoiceList($objects, $value);
  86.     }
  88.     /**
  89.      * {@inheritdoc}
  90.      */
  91.     public function loadValuesForChoices(array $choices, $value = null)
  92.     {
  93.         // Performance optimization
  94.         if (empty($choices)) {
  95.             return [];
  96.         }
  98.         // Optimize performance for single-field identifiers. We already
  99.         // know that the IDs are used as values
  100.         $optimize = $this->idReader && (null === $value || \is_array($value) && $value[0] === $this->idReader);
  102.         // Attention: This optimization does not check choices for existence
  103.         if ($optimize && !$this->choiceList && $this->idReader->isSingleId()) {
  104.             $values = [];
  106.             // Maintain order and indices of the given objects
  107.             foreach ($choices as $i => $object) {
  108.                 if ($object instanceof $this->class) {
  109.                     // Make sure to convert to the right format
  110.                     $values[$i] = (string) $this->idReader->getIdValue($object);
  111.                 }
  112.             }
  114.             return $values;
  115.         }
  117.         return $this->loadChoiceList($value)->getValuesForChoices($choices);
  118.     }
  120.     /**
  121.      * {@inheritdoc}
  122.      */
  123.     public function loadChoicesForValues(array $values, $value = null)
  124.     {
  125.         // Performance optimization
  126.         // Also prevents the generation of "WHERE id IN ()" queries through the
  127.         // object loader. At least with MySQL and on the development machine
  128.         // this was tested on, no exception was thrown for such invalid
  129.         // statements, consequently no test fails when this code is removed.
  130.         // https://github.com/symfony/symfony/pull/8981#issuecomment-24230557
  131.         if (empty($values)) {
  132.             return [];
  133.         }
  135.         // Optimize performance in case we have an object loader and
  136.         // a single-field identifier
  137.         $optimize = $this->idReader && (null === $value || \is_array($value) && $this->idReader === $value[0]);
  139.         if ($optimize && !$this->choiceList && $this->objectLoader && $this->idReader->isSingleId()) {
  140.             $unorderedObjects = $this->objectLoader->getEntitiesByIds($this->idReader->getIdField(), $values);
  141.             $objectsById = [];
  142.             $objects = [];
  144.             // Maintain order and indices from the given $values
  145.             // An alternative approach to the following loop is to add the
  146.             // "INDEX BY" clause to the Doctrine query in the loader,
  147.             // but I'm not sure whether that's doable in a generic fashion.
  148.             foreach ($unorderedObjects as $object) {
  149.                 $objectsById[(string) $this->idReader->getIdValue($object)] = $object;
  150.             }
  152.             foreach ($values as $i => $id) {
  153.                 if (isset($objectsById[$id])) {
  154.                     $objects[$i] = $objectsById[$id];
  155.                 }
  156.             }
  158.             return $objects;
  159.         }
  161.         return $this->loadChoiceList($value)->getChoicesForValues($values);
  162.     }
  163. }