Volt 模块引擎与phalcon框架组合使用指南

　　 ———— 近期工作中web页面使用由C语言编写的Volt模板引擎，相比之前由js动态加载页面速度更快，更利于百度数据的抓取，现根据文档整理一下使用思路

（Volt是一个超快速和设计者友好的模板语言，C语言编写的PHP。它为您提供了一套助理写一个简单的方法的意见。phalcon框架与其他组件的高度集成，就像你可以使用它作为一个独立的组件在你的应用程序中。

Volt是一种用C语言编写的超快速并且设计友好的PHP模板引擎，它为你提供了一套很方便的视图助手。Volt与其他的组件高度集成，就像你可以在应用程序中单独使用它一样。

）

1、激活

把Volt 注册到视图组件，并设置一个扩展名称或者使用默认的扩展名 .phtml ：

<?php

//Registering Volt as template engine

$di->set('view', function() {

    $view = new \Phalcon\Mvc\View();

    $view->setViewsDir('../app/views/');

    $view->registerEngines(array(

        ".volt" => 'Phalcon\Mvc\View\Engine\Volt'

    ));

    return $view;

});

<?php

$view->registerEngines(array(

    ".phtml" => 'Phalcon\Mvc\View\Engine\Volt'

));

2、基本使用方法

　　Volt的代码是由PHP和HTML构成，Volt中有一组特殊的分隔符，{% ... %}用于执行循环语句和条件判断等，{{ ... }}用于赋值。

　　可以使用Phalcon\Mvc\View::setVar把控制器中的变量传递到视图中。

<?php

class PostsController extends \Phalcon\Mvc\Controller

{

    public function showAction()

    {

        $post = Post::findFirst();

        $this->view->setVar("title", $post->title);

        $this->view->setVar("post", $post);

        $this->view->setVar("menu", Menu::find());

        $this->view->setVar("show_navigation", true);

    }

}

　　在上面的例子中，有三个变量传递到视图中：title, menu 和 post ：

3、变量

　　变量可以有属性，可以通过使用语法访问他们：如：foo.bar。如果他们是数组，你可以使用foo['bar'] 的方式访问

{{ post.title }}

{{ post['title'] }}

4、过滤器

　　变量可以使用过滤器格式化或修改，管道操作符“|”用于接收过滤器过滤变量

{{ post.title|e }}

{{ post.content|striptags }}

{{ name|capitalize|trim }}

5、注释

　注释使用{# ... #}分隔符添加注释

6、逻辑语法

　　1、for循环

<h1>Robots</h1>

{% for robot in robots %}

  {% for part in robot.parts %}

  Robot: {{ robot.name|e }} Part: {{ part.name|e }} <br/>

  {% endfor %}

{% endfor %}

　　2、if判断

<h1>Robots</h1>

<ul>

{% for robot in robots %}

  {% if robot.type = "cyborg" %}

  <li>{{ robot.name|e }}</li>

  {% else %}

  <li>{{ robot.name|e }} (not a cyborg)</li>

  {% endif %}

{% endfor %}

</ul>

7、赋值

　　可以使用“set”设置或改变变量的值

{% set fruits = ['Apple', 'Banana', 'Orange'] %}

{% set name = robot.name %}

8、数学计算

　　可以使用操作符 + - * % /

9、比较运算符

　　== != <> > < <= >= === !==

10、逻辑运算符

　　or and not

11、其他操作符

　　~ | .. is is not

{% set robots = ['Voltron', 'Astro Boy', 'Terminator', 'C3PO'] %}

{% for index in 0..robots|length %}

    {% if isset robots[index] %}

        {{ "Name: " ~ robots[index] }}

    {% endif %}

{% endfor %}

12、视图集成

　　Volt 模板集成了 Phalcon\Mvc\View, 你的模板层次结构和默认的层次结构一样，你可以这样使用 partials ：

{{ content() }}

{{ partial("partials/footer.volt") }}

13、模板继承

　　你可以创建一个基础模板，其他目标继承这个基础模板，可以提高模板文件的复用性。基础模板使用block定义一个块，这个块可以是被子模板覆盖的。

　　例如：以下为基础模板

{# templates/base.volt #}

<!DOCTYPE html>

<html>

    <head>

        {% block head %}

            <link rel="stylesheet" href="style.css" />

        {% endblock %}

        <title>{% block title %}{% endblock %} - My Webpage</title>

    </head>

    <body>

        <div id="content">{% block content %}{% endblock %}</div>

        <div id="footer">

            {% block footer %}© Copyright 2012, All rights reserved.{% endblock %}

        </div>

    </body>

</html>

　　其他的模板可以继承自这个基础模板，同时替换掉基础模板中的 block:

{% extends "templates/base.volt" %}

{% block title %}Index{% endblock %}

{% block head %}<style type="text/css">.important { color: #336699; }</style>{% endblock %}

{% block content %}

    <h1>Index</h1>

    <p class="important">Welcome on my awesome homepage.</p>

{% endblock %}

　　并非所有的 block 都需要在子模板中进行替换(意思是，你可以替换需要的那一部分)。上面的示例最终输出结果如下：

<!DOCTYPE html>

<html>

    <head>

        <style type="text/css">.important { color: #336699; }</style>

        <title>Index - My Webpage</title>

    </head>

    <body>

        <div id="content">

            <h1>Index</h1>

            <p class="important">Welcome on my awesome homepage.</p>

        </div>

        <div id="footer">

            © Copyright 2012, All rights reserved.

        </div>

    </body>

</html>

　　作为一个片断，”extends” 后跟的路径是一个相对于视图存放目录的相对路径(即 app/views).

　　/*默认情况下，出于对性能的考虑，Volt只检查子模板是否有修改。因为建议在开发阶段初始时使用 ‘compileAlways’ => true。这样的话，模板始终检查父模板是否有修改。*/

14、配置

　　Volt是可以通过配置改变默认的行为的

<?php

//Register Volt as a service

$di->set('voltService', function($view, $di) {

    $volt = new \Phalcon\Mvc\View\Engine\Volt($view, $di);

    $volt->setOptions(array(

        "compiledPath" => "../app/compiled-templates/",

        "compiledExtension" => ".compiled"

    ));

    return $volt;

});

//Register Volt as template engine

$di->set('view', function() {

    $view = new \Phalcon\Mvc\View();

    $view->setViewsDir('../app/views/');

    $view->registerEngines(array(

        ".volt" => 'voltService'

    ));

    return $view;

});

　　如果不重用Volt,你可以不把它作为一个服务，而是在注册view服务的时候，用匿名函数的方式注册Volt模板引擎

<?php

//Register Volt as template engine with an anonymous function

$di->set('view', function() {

    $view = new \Phalcon\Mvc\View();

    $view->setViewsDir('../app/views/');

    $view->registerEngines(array(

        ".volt" => function($view, $di) {

            $volt = new \Phalcon\Mvc\View\Engine\Volt($view, $di);

            //set some options here

            return $volt;

        }

    ));

    return $view;

});