vendor/symfony/config/FileLocator.php line 36

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;
  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($paths = [])
  29.     {
  30.         $this->paths = (array) $paths;
  31.     }
  33.     /**
  34.      * {@inheritdoc}
  35.      */
  36.     public function locate(string $name, string $currentPath = null, bool $first = true)
  37.     {
  38.         if ('' === $name) {
  39.             throw new \InvalidArgumentException('An empty file name is not valid to be located.');
  40.         }
  42.         if ($this->isAbsolutePath($name)) {
  43.             if (!file_exists($name)) {
  44.                 throw new FileLocatorFileNotFoundException(sprintf('The file "%s" does not exist.', $name), 0, null, [$name]);
  45.             }
  47.             return $name;
  48.         }
  50.         $paths = $this->paths;
  52.         if (null !== $currentPath) {
  53.             array_unshift($paths, $currentPath);
  54.         }
  56.         $paths = array_unique($paths);
  57.         $filepaths = $notfound = [];
  59.         foreach ($paths as $path) {
  60.             if (@file_exists($file = $path.\DIRECTORY_SEPARATOR.$name)) {
  61.                 if (true === $first) {
  62.                     return $file;
  63.                 }
  64.                 $filepaths[] = $file;
  65.             } else {
  66.                 $notfound[] = $file;
  67.             }
  68.         }
  70.         if (!$filepaths) {
  71.             throw new FileLocatorFileNotFoundException(sprintf('The file "%s" does not exist (in: "%s").', $name, implode('", "', $paths)), 0, null, $notfound);
  72.         }
  74.         return $filepaths;
  75.     }
  77.     /**
  78.      * Returns whether the file path is an absolute path.
  79.      */
  80.     private function isAbsolutePath(string $file): bool
  81.     {
  82.         if ('/' === $file[0] || '\\' === $file[0]
  83.             || (\strlen($file) > 3 && ctype_alpha($file[0])
  84.                 && ':' === $file[1]
  85.                 && ('\\' === $file[2] || '/' === $file[2])
  86.             )
  87.             || null !== parse_url($file, \PHP_URL_SCHEME)
  88.         ) {
  89.             return true;
  90.         }
  92.         return false;
  93.     }
  94. }