vendor/symfony/var-exporter/Internal/LazyObjectState.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\VarExporter\Internal;
  14. use Symfony\Component\VarExporter\Hydrator as PublicHydrator;
  16. /**
  17.  * Keeps the state of lazy objects.
  18.  *
  19.  * As a micro-optimization, this class uses no type declarations.
  20.  *
  21.  * @internal
  22.  */
  23. class LazyObjectState
  24. {
  25.     public const STATUS_UNINITIALIZED_FULL = 1;
  26.     public const STATUS_UNINITIALIZED_PARTIAL = 2;
  27.     public const STATUS_INITIALIZED_FULL = 3;
  28.     public const STATUS_INITIALIZED_PARTIAL = 4;
  30.     /**
  31.      * @var array<string, true>
  32.      */
  33.     public readonly array $skippedProperties;
  35.     /**
  36.      * @var self::STATUS_*
  37.      */
  38.     public int $status = 0;
  40.     public function __construct(public readonly \Closure|array $initializer, $skippedProperties = [])
  41.     {
  42.         $this->skippedProperties = $skippedProperties;
  43.         $this->status = \is_array($initializer) ? self::STATUS_UNINITIALIZED_PARTIAL : self::STATUS_UNINITIALIZED_FULL;
  44.     }
  46.     public function initialize($instance, $propertyName, $propertyScope)
  47.     {
  48.         if (self::STATUS_INITIALIZED_FULL === $this->status) {
  49.             return self::STATUS_INITIALIZED_FULL;
  50.         }
  52.         if (\is_array($this->initializer)) {
  53.             $class = $instance::class;
  54.             $propertyScope ??= $class;
  55.             $propertyScopes = Hydrator::$propertyScopes[$class];
  56.             $propertyScopes[$k = "\0$propertyScope\0$propertyName"] ?? $propertyScopes[$k = "\0*\0$propertyName"] ?? $k = $propertyName;
  58.             if ($initializer = $this->initializer[$k] ?? null) {
  59.                 $value = $initializer(...[$instance, $propertyName, $propertyScope, LazyObjectRegistry::$defaultProperties[$class][$k] ?? null]);
  60.                 $accessor = LazyObjectRegistry::$classAccessors[$propertyScope] ??= LazyObjectRegistry::getClassAccessors($propertyScope);
  61.                 $accessor['set']($instance, $propertyName, $value);
  63.                 return $this->status = self::STATUS_INITIALIZED_PARTIAL;
  64.             }
  66.             $status = self::STATUS_UNINITIALIZED_PARTIAL;
  68.             if ($initializer = $this->initializer["\0"] ?? null) {
  69.                 if (!\is_array($values = $initializer($instance, LazyObjectRegistry::$defaultProperties[$class]))) {
  70.                     throw new \TypeError(sprintf('The lazy-initializer defined for instance of "%s" must return an array, got "%s".', $class, get_debug_type($values)));
  71.                 }
  72.                 $properties = (array) $instance;
  73.                 foreach ($values as $key => $value) {
  74.                     if ($k === $key) {
  75.                         $status = self::STATUS_INITIALIZED_PARTIAL;
  76.                     }
  77.                     if (!\array_key_exists($key, $properties) && [$scope, $name, $readonlyScope] = $propertyScopes[$key] ?? null) {
  78.                         $scope = $readonlyScope ?? ('*' !== $scope ? $scope : $class);
  79.                         $accessor = LazyObjectRegistry::$classAccessors[$scope] ??= LazyObjectRegistry::getClassAccessors($scope);
  80.                         $accessor['set']($instance, $name, $value);
  81.                     }
  82.                 }
  83.             }
  85.             return $status;
  86.         }
  88.         $this->status = self::STATUS_INITIALIZED_FULL;
  90.         try {
  91.             if ($defaultProperties = array_diff_key(LazyObjectRegistry::$defaultProperties[$instance::class], $this->skippedProperties)) {
  92.                 PublicHydrator::hydrate($instance, $defaultProperties);
  93.             }
  95.             ($this->initializer)($instance);
  96.         } catch (\Throwable $e) {
  97.             $this->status = self::STATUS_UNINITIALIZED_FULL;
  98.             $this->reset($instance);
  100.             throw $e;
  101.         }
  103.         return self::STATUS_INITIALIZED_FULL;
  104.     }
  106.     public function reset($instance): void
  107.     {
  108.         $class = $instance::class;
  109.         $propertyScopes = Hydrator::$propertyScopes[$class] ??= Hydrator::getPropertyScopes($class);
  110.         $skippedProperties = $this->skippedProperties;
  111.         $properties = (array) $instance;
  112.         $onlyProperties = \is_array($this->initializer) ? $this->initializer : null;
  114.         foreach ($propertyScopes as $key => [$scope, $name, $readonlyScope]) {
  115.             $propertyScopes[$k = "\0$scope\0$name"] ?? $propertyScopes[$k = "\0*\0$name"] ?? $k = $name;
  117.             if ($k === $key && (null !== $readonlyScope || !\array_key_exists($k, $properties))) {
  118.                 $skippedProperties[$k] = true;
  119.             }
  120.         }
  122.         foreach (LazyObjectRegistry::$classResetters[$class] as $reset) {
  123.             $reset($instance, $skippedProperties, $onlyProperties);
  124.         }
  126.         $this->status = self::STATUS_INITIALIZED_FULL === $this->status ? self::STATUS_UNINITIALIZED_FULL : self::STATUS_UNINITIALIZED_PARTIAL;
  127.     }
  128. }