Yii框架允许开发者使用自己喜好的模板语法 (例如 Prado, Smarty)来编写控制器或者挂件的视图. 这可以通过编写和安装一个viewRenderer应用组件来实现. 这个视图渲染器拦截CBaseController::renderFile的调用,通过自定义的模板语法编译视图文件,然后渲染最终编译结果.

Info: 只有当编写的视图很少复用时才推荐使用自定义模板语法. 否则的话,在应用中复用视图将会强制使用同样的模板语法.

接下来, 我们会介绍如何使用 CPradoViewRenderer,一个和Prado框架类似,允许开发者使用自定义模板语法的视图渲染器. 如果你想要开发自己的视图渲染器, CPradoViewRenderer是一个很好的指南.

1. 使用CPradoViewRenderer

To use CPradoViewRenderer, we just need to configure the application as follows:

By default, CPradoViewRenderer will compile source view files and save the resulting PHP files under theruntime directory. Only when the source view files are changed, will the PHP files be re-generated. Therefore, using CPradoViewRenderer incurs very little performance degradation.

Tip: While CPradoViewRenderer mainly introduces some new template tags to make writing views easier and faster, you can still write PHP code as usual in the source views.

In the following, we introduce the template tags that are supported by CPradoViewRenderer.

PHP短标签

Short PHP tags are shortcuts to writing PHP expressions and statements in a view. The expression tag <%= expression %> is translated into <?php echo expression ?>; while the statement tag <% statement %>to <?php statement ?>. For example,

is translated into

组件标签

Component tags are used to insert a widget in a view. It uses the following syntax:

where WidgetClass specifies the widget class name or class path alias, and property initial values can be either quoted strings or PHP expressions enclosed within a pair of curly brackets. For example,

would be translated as

Note: The value for showRefreshButton is specified as {false} instead of "false" because the latter means a string instead of a boolean.

缓存标签

Cache tags are shortcuts to using fragment caching. Its syntax is as follows,

where fragmentID should be an identifier that uniquely identifies the content being cached, and the property-value pairs are used to configure the fragment cache. For example,

would be translated as

夹子标签

Like cache tags, clip tags are shortcuts to calling CBaseController::beginClip and CBaseController::endClip in a view. The syntax is as follows,

where clipID is an identifier that uniquely identifies the clip content. The clip tags will be translated as

评论标签

Comment tags are used to write view comments that should only be visible to developers. Comment tags will be stripped off when the view is displayed to end users. The syntax for comment tags is as follows,

2. 混合模板格式

Starting from version 1.1.2, it is possible to mix the usage of some alternative template syntax with the normal PHP syntax. To do so, the CViewRenderer::fileExtension property of the installed view renderer must be configured with a value other than .php. For example, if the property is set as .tpl, then any view file ending with .tpl will be rendered using the installed view renderer, while all other view files ending with .php will be treated as normal PHP view script.