Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
Builder	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Definition	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Exception	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Loader	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Resource	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Util	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
.htaccess	237 B	-r-xr-xr-x	2026-08-17 03:12
CHANGELOG.md	4.6 KB	-rwxrwxr-x	2026-02-24 17:34
ConfigCache.php	1.49 KB	-rwxrwxr-x	2026-02-24 17:34
ConfigCacheFactory.php	1.07 KB	-rwxrwxr-x	2026-02-24 17:34
ConfigCacheFactoryInterface.php	937 B	-rwxrwxr-x	2026-02-24 17:34
ConfigCacheInterface.php	1.24 KB	-rwxrwxr-x	2026-02-24 17:34
FileLocator.php	2.68 KB	-rwxrwxr-x	2026-02-24 17:34
FileLocatorInterface.php	1.1 KB	-rwxrwxr-x	2026-02-24 17:34
LICENSE	1.04 KB	-rwxrwxr-x	2026-02-24 17:34
README.md	596 B	-rwxrwxr-x	2026-02-24 17:34
ResourceCheckerConfigCache.php	5.49 KB	-rwxrwxr-x	2026-02-24 17:34
ResourceCheckerConfigCacheFactory.php	1.04 KB	-rwxrwxr-x	2026-02-24 17:34
ResourceCheckerInterface.php	1.2 KB	-rwxrwxr-x	2026-02-24 17:34
composer.json	1.2 KB	-rwxrwxr-x	2026-02-24 17:34

Rename

<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <fabien@symfony.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Symfony\Component\Config;

use Symfony\Component\Config\Exception\FileLocatorFileNotFoundException;

/**
 * FileLocator uses an array of pre-defined paths to find files.
 *
 * @author Fabien Potencier <fabien@symfony.com>
 */
class FileLocator implements FileLocatorInterface
{
    protected $paths;

/**
     * @param string|string[] $paths A path or an array of paths where to look for resources
     */
    public function __construct(string|array $paths = [])
    {
        $this->paths = (array) $paths;
    }

/**
     * @return string|string[]
     *
     * @psalm-return ($first is true ? string : string[])
     */
    public function locate(string $name, ?string $currentPath = null, bool $first = true)
    {
        if ('' === $name) {
            throw new \InvalidArgumentException('An empty file name is not valid to be located.');
        }

if ($this->isAbsolutePath($name)) {
            if (!file_exists($name)) {
                throw new FileLocatorFileNotFoundException(\sprintf('The file "%s" does not exist.', $name), 0, null, [$name]);
            }

return $name;
        }

$paths = $this->paths;

if (null !== $currentPath) {
            array_unshift($paths, $currentPath);
        }

$paths = array_unique($paths);
        $filepaths = $notfound = [];

foreach ($paths as $path) {
            if (@file_exists($file = $path.\DIRECTORY_SEPARATOR.$name)) {
                if (true === $first) {
                    return $file;
                }
                $filepaths[] = $file;
            } else {
                $notfound[] = $file;
            }
        }

if (!$filepaths) {
            throw new FileLocatorFileNotFoundException(\sprintf('The file "%s" does not exist (in: "%s").', $name, implode('", "', $paths)), 0, null, $notfound);
        }

return $filepaths;
    }

/**
     * Returns whether the file path is an absolute path.
     */
    private function isAbsolutePath(string $file): bool
    {
        if ('/' === $file[0] || '\\' === $file[0]
            || (\strlen($file) > 3 && ctype_alpha($file[0])
                && ':' === $file[1]
                && ('\\' === $file[2] || '/' === $file[2])
            )
            || parse_url($file, \PHP_URL_SCHEME)
            || str_starts_with($file, 'phar:///') // "parse_url()" doesn't handle absolute phar path, despite being valid
        ) {
            return true;
        }

return false;
    }
}