185 lines
6.3 KiB
PHP
185 lines
6.3 KiB
PHP
<?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\Loader;
|
|
|
|
use Symfony\Component\Config\Exception\FileLoaderImportCircularReferenceException;
|
|
use Symfony\Component\Config\Exception\FileLocatorFileNotFoundException;
|
|
use Symfony\Component\Config\Exception\LoaderLoadException;
|
|
use Symfony\Component\Config\FileLocatorInterface;
|
|
use Symfony\Component\Config\Resource\FileExistenceResource;
|
|
use Symfony\Component\Config\Resource\GlobResource;
|
|
|
|
/**
|
|
* FileLoader is the abstract class used by all built-in loaders that are file based.
|
|
*
|
|
* @author Fabien Potencier <fabien@symfony.com>
|
|
*/
|
|
abstract class FileLoader extends Loader
|
|
{
|
|
protected static array $loading = [];
|
|
|
|
protected FileLocatorInterface $locator;
|
|
|
|
private ?string $currentDir = null;
|
|
|
|
public function __construct(FileLocatorInterface $locator, ?string $env = null)
|
|
{
|
|
$this->locator = $locator;
|
|
parent::__construct($env);
|
|
}
|
|
|
|
/**
|
|
* Sets the current directory.
|
|
*/
|
|
public function setCurrentDir(string $dir): void
|
|
{
|
|
$this->currentDir = $dir;
|
|
}
|
|
|
|
/**
|
|
* Returns the file locator used by this loader.
|
|
*/
|
|
public function getLocator(): FileLocatorInterface
|
|
{
|
|
return $this->locator;
|
|
}
|
|
|
|
/**
|
|
* Imports a resource.
|
|
*
|
|
* @param mixed $resource A Resource
|
|
* @param string|null $type The resource type or null if unknown
|
|
* @param bool $ignoreErrors Whether to ignore import errors or not
|
|
* @param string|null $sourceResource The original resource importing the new resource
|
|
* @param string|string[]|null $exclude Glob patterns to exclude from the import
|
|
*
|
|
* @throws LoaderLoadException
|
|
* @throws FileLoaderImportCircularReferenceException
|
|
* @throws FileLocatorFileNotFoundException
|
|
*/
|
|
public function import(mixed $resource, ?string $type = null, bool $ignoreErrors = false, ?string $sourceResource = null, string|array|null $exclude = null): mixed
|
|
{
|
|
if (\is_string($resource) && \strlen($resource) !== ($i = strcspn($resource, '*?{[')) && !str_contains($resource, "\n")) {
|
|
$excluded = [];
|
|
foreach ((array) $exclude as $pattern) {
|
|
foreach ($this->glob($pattern, true, $_, false, true) as $path => $info) {
|
|
// normalize Windows slashes and remove trailing slashes
|
|
$excluded[rtrim(str_replace('\\', '/', $path), '/')] = true;
|
|
}
|
|
}
|
|
|
|
$ret = [];
|
|
$isSubpath = 0 !== $i && str_contains(substr($resource, 0, $i), '/');
|
|
foreach ($this->glob($resource, false, $_, $ignoreErrors || !$isSubpath, false, $excluded) as $path => $info) {
|
|
if (null !== $res = $this->doImport($path, 'glob' === $type ? null : $type, $ignoreErrors, $sourceResource)) {
|
|
$ret[] = $res;
|
|
}
|
|
$isSubpath = true;
|
|
}
|
|
|
|
if ($isSubpath) {
|
|
return isset($ret[1]) ? $ret : ($ret[0] ?? null);
|
|
}
|
|
}
|
|
|
|
return $this->doImport($resource, $type, $ignoreErrors, $sourceResource);
|
|
}
|
|
|
|
/**
|
|
* @internal
|
|
*/
|
|
protected function glob(string $pattern, bool $recursive, array|GlobResource|null &$resource = null, bool $ignoreErrors = false, bool $forExclusion = false, array $excluded = []): iterable
|
|
{
|
|
if (\strlen($pattern) === $i = strcspn($pattern, '*?{[')) {
|
|
$prefix = $pattern;
|
|
$pattern = '';
|
|
} elseif (0 === $i || !str_contains(substr($pattern, 0, $i), '/')) {
|
|
$prefix = '.';
|
|
$pattern = '/'.$pattern;
|
|
} else {
|
|
$prefix = \dirname(substr($pattern, 0, 1 + $i));
|
|
$pattern = substr($pattern, \strlen($prefix));
|
|
}
|
|
|
|
try {
|
|
$prefix = $this->locator->locate($prefix, $this->currentDir, true);
|
|
} catch (FileLocatorFileNotFoundException $e) {
|
|
if (!$ignoreErrors) {
|
|
throw $e;
|
|
}
|
|
|
|
$resource = [];
|
|
foreach ($e->getPaths() as $path) {
|
|
$resource[] = new FileExistenceResource($path);
|
|
}
|
|
|
|
return;
|
|
}
|
|
$resource = new GlobResource($prefix, $pattern, $recursive, $forExclusion, $excluded);
|
|
|
|
yield from $resource;
|
|
}
|
|
|
|
private function doImport(mixed $resource, ?string $type = null, bool $ignoreErrors = false, ?string $sourceResource = null): mixed
|
|
{
|
|
try {
|
|
$loader = $this->resolve($resource, $type);
|
|
|
|
if ($loader instanceof DirectoryAwareLoaderInterface) {
|
|
$loader = $loader->forDirectory($this->currentDir);
|
|
}
|
|
|
|
if (!$loader instanceof self) {
|
|
return $loader->load($resource, $type);
|
|
}
|
|
|
|
if (null !== $this->currentDir) {
|
|
$resource = $loader->getLocator()->locate($resource, $this->currentDir, false);
|
|
}
|
|
|
|
$resources = \is_array($resource) ? $resource : [$resource];
|
|
for ($i = 0; $i < $resourcesCount = \count($resources); ++$i) {
|
|
if (isset(self::$loading[$resources[$i]])) {
|
|
if ($i == $resourcesCount - 1) {
|
|
throw new FileLoaderImportCircularReferenceException(array_keys(self::$loading));
|
|
}
|
|
} else {
|
|
$resource = $resources[$i];
|
|
break;
|
|
}
|
|
}
|
|
self::$loading[$resource] = true;
|
|
|
|
try {
|
|
$ret = $loader->load($resource, $type);
|
|
} finally {
|
|
unset(self::$loading[$resource]);
|
|
}
|
|
|
|
return $ret;
|
|
} catch (FileLoaderImportCircularReferenceException $e) {
|
|
throw $e;
|
|
} catch (\Exception $e) {
|
|
if (!$ignoreErrors) {
|
|
// prevent embedded imports from nesting multiple exceptions
|
|
if ($e instanceof LoaderLoadException) {
|
|
throw $e;
|
|
}
|
|
|
|
throw new LoaderLoadException($resource, $sourceResource, 0, $e, $type);
|
|
}
|
|
}
|
|
|
|
return null;
|
|
}
|
|
}
|