vendor/symfony/config/FileLocator.php line 33

  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;
  14. use Symfony\Component\Config\Exception\FileLocatorFileNotFoundException;
  16. /**
  17.  * FileLocator uses an array of pre-defined paths to find files.
  18.  *
  19.  * @author Fabien Potencier <fabien@symfony.com>
  20.  */
  21. class FileLocator implements FileLocatorInterface
  22. {
  23.     protected $paths;
  25.     /**
  26.      * @param string|string[] $paths A path or an array of paths where to look for resources
  27.      */
  28.     public function __construct(string|array $paths = [])
  29.     {
  30.         $this->paths = (array) $paths;
  31.     }
  33.     public function locate(string $name, string $currentPath = null, bool $first = true)
  34.     {
  35.         if ('' === $name) {
  36.             throw new \InvalidArgumentException('An empty file name is not valid to be located.');
  37.         }
  39.         if ($this->isAbsolutePath($name)) {
  40.             if (!file_exists($name)) {
  41.                 throw new FileLocatorFileNotFoundException(sprintf('The file "%s" does not exist.', $name), 0, null, [$name]);
  42.             }
  44.             return $name;
  45.         }
  47.         $paths = $this->paths;
  49.         if (null !== $currentPath) {
  50.             array_unshift($paths, $currentPath);
  51.         }
  53.         $paths = array_unique($paths);
  54.         $filepaths = $notfound = [];
  56.         foreach ($paths as $path) {
  57.             if (@file_exists($file = $path.\DIRECTORY_SEPARATOR.$name)) {
  58.                 if (true === $first) {
  59.                     return $file;
  60.                 }
  61.                 $filepaths[] = $file;
  62.             } else {
  63.                 $notfound[] = $file;
  64.             }
  65.         }
  67.         if (!$filepaths) {
  68.             throw new FileLocatorFileNotFoundException(sprintf('The file "%s" does not exist (in: "%s").', $name, implode('", "', $paths)), 0, null, $notfound);
  69.         }
  71.         return $filepaths;
  72.     }
  74.     /**
  75.      * Returns whether the file path is an absolute path.
  76.      */
  77.     private function isAbsolutePath(string $file): bool
  78.     {
  79.         if ('/' === $file[0] || '\\' === $file[0]
  80.             || (\strlen($file) > 3 && ctype_alpha($file[0])
  81.                 && ':' === $file[1]
  82.                 && ('\\' === $file[2] || '/' === $file[2])
  83.             )
  84.             || null !== parse_url($file, \PHP_URL_SCHEME)
  85.         ) {
  86.             return true;
  87.         }
  89.         return false;
  90.     }
  91. }