Twig是一款快速、安全、靈活的PHP模板引擎，它內置了許多filter和tags，並且支持模板繼承，能讓你用最簡潔的代碼來描述你的模板。他的語法和Python下的模板引擎Jinjia以及Django的模板語法都非常像。 比如我們在PHP中需要輸出變量並且將其進行轉義時，語法比較累贅：
復制代碼 代碼如下:
<?php echo $var ?>
<?php echo htmlspecialchars(\$var, ENT_QUOTES, 'UTF-8') ?>
但是在Twig中可以這樣寫:
復制代碼 代碼如下:
{{ var }}
{{ var|escape }}
{{ var|e }} {# shortcut to escape a variable #}
遍歷數組：
復制代碼 代碼如下:
{% for user in users %}
* {{ user.name }}
{% else %}
No user has been found.
{% endfor %}
但是要在Yii Framework集成Twig就會遇到點麻煩了，官方網站中已經有能夠集成Twig的方案，所以這裡我也不再贅述。但是由於Twig中是不支持PHP語法的，所以在有些表達上會遇到困難，比如我們在寫Form的視圖時，經常會這麼寫：
復制代碼 代碼如下:
<?php $form=$this->beginWidget('CActiveForm'); ?>
<span>Login</span>
<ul>
<li>
<?php echo $form->label($model,'username'); ?>
<?php echo $form->textField($model,'username'); ?>
</li>
<li>
<?php echo $form->label($model,'password'); ?>
<?php echo $form->passwordField($model,'password'); ?>
</li>
<li class="last">
<button type="submit">Login</button>
</li>
</ul>
<?php echo $form->error($model,'password'); ?>
<?php $this->endWidget(); ?>
但是這樣的語法是沒法在twig中表達的，所以想去擴展下Twig的功能，讓他能夠支持我們自定義的widget標簽，然後自動解析成我們需要的代碼。 總共需要兩個類：TokenParser和Node，下面直接上代碼：
復制代碼 代碼如下:
<?php
/*
* This file is an extension of Twig.
*
* (c) 2010 lfyzjck
*/
/**
* parser widget tag in Yii framework
*
* {% beginwidget 'CActiveForm' as form %}
* content of form
* {% endwidget %}
*
*/
class Yii_WidgetBlock_TokenParser extends Twig_TokenParser
{
/**
* Parses a token and returns a node.
*
* @param Twig_Token $token A Twig_Token instance
*
* @return Twig_NodeInterface A Twig_NodeInterface instance
*/
public function parse(Twig_Token $token)
{
$lineno = $token->getLine();
$stream = $this->parser->getStream();
$name = $stream->expect(Twig_Token::STRING_TYPE);
if($stream->test(Twig_Token::PUNCTUATION_TYPE)){
$args = $this->parser->getExpressionParser()->parseHashExpression();
}
else{
$args = new Twig_Node_Expression_Array(array(), $lineno);
}
$stream->expect(Twig_Token::NAME_TYPE);
$assign = $stream->expect(Twig_Token::NAME_TYPE);
$stream->expect(Twig_Token::BLOCK_END_TYPE);
$body = $this->parser->subparse(array($this, 'decideBlockEnd'), true);
$stream->expect(Twig_Token::BLOCK_END_TYPE);
return new Yii_Node_WidgetBlock(array(
'alias' => $name->getValue(),
'assign' => $assign,
), $body, $args, $lineno, $this->getTag());
}
/**
* Gets the tag name associated with this token parser.
*
* @param string The tag name
*/
public function getTag()
{
return 'beginwidget';
}
public function decideBlockEnd(Twig_Token $token)
{
return $token->test('endwidget');
}
}
class Yii_Node_WidgetBlock extends Twig_Node
{
public function __construct($attrs, Twig_NodeInterface $body, Twig_Node_Expression_Array $args = NULL, $lineno, $tag)
{
$attrs = array_merge(array('value' => false),$attrs);
$nodes = array('args' => $args, 'body' => $body);
parent::__construct($nodes, $attrs, $lineno,$tag);
}
public function compile(Twig_Compiler $compiler)
{
$compiler->addDebugInfo($this);
$compiler->write('$context["'.$this->getAttribute('assign')->getValue().'"] = $context["this"]->beginWidget("'.$this->getAttribute('alias').'",');
$argNode = $this->getNode('args');
$compiler->subcompile($argNode)
->raw(');')
->raw("\n");
$compiler->indent()->subcompile($this->getNode('body'));
$compiler->raw('$context["this"]->endWidget();');
}
}
?>
然後在Twig初始化的地方增加我們的語法解析類：
復制代碼 代碼如下:
$twig->addTokenParser(new Yii_WidgetBlock_TokenParser);
然後我們就可以在twig的模板裡這麼寫了：
復制代碼 代碼如下:
{% beginwidget 'CActiveForm' as form %}
<ul>
<li>
{{ form.label(model, 'username') }}
{{ form.textField(model, 'username') }}
</li>
<li>
{{ form.label(model, 'password') }}
{{ form.passwordField(model, 'password') }}
</li>
</ul>
{% endwidget %}
