vendor/symfony/config/Resource/ClassExistenceResource.php line 76

Open in your IDE?
  1. <?php
  2. /*
  3.  * This file is part of the Symfony package.
  4.  *
  5.  * (c) Fabien Potencier <fabien@symfony.com>
  6.  *
  7.  * For the full copyright and license information, please view the LICENSE
  8.  * file that was distributed with this source code.
  9.  */
  10. namespace Symfony\Component\Config\Resource;
  11. /**
  12.  * ClassExistenceResource represents a class existence.
  13.  * Freshness is only evaluated against resource existence.
  14.  *
  15.  * The resource must be a fully-qualified class name.
  16.  *
  17.  * @author Fabien Potencier <fabien@symfony.com>
  18.  *
  19.  * @final
  20.  */
  21. class ClassExistenceResource implements SelfCheckingResourceInterface
  22. {
  23.     private string $resource;
  24.     private ?array $exists null;
  25.     private static int $autoloadLevel 0;
  26.     private static ?string $autoloadedClass null;
  27.     private static array $existsCache = [];
  28.     /**
  29.      * @param string    $resource The fully-qualified class name
  30.      * @param bool|null $exists   Boolean when the existency check has already been done
  31.      */
  32.     public function __construct(string $resourcebool $exists null)
  33.     {
  34.         $this->resource $resource;
  35.         if (null !== $exists) {
  36.             $this->exists = [$existsnull];
  37.         }
  38.     }
  39.     public function __toString(): string
  40.     {
  41.         return $this->resource;
  42.     }
  43.     public function getResource(): string
  44.     {
  45.         return $this->resource;
  46.     }
  47.     /**
  48.      * @throws \ReflectionException when a parent class/interface/trait is not found
  49.      */
  50.     public function isFresh(int $timestamp): bool
  51.     {
  52.         $loaded class_exists($this->resourcefalse) || interface_exists($this->resourcefalse) || trait_exists($this->resourcefalse);
  53.         if (null !== $exists = &self::$existsCache[$this->resource]) {
  54.             if ($loaded) {
  55.                 $exists = [truenull];
  56.             } elseif (>= $timestamp && !$exists[0] && null !== $exists[1]) {
  57.                 throw new \ReflectionException($exists[1]);
  58.             }
  59.         } elseif ([falsenull] === $exists = [$loadednull]) {
  60.             if (!self::$autoloadLevel++) {
  61.                 spl_autoload_register(__CLASS__.'::throwOnRequiredClass');
  62.             }
  63.             $autoloadedClass self::$autoloadedClass;
  64.             self::$autoloadedClass ltrim($this->resource'\\');
  65.             try {
  66.                 $exists[0] = class_exists($this->resource) || interface_exists($this->resourcefalse) || trait_exists($this->resourcefalse);
  67.             } catch (\Exception $e) {
  68.                 $exists[1] = $e->getMessage();
  69.                 try {
  70.                     self::throwOnRequiredClass($this->resource$e);
  71.                 } catch (\ReflectionException $e) {
  72.                     if (>= $timestamp) {
  73.                         throw $e;
  74.                     }
  75.                 }
  76.             } catch (\Throwable $e) {
  77.                 $exists[1] = $e->getMessage();
  78.                 throw $e;
  79.             } finally {
  80.                 self::$autoloadedClass $autoloadedClass;
  81.                 if (!--self::$autoloadLevel) {
  82.                     spl_autoload_unregister(__CLASS__.'::throwOnRequiredClass');
  83.                 }
  84.             }
  85.         }
  86.         if (null === $this->exists) {
  87.             $this->exists $exists;
  88.         }
  89.         return $this->exists[0] xor !$exists[0];
  90.     }
  91.     /**
  92.      * @internal
  93.      */
  94.     public function __sleep(): array
  95.     {
  96.         if (null === $this->exists) {
  97.             $this->isFresh(0);
  98.         }
  99.         return ['resource''exists'];
  100.     }
  101.     /**
  102.      * @internal
  103.      */
  104.     public function __wakeup()
  105.     {
  106.         if (\is_bool($this->exists)) {
  107.             $this->exists = [$this->existsnull];
  108.         }
  109.     }
  110.     /**
  111.      * Throws a reflection exception when the passed class does not exist but is required.
  112.      *
  113.      * A class is considered "not required" when it's loaded as part of a "class_exists" or similar check.
  114.      *
  115.      * This function can be used as an autoload function to throw a reflection
  116.      * exception if the class was not found by previous autoload functions.
  117.      *
  118.      * A previous exception can be passed. In this case, the class is considered as being
  119.      * required totally, so if it doesn't exist, a reflection exception is always thrown.
  120.      * If it exists, the previous exception is rethrown.
  121.      *
  122.      * @throws \ReflectionException
  123.      *
  124.      * @internal
  125.      */
  126.     public static function throwOnRequiredClass(string $class\Exception $previous null)
  127.     {
  128.         // If the passed class is the resource being checked, we shouldn't throw.
  129.         if (null === $previous && self::$autoloadedClass === $class) {
  130.             return;
  131.         }
  132.         if (class_exists($classfalse) || interface_exists($classfalse) || trait_exists($classfalse)) {
  133.             if (null !== $previous) {
  134.                 throw $previous;
  135.             }
  136.             return;
  137.         }
  138.         if ($previous instanceof \ReflectionException) {
  139.             throw $previous;
  140.         }
  141.         $message sprintf('Class "%s" not found.'$class);
  142.         if (self::$autoloadedClass !== $class) {
  143.             $message substr_replace($messagesprintf(' while loading "%s"'self::$autoloadedClass), -10);
  144.         }
  145.         if (null !== $previous) {
  146.             $message $previous->getMessage();
  147.         }
  148.         $e = new \ReflectionException($message0$previous);
  149.         if (null !== $previous) {
  150.             throw $e;
  151.         }
  152.         $trace debug_backtrace();
  153.         $autoloadFrame = [
  154.             'function' => 'spl_autoload_call',
  155.             'args' => [$class],
  156.         ];
  157.         if (isset($trace[1])) {
  158.             $callerFrame $trace[1];
  159.             $i 2;
  160.         } elseif (false !== $i array_search($autoloadFrame$tracetrue)) {
  161.             $callerFrame $trace[++$i];
  162.         } else {
  163.             throw $e;
  164.         }
  165.         if (isset($callerFrame['function']) && !isset($callerFrame['class'])) {
  166.             switch ($callerFrame['function']) {
  167.                 case 'get_class_methods':
  168.                 case 'get_class_vars':
  169.                 case 'get_parent_class':
  170.                 case 'is_a':
  171.                 case 'is_subclass_of':
  172.                 case 'class_exists':
  173.                 case 'class_implements':
  174.                 case 'class_parents':
  175.                 case 'trait_exists':
  176.                 case 'defined':
  177.                 case 'interface_exists':
  178.                 case 'method_exists':
  179.                 case 'property_exists':
  180.                 case 'is_callable':
  181.                     return;
  182.             }
  183.             $props = [
  184.                 'file' => $callerFrame['file'] ?? null,
  185.                 'line' => $callerFrame['line'] ?? null,
  186.                 'trace' => \array_slice($trace$i),
  187.             ];
  188.             foreach ($props as $p => $v) {
  189.                 if (null !== $v) {
  190.                     $r = new \ReflectionProperty(\Exception::class, $p);
  191.                     $r->setValue($e$v);
  192.                 }
  193.             }
  194.         }
  195.         throw $e;
  196.     }
  197. }