: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in
* This file is part of Twig.
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
namespace WPML\Core\Twig\Loader;
use WPML\Core\Twig\Error\LoaderError;
use WPML\Core\Twig\Source;
* Loads template from the filesystem.
* @author Fabien Potencier <fabien@symfony.com>
class FilesystemLoader implements \WPML\Core\Twig\Loader\LoaderInterface, \WPML\Core\Twig\Loader\ExistsLoaderInterface, \WPML\Core\Twig\Loader\SourceContextLoaderInterface
/** Identifier of the main namespace. */
const MAIN_NAMESPACE = '__main__';
protected $errorCache = [];
* @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 = [], $rootPath = null)
$this->rootPath = (null === $rootPath ? \getcwd() : $rootPath) . \DIRECTORY_SEPARATOR;
if (\false !== ($realPath = \realpath($rootPath))) {
$this->rootPath = $realPath . \DIRECTORY_SEPARATOR;
* Returns the paths to the templates.
* @param string $namespace A path namespace
* @return array The array of paths where to look for templates
public function getPaths($namespace = self::MAIN_NAMESPACE)
return isset($this->paths[$namespace]) ? $this->paths[$namespace] : [];
* Returns the path namespaces.
* The main namespace is always defined.
* @return array The array of defined namespaces
public function getNamespaces()
return \array_keys($this->paths);
* Sets the paths where templates are stored.
* @param string|array $paths A path or an array of paths where to look for templates
* @param string $namespace A path namespace
public function setPaths($paths, $namespace = self::MAIN_NAMESPACE)
if (!\is_array($paths)) {
$this->paths[$namespace] = [];
foreach ($paths as $path) {
$this->addPath($path, $namespace);
* Adds a path where templates are stored.
* @param string $path A path where to look for templates
* @param string $namespace A path namespace
public function addPath($path, $namespace = self::MAIN_NAMESPACE)
$this->cache = $this->errorCache = [];
$checkPath = $this->isAbsolutePath($path) ? $path : $this->rootPath . $path;
if (!\is_dir($checkPath)) {
throw new \WPML\Core\Twig\Error\LoaderError(\sprintf('The "%s" directory does not exist ("%s").', $path, $checkPath));
$this->paths[$namespace][] = \rtrim($path, '/\\');
* Prepends a path where templates are stored.
* @param string $path A path where to look for templates
* @param string $namespace A path namespace
public function prependPath($path, $namespace = self::MAIN_NAMESPACE)
$this->cache = $this->errorCache = [];
$checkPath = $this->isAbsolutePath($path) ? $path : $this->rootPath . $path;
if (!\is_dir($checkPath)) {
throw new \WPML\Core\Twig\Error\LoaderError(\sprintf('The "%s" directory does not exist ("%s").', $path, $checkPath));
$path = \rtrim($path, '/\\');
if (!isset($this->paths[$namespace])) {
$this->paths[$namespace][] = $path;
\array_unshift($this->paths[$namespace], $path);
public function getSource($name)
@\trigger_error(\sprintf('Calling "getSource" on "%s" is deprecated since 1.27. Use getSourceContext() instead.', \get_class($this)), \E_USER_DEPRECATED);
if (null === ($path = $this->findTemplate($name)) || \false === $path) {
return \file_get_contents($path);
public function getSourceContext($name)
if (null === ($path = $this->findTemplate($name)) || \false === $path) {
return new \WPML\Core\Twig\Source('', $name, '');
return new \WPML\Core\Twig\Source(\file_get_contents($path), $name, $path);
public function getCacheKey($name)
if (null === ($path = $this->findTemplate($name)) || \false === $path) {
$len = \strlen($this->rootPath);
if (0 === \strncmp($this->rootPath, $path, $len)) {
return \substr($path, $len);
public function exists($name)
$name = $this->normalizeName($name);
if (isset($this->cache[$name])) {
return null !== ($path = $this->findTemplate($name, \false)) && \false !== $path;
} catch (\WPML\Core\Twig\Error\LoaderError $e) {
@\trigger_error(\sprintf('In %s::findTemplate(), you must accept a second argument that when set to "false" returns "false" instead of throwing an exception. Not supporting this argument is deprecated since version 1.27.', \get_class($this)), \E_USER_DEPRECATED);
public function isFresh($name, $time)
// false support to be removed in 3.0
if (null === ($path = $this->findTemplate($name)) || \false === $path) {
return \filemtime($path) < $time;
* Checks if the template can be found.
* @param string $name The template name
* @return string|false|null The template name or false/null
protected function findTemplate($name)
$throw = \func_num_args() > 1 ? \func_get_arg(1) : \true;
$name = $this->normalizeName($name);
if (isset($this->cache[$name])) {
return $this->cache[$name];
if (isset($this->errorCache[$name])) {
throw new \WPML\Core\Twig\Error\LoaderError($this->errorCache[$name]);
$this->validateName($name);
list($namespace, $shortname) = $this->parseName($name);
} catch (\WPML\Core\Twig\Error\LoaderError $e) {
if (!isset($this->paths[$namespace])) {
$this->errorCache[$name] = \sprintf('There are no registered paths for namespace "%s".', $namespace);
throw new \WPML\Core\Twig\Error\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]));
throw new \WPML\Core\Twig\Error\LoaderError($this->errorCache[$name]);
protected function parseName($name, $default = self::MAIN_NAMESPACE)
if (isset($name[0]) && '@' == $name[0]) {
if (\false === ($pos = \strpos($name, '/'))) {
throw new \WPML\Core\Twig\Error\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];
protected function normalizeName($name)
return \preg_replace('#/{2,}#', '/', \str_replace('\\', '/', (string) $name));
protected function validateName($name)
if (\false !== \strpos($name, "\0")) {
throw new \WPML\Core\Twig\Error\LoaderError('A template name cannot contain NUL bytes.');
$name = \ltrim($name, '/');
$parts = \explode('/', $name);
foreach ($parts as $part) {
} elseif ('.' !== $part) {
throw new \WPML\Core\Twig\Error\LoaderError(\sprintf('Looks like you try to load a template outside configured directories (%s).', $name));
private function isAbsolutePath($file)
return \strspn($file, '/\\', 0, 1) || \strlen($file) > 3 && \ctype_alpha($file[0]) && ':' === \substr($file, 1, 1) && \strspn($file, '/\\', 2, 1) || null !== \parse_url($file, \PHP_URL_SCHEME);
\class_alias('WPML\\Core\\Twig\\Loader\\FilesystemLoader', 'WPML\\Core\\Twig_Loader_Filesystem');
It is recommended that you Edit text format, this type of Fix handles quite a lot in one request
