Phalcon 使用Volt模版引擎

volt 是Phalcon中集成的模板引擎,我们也可以更换为其他模板引擎或同时使用多个模板引擎。本文只介绍 Phalcon 自带的 volt模板引擎。

启用Volt

和其他模板引擎一样,我们需要将 volt 模板注册到 views 组件中,并设置模板文件通用后缀名,或者直接使用标准化的后缀名 .phtml 才能正常使用:

//文件路径:Marser\App\Frontend\FrontendModule.php
$di->setShared(‘view‘, function () use ($config, $di) {
    $view = new \Phalcon\Mvc\View();
    //设置模板根目录
    $view->setViewsDir(ROOT_PATH . ‘/app/frontend/views/‘);
    //注册模板引擎
    $view->registerEngines(array(
        //设置模板后缀名
        ‘.phtml‘ => function ($view, $di) use ($config) {
            $volt = new \Phalcon\Mvc\View\Engine\Volt($view, $di);
            $volt->setOptions(array(
                //模板是否实时编译
                ‘compileAlways‘ => false,
                //模板编译目录
                ‘compiledPath‘ => ROOT_PATH . ‘/app/cache/compiled/frontend‘
            ));
            return $volt;
        },
    ));
    return $view;
});

用法

volt 模板中 基本用法 、 变量 、表达式 、 流程控制等部分的具体用法,文档中已有详细说明,请直接翻阅Phalcon文档
这里分享一下大家咨询比较多的几处用法以及踩过的坑。

控制器指定模板

    public function testAction(){
        $this->view->pick(‘view/test‘);
    }

变量传值

    //控制器中变量
    public function test2Action(){
        //setVar:单独进行变量传值
        $this->view->setVar(‘test‘, ‘hello world‘);

        //setVars:关联数组进行变量传值
        //$this->view->setVars([
        //    ‘test‘ => ‘hellow world‘,
        //]);
        $this->view->pick(‘view/test2‘);
    }

数值循环(For)

Phalcon文档 中有提到 volt 模板中 对象 和 关联数组 的循环方式,但没有明确例子来说明数值循环的用法。具体用法请看如下示例代码:

{% for i in 0..100 %}
  <div>{{i}}</div>
{% endfor %}

连接符

在 volt 模板中的连接符不是 . ,也不是 + ,而是 ~,代码示例如下:

{{ url(‘user/detail?uid=‘~user[‘uid‘]) }}

模板继承

Phalcon文档 中有非常详细的 模板的继承 的用法。这里和大家分享我在使用模板继承过程中踩过的一个坑:

<html>
    <head>
        {% block head %}
            <link rel="stylesheet" href="style.css" />
        {% endblock %}
    </head>
    <body>
        <div id="content">
          {% block content %}
            <div>
              {% block subContent %}{% endblock %}
            </div>
          {% endblock %}
      </div>
    </body>
</html>

在模板编译过程中,会报如下错误信息:

#模板继承中的block块不能嵌套
Embedding blocks into other blocks is not supported

目前官方暂未计划支持此功能,所以大家在使用模板继承时,需要特别注意规避block块嵌套的问题。

扩展模板函数

volt 模板中提供了一些常用的基本函数,若想在其中使用自定义函数或PHP自带的其他函数,则需要将函数注册到 volt 模板中。
首先,我们定义一个 volt 模板基类,并通过 模板编译器 添加函数:

//文件路径:Marser\App\Core\PhalBaseVolt.php
use \Phalcon\Mvc\View\Engine\Volt;

class PhalBaseVolt extends Volt{

    /**
     * 添加扩展函数
     */
    public function initFunction(){
        $compiler = $this->getCompiler();

        // 添加PHP自带的explode函数
        $compiler -> addFunction(‘explode‘, ‘explode‘);

        // 添加自定义的get_userinfo函数
        //$resolvedArgs即为任意参数,可接收多个参数
        //这里需要注意的是,匿名函数中的return返回值必须是string类型,且不需要实例化类,直接通过范围解析操作符(::)调用成员方法
        $compiler -> addFunction(‘get_userinfo‘, function($resolvedArgs, $exprArgs) use ($compiler){
            return ‘\Marser\App\Libs\Test::get_userinfo(‘ . $resolvedArgs . ‘)‘;
        });
    }
}

其中自定义函数 get_userinfo() 的代码如下:

//文件路径:Marser\App\Libs\Test.php
class Test {

    public function get_userinfo($username, $age, $mobile){
        return "用户名:{$username}, 年龄:{$age}, 联系方式:{$mobile}";
    }
}

通过上述代码,就已经向模板编译器中添加了PHP自带的 explode() 函数和程序中自定义的 get_userinfo() 函数。

然后,我们修改 DI 中注册的 views 对象:

        //文件路径:Marser\App\Frontend\FrontendModule.php
        $di -> setShared(‘view‘, function() use($config) {
            $view = new \Phalcon\Mvc\View();
            #设置模板根目录
            $view -> setViewsDir(ROOT_PATH . ‘/app/frontend/views/‘);
            #注册模板引擎
            $view -> registerEngines(array(
                #设置模板后缀名
                ‘.phtml‘ => function($view, $di) use($config) {
                    #实例化volt模板对象
                    $volt = new \Marser\App\Core\PhalBaseVolt($view, $di);
                    #设置模板配置项
                    $volt -> setOptions(array(
                        #模板是否实时编译
                        ‘compileAlways‘ => false,
                        #模板编译目录
                        ‘compiledPath‘  =>  ROOT_PATH . ‘/app/cache/compiled/frontend‘
                    ));
                    # 注意!区别在此行---添加模板扩展函数
                    $volt -> initFunction();
                    return $volt;
                },
            ));
            return $view;
        });

