vendor/symfony/var-exporter/Internal/LazyObjectState.php line 100

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\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 object $realInstance;
  42. public function __construct(public readonly \Closure|array $initializer, $skippedProperties = [])
  43. {
  44. $this->skippedProperties = $skippedProperties;
  45. $this->status = \is_array($initializer) ? self::STATUS_UNINITIALIZED_PARTIAL : self::STATUS_UNINITIALIZED_FULL;
  46. }
  48. public function initialize($instance, $propertyName, $propertyScope)
  49. {
  50. if (self::STATUS_INITIALIZED_FULL === $this->status) {
  51. return self::STATUS_INITIALIZED_FULL;
  52. }
  54. if (\is_array($this->initializer)) {
  55. $class = $instance::class;
  56. $propertyScope ??= $class;
  57. $propertyScopes = Hydrator::$propertyScopes[$class];
  58. $propertyScopes[$k = "\0$propertyScope\0$propertyName"] ?? $propertyScopes[$k = "\0*\0$propertyName"] ?? $k = $propertyName;
  60. if ($initializer = $this->initializer[$k] ?? null) {
  61. $value = $initializer(...[$instance, $propertyName, $propertyScope, LazyObjectRegistry::$defaultProperties[$class][$k] ?? null]);
  62. $accessor = LazyObjectRegistry::$classAccessors[$propertyScope] ??= LazyObjectRegistry::getClassAccessors($propertyScope);
  63. $accessor['set']($instance, $propertyName, $value);
  65. return $this->status = self::STATUS_INITIALIZED_PARTIAL;
  66. }
  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 (!\array_key_exists($key, $properties) && [$scope, $name, $readonlyScope] = $propertyScopes[$key] ?? null) {
  75. $scope = $readonlyScope ?? ('*' !== $scope ? $scope : $class);
  76. $accessor = LazyObjectRegistry::$classAccessors[$scope] ??= LazyObjectRegistry::getClassAccessors($scope);
  77. $accessor['set']($instance, $name, $value);
  79. if ($k === $key) {
  80. $this->status = self::STATUS_INITIALIZED_PARTIAL;
  81. }
  82. }
  83. }
  84. }
  86. return $this->status;
  87. }
  89. if (self::STATUS_INITIALIZED_PARTIAL === $this->status) {
  90. return self::STATUS_INITIALIZED_PARTIAL;
  91. }
  93. $this->status = self::STATUS_INITIALIZED_PARTIAL;
  95. try {
  96. if ($defaultProperties = array_diff_key(LazyObjectRegistry::$defaultProperties[$instance::class], $this->skippedProperties)) {
  97. PublicHydrator::hydrate($instance, $defaultProperties);
  98. }
  100. ($this->initializer)($instance);
  101. } catch (\Throwable $e) {
  102. $this->status = self::STATUS_UNINITIALIZED_FULL;
  103. $this->reset($instance);
  105. throw $e;
  106. }
  108. return $this->status = self::STATUS_INITIALIZED_FULL;
  109. }
  111. public function reset($instance): void
  112. {
  113. $class = $instance::class;
  114. $propertyScopes = Hydrator::$propertyScopes[$class] ??= Hydrator::getPropertyScopes($class);
  115. $skippedProperties = $this->skippedProperties;
  116. $properties = (array) $instance;
  117. $onlyProperties = \is_array($this->initializer) ? $this->initializer : null;
  119. foreach ($propertyScopes as $key => [$scope, $name, $readonlyScope]) {
  120. $propertyScopes[$k = "\0$scope\0$name"] ?? $propertyScopes[$k = "\0*\0$name"] ?? $k = $name;
  122. if ($k === $key && (null !== $readonlyScope || !\array_key_exists($k, $properties))) {
  123. $skippedProperties[$k] = true;
  124. }
  125. }
  127. foreach (LazyObjectRegistry::$classResetters[$class] as $reset) {
  128. $reset($instance, $skippedProperties, $onlyProperties);
  129. }
  131. $this->status = self::STATUS_INITIALIZED_FULL === $this->status ? self::STATUS_UNINITIALIZED_FULL : self::STATUS_UNINITIALIZED_PARTIAL;
  132. }
  133. }