vendor/symfony/config/Resource/DirectoryResource.php line 32

  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\Config\Resource;
  14. /**
  15.  * DirectoryResource represents a resources stored in a subdirectory tree.
  16.  *
  17.  * @author Fabien Potencier <fabien@symfony.com>
  18.  *
  19.  * @final
  20.  */
  21. class DirectoryResource implements SelfCheckingResourceInterface
  22. {
  23.     private string $resource;
  24.     private ?string $pattern;
  26.     /**
  27.      * @param string      $resource The file path to the resource
  28.      * @param string|null $pattern  A pattern to restrict monitored files
  29.      *
  30.      * @throws \InvalidArgumentException
  31.      */
  32.     public function __construct(string $resource, string $pattern = null)
  33.     {
  34.         $resolvedResource = realpath($resource) ?: (file_exists($resource) ? $resource : false);
  35.         $this->pattern = $pattern;
  37.         if (false === $resolvedResource || !is_dir($resolvedResource)) {
  38.             throw new \InvalidArgumentException(sprintf('The directory "%s" does not exist.', $resource));
  39.         }
  41.         $this->resource = $resolvedResource;
  42.     }
  44.     public function __toString(): string
  45.     {
  46.         return md5(serialize([$this->resource, $this->pattern]));
  47.     }
  49.     public function getResource(): string
  50.     {
  51.         return $this->resource;
  52.     }
  54.     public function getPattern(): ?string
  55.     {
  56.         return $this->pattern;
  57.     }
  59.     public function isFresh(int $timestamp): bool
  60.     {
  61.         if (!is_dir($this->resource)) {
  62.             return false;
  63.         }
  65.         if ($timestamp < filemtime($this->resource)) {
  66.             return false;
  67.         }
  69.         foreach (new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($this->resource), \RecursiveIteratorIterator::SELF_FIRST) as $file) {
  70.             // if regex filtering is enabled only check matching files
  71.             if ($this->pattern && $file->isFile() && !preg_match($this->pattern, $file->getBasename())) {
  72.                 continue;
  73.             }
  75.             // always monitor directories for changes, except the .. entries
  76.             // (otherwise deleted files wouldn't get detected)
  77.             if ($file->isDir() && str_ends_with($file, '/..')) {
  78.                 continue;
  79.             }
  81.             // for broken links
  82.             try {
  83.                 $fileMTime = $file->getMTime();
  84.             } catch (\RuntimeException) {
  85.                 continue;
  86.             }
  88.             // early return if a file's mtime exceeds the passed timestamp
  89.             if ($timestamp < $fileMTime) {
  90.                 return false;
  91.             }
  92.         }
  94.         return true;
  95.     }
  96. }