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

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\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 $resource;
  24.     private $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.         $this->resource = realpath($resource) ?: (file_exists($resource) ? $resource : false);
  35.         $this->pattern = $pattern;
  37.         if (false === $this->resource || !is_dir($this->resource)) {
  38.             throw new \InvalidArgumentException(sprintf('The directory "%s" does not exist.', $resource));
  39.         }
  40.     }
  42.     public function __toString(): string
  43.     {
  44.         return md5(serialize([$this->resource, $this->pattern]));
  45.     }
  47.     public function getResource(): string
  48.     {
  49.         return $this->resource;
  50.     }
  52.     public function getPattern(): ?string
  53.     {
  54.         return $this->pattern;
  55.     }
  57.     /**
  58.      * {@inheritdoc}
  59.      */
  60.     public function isFresh(int $timestamp): bool
  61.     {
  62.         if (!is_dir($this->resource)) {
  63.             return false;
  64.         }
  66.         if ($timestamp < filemtime($this->resource)) {
  67.             return false;
  68.         }
  70.         foreach (new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($this->resource), \RecursiveIteratorIterator::SELF_FIRST) as $file) {
  71.             // if regex filtering is enabled only check matching files
  72.             if ($this->pattern && $file->isFile() && !preg_match($this->pattern, $file->getBasename())) {
  73.                 continue;
  74.             }
  76.             // always monitor directories for changes, except the .. entries
  77.             // (otherwise deleted files wouldn't get detected)
  78.             if ($file->isDir() && str_ends_with($file, '/..')) {
  79.                 continue;
  80.             }
  82.             // for broken links
  83.             try {
  84.                 $fileMTime = $file->getMTime();
  85.             } catch (\RuntimeException $e) {
  86.                 continue;
  87.             }
  89.             // early return if a file's mtime exceeds the passed timestamp
  90.             if ($timestamp < $fileMTime) {
  91.                 return false;
  92.             }
  93.         }
  95.         return true;
  96.     }
  97. }