至此, explode() 和 get_userinfo() 两个函数就已经注册在模板中了。那么,如何调用呢?
explode() 在模板中调用的示例代码:

{% set introArray = explode(‘-‘, intro) %}
{% for value in introArray %}
  <div>{{value}}</div>
{% endfor %}

自定义函数 get_userinfo() 在模板中调用的示例代码:

{{get_userinfo(‘admin‘, ‘20‘, ‘中国上海‘)}}

不论是PHP自带函数,还是程序中自定义的函数,只需按照函数定义时的参数顺序传参即可。

以上代码已托管在github:https://github.com/KevinJay/m...

时间: 2024-10-23 11:09:13

Phalcon 使用Volt模版引擎的相关文章

如何在前端模版引擎开发中避免使用eval函数

前段时间,想着自己写一个简单的模版引擎,便于自己平时开发demo时使用.于是根据自己对模版引擎的理解,定义自己的模版格式,然后,根据自己定义的格式,编写处理函数,将模版标签中的字符串,解析成可执行的字符串,然后再用eval函数执行该可执行的字符串. 然后问题就出现了!eval等价于evil! 为什么呢?各大js权威书籍上都不提倡使用eval.下面我详细的解释一下为什么不提倡. 首先,大家需要知道,js并不是一门解释型语言.它和其他大家熟知的编程语言(c,java,c++)一样,是编译型语言.但是

前端数据模版引擎的总结

模板的工作原理可以简单地分成两个步骤:模板解析(翻译)和数据渲染.这两个步骤可分别部署在前端或后端来执行.如果放在后端执行,则是像Smarty,FreeMarker这样的后端模板引擎,而如果放在前端来执行,则是我们要探讨的前端模板. FreeMarker是一个模板引擎,一个基于模板生成文本输出的通用工具,使用纯Java编写,模板用servlet提供的数据动态地生成 HTML,模板语言是强大的直观的,编译器速度快,输出接近静态HTML页面的速度.这里不再对后端模版进行描述. 前端模版提高了前端开发

Express模版引擎hbs备忘

最近几天折腾了下express,想找个合适的模版引擎,下面是一些折腾过程的备忘 选择标准 选择一门模版语言时,可能会考虑的几点 语法友好(micro tmpl那种语法真是够了) 支持模版嵌套(子模版的概念) 支持模版继承(extend) 前后端共用 有容错处理(最好定位到具体出错位置) 支持预编译(性能好) 注意到hbs,似乎满足大部分的需求:https://github.com/donpark/hbs getting started demo地址:https://github.com/chyi

Spring整合Velocity模版引擎

1. 首先通过pom.xml自动加载velocity扩展包到工程: 1 <dependency> 2 <groupId>velocity</groupId> 3 <artifactId>velocity</artifactId> 4 <version>1.5</version> 5 </dependency> 2. 然后在自动装载bean的xml里边添加如下配置: 1 <bean id="vel

Symfony2模版引擎使用说明手册

一.基本使用 {{ demo }}输出一个demo变量; {{% func %}}通常是包含一个twig函数例如 for; 举个for循环的例子: {{% for i in 0..10 %}} <em>{{ i }}</em> {{% endfor %}} 当然也可以打印对象,例: {{% for user in users %}} <span>user.username</span> {{% endfor %}} 注:users是从控制器中传来的对象参数

【转】T4模版引擎之基础入门

额,T4好陌生的名字,和NuGet一样很悲催,不为世人所熟知,却又在背后默默无闻的奉献着,直到现在我们项目组的人除了我之外,其它人还是对其豪无兴趣,基本上是连看一眼都懒得看,可怜的娃啊... T4(Text Template Transformation Toolkit)是微软官方在VisualStudio 2008中开始使用的代码生成引擎.在 Visual Studio 中,“T4 文本模板”是由一些文本块和控制逻辑组成的混合模板,它可以生成文本文件. 在 Visual C# 或 Visual

laravel 模版引擎使用

laravel 模版引擎以 @标签 开头,以 @end标签 结尾,常用有 foreach foreachelse if for while等 1)foreach 和 foreachelse 差不到,区别就是 foreachelse 还有一个@empty 分支,当循环的变量为空时执行 @foreach ($obj as $key=>$value) {{--循环体--}} @endforeach @foreachelse ($obj as $key=>$value) {{--循环体--}} @em

Java模版引擎velocity的使用

前言 关于velocity与SpringMVC的配置请参考前一篇文章,此处不再介绍.velocity作为Java模版引擎的主要目的是为了允许任何人使用简单而强大的模板语言来引用定义在Java代码中的对象.在velocity文件中可以给该页面指定模版布局,从而节省了大量的时间去写通用的模版布局.可以定义变量,与Java方法进行交互. 定义一个layout模版 在上一篇文章中提到了配置默认模版,当然也可以不使用默认模版即在要用到的页面的最上端写上 #set($layout='layout/yourl

使用模版引擎填充重复dom元素

引入arttemplate,定义newajax发送跨域请求获得数据,将获得的数据用定义的格式渲染 <!DOCTYPE html><html lang="en"><head> <meta charset="UTF-8"> <title>Title</title> <script src="js/jquery.js"></script> <scrip