ViewRenderer.php 6.46 KB
Newer Older
1 2 3 4 5 6 7 8 9
<?php
/**
 * Twig view renderer class file.
 *
 * @link http://www.yiiframework.com/
 * @copyright Copyright &copy; 2008 Yii Software LLC
 * @license http://www.yiiframework.com/license/
 */

Qiang Xue committed
10
namespace yii\twig;
11

Qiang Xue committed
12 13
use Yii;
use yii\base\View;
14
use yii\base\ViewRenderer as BaseViewRenderer;
15
use yii\helpers\Html;
16 17 18 19

/**
 * TwigViewRenderer allows you to use Twig templates in views.
 *
20 21
 * @property array $lexerOptions @see self::$lexerOptions. This property is write-only.
 *
22 23 24
 * @author Alexander Makarov <sam@rmcreative.ru>
 * @since 2.0
 */
25
class ViewRenderer extends BaseViewRenderer
26
{
27
	/**
Qiang Xue committed
28
	 * @var string the directory or path alias pointing to where Twig cache will be stored.
29
	 */
30
	public $cachePath = '@runtime/Twig/cache';
31
	/**
32
	 * @var array Twig options.
33 34
	 * @see http://twig.sensiolabs.org/doc/api.html#environment-options
	 */
Alexander Makarov committed
35
	public $options = [];
36
    /**
37 38 39 40
     * @var array Objects or static classes.
     * Keys of the array are names to call in template, values are objects or names of static classes.
     * Example: `['html' => '\yii\helpers\Html']`.
     * In the template you can use it like this: `{{ html.a('Login', 'site/login') | raw }}`.
41
     */
dev-meghraj committed
42
    public $globals = [];
43
    /**
44 45 46 47
     * @var array Custom functions.
     * Keys of the array are names to call in template, values are names of functions or static methods of some class.
     * Example: `['rot13' => 'str_rot13', 'a' => '\yii\helpers\Html::a']`.
     * In the template you can use it like this: `{{ rot13('test') }}` or `{{ a('Login', 'site/login') | raw }}`.
48
     */
dev-meghraj committed
49
    public $functions = [];
50
    /**
51 52 53 54
     * @var array Custom filters.
     * Keys of the array are names to call in template, values are names of functions or static methods of some class.
     * Example: `['rot13' => 'str_rot13', 'jsonEncode' => '\yii\helpers\Json::encode']`.
     * In the template you can use it like this: `{{ 'test'|rot13 }}` or `{{ model|jsonEncode }}`.
55
     */
dev-meghraj committed
56
    public $filters = [];
57
    /**
58 59
     * @var array Custom extensions.
     * Example: `['Twig_Extension_Sandbox', 'Twig_Extension_Text']`
60
     */
dev-meghraj committed
61
    public $extensions = [];
62
    /**
63 64 65 66
     * @var array Twig lexer options.
     * Example: Smarty-like syntax:
     * ```php
     * [
67 68 69
     *     'tag_comment'  => ['{*', '*}'],
     *     'tag_block'    => ['{', '}'],
     *     'tag_variable' => ['{$', '}']
70 71 72
     * ]
     * ```
     * @see http://twig.sensiolabs.org/doc/recipes.html#customizing-the-syntax
73
     */
dev-meghraj committed
74
    public $lexerOptions = [];
75
    /**
dev-meghraj committed
76
	 * @var \Twig_Environment twig environment object that do all rendering twig templates
77
	 */
Qiang Xue committed
78
	public $twig;
79

80

81 82
	public function init()
	{
83
		$this->twig = new \Twig_Environment(null, array_merge([
Qiang Xue committed
84
			'cache' => Yii::getAlias($this->cachePath),
dev-meghraj committed
85
			'charset' => Yii::$app->charset,
Alexander Makarov committed
86
		], $this->options));
87

dev-meghraj committed
88
		// Adding custom extensions
89 90 91 92 93
		if (!empty($this->extensions)) {
			foreach ($this->extensions as $extension) {
				$this->twig->addExtension(new $extension());
			}
		}
dev-meghraj committed
94 95 96 97 98

		// Adding custom globals (objects or static classes)
		if (!empty($this->globals)) {
			$this->addGlobals($this->globals);
		}
99

dev-meghraj committed
100 101 102 103
		// Adding custom functions
		if (!empty($this->functions)) {
			$this->addFunctions($this->functions);
		}
104

dev-meghraj committed
105 106 107 108
		// Adding custom filters
		if (!empty($this->filters)) {
			$this->addFilters($this->filters);
		}
109

dev-meghraj committed
110 111 112 113
		// Adding custom extensions
		if (!empty($this->extensions)) {
			$this->addExtensions($this->extensions);
		}
114

dev-meghraj committed
115 116 117 118 119 120 121
		// Change lexer syntax
		if (!empty($this->lexerOptions)) {
			$this->setLexerOptions($this->lexerOptions);
		}

		// Adding global 'void' function (usage: {{void(App.clientScript.registerScriptFile(...))}})
		$this->twig->addFunction('void', new \Twig_Function_Function(function($argument){
122
		}));
123

Alexander Makarov committed
124 125
		$this->twig->addFunction('path', new \Twig_Function_Function(function ($path, $args = []) {
			return Html::url(array_merge([$path], $args));
126 127 128
		}));

		$this->twig->addGlobal('app', \Yii::$app);
129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144
	}

	/**
	 * Renders a view file.
	 *
	 * This method is invoked by [[View]] whenever it tries to render a view.
	 * Child classes must implement this method to render the given view file.
	 *
	 * @param View $view the view object used for rendering the file.
	 * @param string $file the view file.
	 * @param array $params the parameters to be passed to the view file.
	 *
	 * @return string the rendering result
	 */
	public function render($view, $file, $params)
	{
145
		$this->twig->addGlobal('this', $view);
dev-meghraj committed
146
		$this->twig->setLoader(new TwigSimpleFileLoader(dirname($file)));
147
		return $this->twig->render(pathinfo($file, PATHINFO_BASENAME), $params);
148
	}
149

dev-meghraj committed
150
	/**
151 152
	 * Adds global objects or static classes
	 * @param array $globals @see self::$globals
dev-meghraj committed
153
	 */
154 155
	public function addGlobals($globals)
	{
dev-meghraj committed
156 157 158 159 160 161
		foreach ($globals as $name => $value) {
			if (!is_object($value)) {
				$value = new ViewRendererStaticClassProxy($value);
			}
			$this->twig->addGlobal($name, $value);
		}
162
	}
163

dev-meghraj committed
164 165 166 167
	/**
 	 * Adds custom functions
	 * @param array $functions @see self::$functions
	 */
168 169
	public function addFunctions($functions)
	{
dev-meghraj committed
170
		$this->_addCustom('Function', $functions);
171
	}
172

173 174 175 176 177 178
	/**
	 * Adds custom filters
	 * @param array $filters @see self::$filters
	 */
	public function addFilters($filters)
	{
dev-meghraj committed
179
		$this->_addCustom('Filter', $filters);
180
	}
181

182 183 184 185 186 187
	/**
	 * Adds custom extensions
	 * @param array $extensions @see self::$extensions
	 */
	public function addExtensions($extensions)
	{
dev-meghraj committed
188 189 190
		foreach ($extensions as $extName) {
			$this->twig->addExtension(new $extName());
		}
191
	}
192

193 194 195 196 197 198
	/**
	 * Sets Twig lexer options to change templates syntax
	 * @param array $options @see self::$lexerOptions
	 */
	public function setLexerOptions($options)
	{
dev-meghraj committed
199 200
		$lexer = new \Twig_Lexer($this->twig, $options);
		$this->twig->setLexer($lexer);
201
	}
202

203 204 205 206 207 208 209 210 211
	/**
	 * Adds custom function or filter
	 * @param string $classType 'Function' or 'Filter'
	 * @param array $elements Parameters of elements to add
	 * @throws \Exception
	 */
	private function _addCustom($classType, $elements)
	{
		$classFunction = 'Twig_' . $classType . '_Function';
dev-meghraj committed
212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229

		foreach ($elements as $name => $func) {
			$twigElement = null;

			switch ($func) {
				// Just a name of function
				case is_string($func):
					$twigElement = new $classFunction($func);
					break;
				// Name of function + options array
				case is_array($func) && is_string($func[0]) && isset($func[1]) && is_array($func[1]):
					$twigElement = new $classFunction($func[0], $func[1]);
					break;
			}

			if ($twigElement !== null) {
				$this->twig->{'add'.$classType}($name, $twigElement);
			} else {
230
				throw new \Exception("Incorrect options for \"$classType\" $name.");
dev-meghraj committed
231 232 233
			}
		}
	}
234
}