📁 Captain File Manager

✏️ Editing: FilesystemLoader.php

<?php

/*
 * This file is part of Twig.
 *
 * (c) Fabien Potencier
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
namespace ElementorDeps\Twig\Loader;

use ElementorDeps\Twig\Error\LoaderError;
use ElementorDeps\Twig\Source;
/**
 * Loads template from the filesystem.
 *
 * @author Fabien Potencier <fabien@symfony.com>
 */
class FilesystemLoader implements LoaderInterface
{
    /** Identifier of the main namespace. */
    public const MAIN_NAMESPACE = '__main__';
    protected $paths = [];
    protected $cache = [];
    protected $errorCache = [];
    private $rootPath;
    /**
     * @param string|array $paths    A path or an array of paths where to look for templates
     * @param string|null  $rootPath The root path common to all relative paths (null for getcwd())
     */
    public function __construct($paths = [], ?string $rootPath = null)
    {
        $this->rootPath = ($rootPath ?? \getcwd()) . \DIRECTORY_SEPARATOR;
        if (null !== $rootPath && \false !== ($realPath = \realpath($rootPath))) {
            $this->rootPath = $realPath . \DIRECTORY_SEPARATOR;
        }
        if ($paths) {
            $this->setPaths($paths);
        }
    }
    /**
     * Returns the paths to the templates.
     */
    public function getPaths(string $namespace = self::MAIN_NAMESPACE) : array
    {
        return $this->paths[$namespace] ?? [];
    }
    /**
     * Returns the path namespaces.
     *
     * The main namespace is always defined.
     */
    public function getNamespaces() : array
    {
        return \array_keys($this->paths);
    }
    /**
     * @param string|array $paths A path or an array of paths where to look for templates
     */
    public function setPaths($paths, string $namespace = self::MAIN_NAMESPACE) : void
    {
        if (!\is_array($paths)) {
            $paths = [$paths];
        }
        $this->paths[$namespace] = [];
        foreach ($paths as $path) {
            $this->addPath($path, $namespace);
        }
    }
    /**
     * @throws LoaderError
     */
    public function addPath(string $path, string $namespace = self::MAIN_NAMESPACE) : void
    {
        // invalidate the cache
        $this->cache = $this->errorCache = [];
        $checkPath = $this->isAbsolutePath($path) ? $path : $this->rootPath . $path;
        if (!\is_dir($checkPath)) {
            throw new LoaderError(\sprintf('The "%s" directory does not exist ("%s").', $path, $checkPath));
        }
        $this->paths[$namespace][] = \rtrim($path, '/\\');
    }
    /**
     * @throws LoaderError
     */
    public function prependPath(string $path, string $namespace = self::MAIN_NAMESPACE) : void
    {
        // invalidate the cache
        $this->cache = $this->errorCache = [];
        $checkPath = $this->isAbsolutePath($path) ? $path : $this->rootPath . $path;
        if (!\is_dir($checkPath)) {
            throw new LoaderError(\sprintf('The "%s" directory does not exist ("%s").', $path, $checkPath));
        }
        $path = \rtrim($path, '/\\');
        if (!isset($this->paths[$namespace])) {
            $this->paths[$namespace][] = $path;
        } else {
            \array_unshift($this->paths[$namespace], $path);
        }
    }
    public function getSourceContext(string $name) : Source
    {
        if (null === ($path = $this->findTemplate($name))) {
            return new Source('', $name, '');
        }
        return new Source(\file_get_contents($path), $name, $path);
    }
    public function getCacheKey(string $name) : string
    {
        if (null === ($path = $this->findTemplate($name))) {
            return '';
        }
        $len = \strlen($this->rootPath);
        if (0 === \strncmp($this->rootPath, $path, $len)) {
            return \substr($path, $len);
        }
        return $path;
    }
    /**
     * @return bool
     */
    public function exists(string $name)
    {
        $name = $this->normalizeName($name);
        if (isset($this->cache[$name])) {
            return \true;
        }
        return null !== $this->findTemplate($name, \false);
    }
    public function isFresh(string $name, int $time) : bool
    {
        // false support to be removed in 3.0
        if (null === ($path = $this->findTemplate($name))) {
            return \false;
        }
        return \filemtime($path) < $time;
    }
    /**
     * @return string|null
     */
    protected function findTemplate(string $name, bool $throw = \true)
    {
        $name = $this->normalizeName($name);
        if (isset($this->cache[$name])) {
            return $this->cache[$name];
        }
        if (isset($this->errorCache[$name])) {
            if (!$throw) {
                return null;
            }
            throw new LoaderError($this->errorCache[$name]);
        }
        try {
            [$namespace, $shortname] = $this->parseName($name);
            $this->validateName($shortname);
        } catch (LoaderError $e) {
            if (!$throw) {
                return null;
            }
            throw $e;
        }
        if (!isset($this->paths[$namespace])) {
            $this->errorCache[$name] = \sprintf('There are no registered paths for namespace "%s".', $namespace);
            if (!$throw) {
                return null;
            }
            throw new LoaderError($this->errorCache[$name]);
        }
        foreach ($this->paths[$namespace] as $path) {
            if (!$this->isAbsolutePath($path)) {
                $path = $this->rootPath . $path;
            }
            if (\is_file($path . '/' . $shortname)) {
                if (\false !== ($realpath = \realpath($path . '/' . $shortname))) {
                    return $this->cache[$name] = $realpath;
                }
                return $this->cache[$name] = $path . '/' . $shortname;
            }
        }
        $this->errorCache[$name] = \sprintf('Unable to find template "%s" (looked into: %s).', $name, \implode(', ', $this->paths[$namespace]));
        if (!$throw) {
            return null;
        }
        throw new LoaderError($this->errorCache[$name]);
    }
    private function normalizeName(string $name) : string
    {
        return \preg_replace('#/{2,}#', '/', \str_replace('\\', '/', $name));
    }
    private function parseName(string $name, string $default = self::MAIN_NAMESPACE) : array
    {
        if (isset($name[0]) && '@' == $name[0]) {
            if (\false === ($pos = \strpos($name, '/'))) {
                throw new LoaderError(\sprintf('Malformed namespaced template name "%s" (expecting "@namespace/template_name").', $name));
            }
            $namespace = \substr($name, 1, $pos - 1);
            $shortname = \substr($name, $pos + 1);
            return [$namespace, $shortname];
        }
        return [$default, $name];
    }
    private function validateName(string $name) : void
    {
        if (\str_contains($name, "\x00")) {
            throw new LoaderError('A template name cannot contain NUL bytes.');
        }
        $name = \ltrim($name, '/');
        $parts = \explode('/', $name);
        $level = 0;
        foreach ($parts as $part) {
            if ('..' === $part) {
                --$level;
            } elseif ('.' !== $part) {
                ++$level;
            }
            if ($level < 0) {
                throw new LoaderError(\sprintf('Looks like you try to load a template outside configured directories (%s).', $name));
            }
        }
    }
    private function isAbsolutePath(string $file) : bool
    {
        return \strspn($file, '/\\', 0, 1) || \strlen($file) > 3 && \ctype_alpha($file[0]) && ':' === $file[1] && \strspn($file, '/\\', 2, 1) || null !== \parse_url($file, \PHP_URL_SCHEME);
    }
}