lainchan/inc/lib/Twig/Loader/Filesystem.php

227 lines
5.8 KiB
PHP
Raw Normal View History

2011-10-05 00:22:53 -04:00
<?php
/*
* This file is part of Twig.
*
* (c) 2009 Fabien Potencier
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
/**
* Loads template from the filesystem.
*
2013-08-01 15:20:12 -04:00
* @author Fabien Potencier <fabien@symfony.com>
2011-10-05 00:22:53 -04:00
*/
2013-08-01 15:20:12 -04:00
class Twig_Loader_Filesystem implements Twig_LoaderInterface, Twig_ExistsLoaderInterface
2011-10-05 00:22:53 -04:00
{
2013-09-19 02:08:25 -04:00
/** Identifier of the main namespace. */
const MAIN_NAMESPACE = '__main__';
protected $paths = array();
protected $cache = array();
2011-10-05 00:22:53 -04:00
/**
* Constructor.
*
* @param string|array $paths A path or an array of paths where to look for templates
*/
2013-08-01 15:20:12 -04:00
public function __construct($paths = array())
2011-10-05 00:22:53 -04:00
{
2013-08-01 15:20:12 -04:00
if ($paths) {
$this->setPaths($paths);
}
2011-10-05 00:22:53 -04:00
}
/**
* Returns the paths to the templates.
*
2013-08-01 15:20:12 -04:00
* @param string $namespace A path namespace
*
2011-10-05 00:22:53 -04:00
* @return array The array of paths where to look for templates
*/
2013-09-19 02:08:25 -04:00
public function getPaths($namespace = self::MAIN_NAMESPACE)
2013-08-01 15:20:12 -04:00
{
return isset($this->paths[$namespace]) ? $this->paths[$namespace] : array();
}
/**
* Returns the path namespaces.
*
2013-09-19 02:08:25 -04:00
* The main namespace is always defined.
2013-08-01 15:20:12 -04:00
*
* @return array The array of defined namespaces
*/
public function getNamespaces()
2011-10-05 00:22:53 -04:00
{
2013-08-01 15:20:12 -04:00
return array_keys($this->paths);
2011-10-05 00:22:53 -04:00
}
/**
* Sets the paths where templates are stored.
*
2013-08-01 15:20:12 -04:00
* @param string|array $paths A path or an array of paths where to look for templates
* @param string $namespace A path namespace
2011-10-05 00:22:53 -04:00
*/
2013-09-19 02:08:25 -04:00
public function setPaths($paths, $namespace = self::MAIN_NAMESPACE)
2011-10-05 00:22:53 -04:00
{
if (!is_array($paths)) {
$paths = array($paths);
}
2013-08-01 15:20:12 -04:00
$this->paths[$namespace] = array();
2011-10-05 00:22:53 -04:00
foreach ($paths as $path) {
2013-08-01 15:20:12 -04:00
$this->addPath($path, $namespace);
2011-10-05 00:22:53 -04:00
}
}
/**
* Adds a path where templates are stored.
*
2013-08-01 15:20:12 -04:00
* @param string $path A path where to look for templates
* @param string $namespace A path name
*
* @throws Twig_Error_Loader
2011-10-05 00:22:53 -04:00
*/
2013-09-19 02:08:25 -04:00
public function addPath($path, $namespace = self::MAIN_NAMESPACE)
2011-10-05 00:22:53 -04:00
{
// invalidate the cache
$this->cache = array();
if (!is_dir($path)) {
throw new Twig_Error_Loader(sprintf('The "%s" directory does not exist.', $path));
}
2013-08-01 15:20:12 -04:00
$this->paths[$namespace][] = rtrim($path, '/\\');
2011-10-05 00:22:53 -04:00
}
/**
2013-08-01 15:20:12 -04:00
* Prepends a path where templates are stored.
2011-10-05 00:22:53 -04:00
*
2013-08-01 15:20:12 -04:00
* @param string $path A path where to look for templates
* @param string $namespace A path name
2011-10-05 00:22:53 -04:00
*
2013-08-01 15:20:12 -04:00
* @throws Twig_Error_Loader
*/
2013-09-19 02:08:25 -04:00
public function prependPath($path, $namespace = self::MAIN_NAMESPACE)
2013-08-01 15:20:12 -04:00
{
// invalidate the cache
$this->cache = array();
if (!is_dir($path)) {
throw new Twig_Error_Loader(sprintf('The "%s" directory does not exist.', $path));
}
$path = rtrim($path, '/\\');
if (!isset($this->paths[$namespace])) {
$this->paths[$namespace][] = $path;
} else {
array_unshift($this->paths[$namespace], $path);
}
}
/**
* {@inheritdoc}
2011-10-05 00:22:53 -04:00
*/
public function getSource($name)
{
return file_get_contents($this->findTemplate($name));
}
/**
2013-08-01 15:20:12 -04:00
* {@inheritdoc}
2011-10-05 00:22:53 -04:00
*/
public function getCacheKey($name)
{
return $this->findTemplate($name);
}
/**
2013-08-01 15:20:12 -04:00
* {@inheritdoc}
*/
public function exists($name)
{
$name = (string) $name;
if (isset($this->cache[$name])) {
return true;
}
try {
$this->findTemplate($name);
return true;
} catch (Twig_Error_Loader $exception) {
return false;
}
}
/**
* {@inheritdoc}
2011-10-05 00:22:53 -04:00
*/
public function isFresh($name, $time)
{
2013-08-01 15:20:12 -04:00
return filemtime($this->findTemplate($name)) <= $time;
2011-10-05 00:22:53 -04:00
}
protected function findTemplate($name)
{
2013-08-01 15:20:12 -04:00
$name = (string) $name;
2011-10-05 00:22:53 -04:00
// normalize name
$name = preg_replace('#/{2,}#', '/', strtr($name, '\\', '/'));
if (isset($this->cache[$name])) {
return $this->cache[$name];
}
$this->validateName($name);
2013-09-19 02:08:25 -04:00
$namespace = self::MAIN_NAMESPACE;
$shortname = $name;
2013-08-01 15:20:12 -04:00
if (isset($name[0]) && '@' == $name[0]) {
if (false === $pos = strpos($name, '/')) {
throw new Twig_Error_Loader(sprintf('Malformed namespaced template name "%s" (expecting "@namespace/template_name").', $name));
}
$namespace = substr($name, 1, $pos - 1);
2013-09-19 02:08:25 -04:00
$shortname = substr($name, $pos + 1);
2013-08-01 15:20:12 -04:00
}
if (!isset($this->paths[$namespace])) {
throw new Twig_Error_Loader(sprintf('There are no registered paths for namespace "%s".', $namespace));
}
foreach ($this->paths[$namespace] as $path) {
2013-09-19 02:08:25 -04:00
if (is_file($path.'/'.$shortname)) {
return $this->cache[$name] = $path.'/'.$shortname;
2011-10-05 00:22:53 -04:00
}
}
2013-08-01 15:20:12 -04:00
throw new Twig_Error_Loader(sprintf('Unable to find template "%s" (looked into: %s).', $name, implode(', ', $this->paths[$namespace])));
2011-10-05 00:22:53 -04:00
}
protected function validateName($name)
{
if (false !== strpos($name, "\0")) {
throw new Twig_Error_Loader('A template name cannot contain NUL bytes.');
}
2013-08-01 15:20:12 -04:00
$name = ltrim($name, '/');
2011-10-05 00:22:53 -04:00
$parts = explode('/', $name);
$level = 0;
foreach ($parts as $part) {
if ('..' === $part) {
--$level;
} elseif ('.' !== $part) {
++$level;
}
if ($level < 0) {
throw new Twig_Error_Loader(sprintf('Looks like you try to load a template outside configured directories (%s).', $name));
}
}
}
}