VOLT: 模板引擎

2024 年 8 月 29 日 | 阅读 2 分钟

Volt 为 Phalcon 提供了快速执行的能力，因为它是一种用 C 编写的、适用于 PHP 的快速且对设计者友好的模板语言。它有许多辅助工具来编写视图。 Volt 的灵感来自 Jinja，由 Armin Ronacher 编写。

实施

Volt 视图编译为 php，这节省了手动编写 php 代码的时间。

{# app/views/products/show.volt #}
{% block last_products %}
{% for product in products %}
    * Name: {{ product.name|e }}
    {% if product.status === 'Active' %}
       Price: {{ product.price + product.taxes/100 }}
    {% endif  %}
{% endfor  %}
{% endblock %}

激活 Volt

在这里，我们在具有扩展名 .phtml 的视图组件中注册 Volt。

<?php
use Phalcon\Mvc\View;
use Phalcon\Mvc\View\Engine\Volt;
// Register Volt as a service
$di->set(
    'voltService',
    function ($view, $di) {
        $volt = new Volt($view, $di);
        $volt->setOptions(
            [
                'compiledPath'      =>'../app/compiled-templates/',
                'compiledExtension' => '.compiled',
            ]
        );
        return $volt;
    }
);
// Register Volt as template engine
$di->set(
    'view',
    function () {
        $view = new View();
        $view->setViewsDir('../app/views/');
        $view->registerEngines(
            [
'.volt' => 'voltService',
            ]
        );
        return $view;    });

volt 中可用的选项

选项	描述	默认
compiledPath	将放置编译的 PHP 模板的可写路径	./
compiledExtension	附加到已编译 PHP 文件的其他扩展名	.php
compiledSeparator	Volt 用此分隔符替换目录分隔符 / 和 \，以便在已编译目录中创建一个文件	%%
Stat	Phalcon 是否必须检查模板文件及其编译路径之间是否存在差异	true
compileAlways	告诉 Volt 是在每个请求中编译模板，还是仅在它们更改时编译模板	False
前缀	允许在编译路径中为模板添加前缀	Null
autoescape	全局启用 HTML 的自动转义	False

变量

对象变量可能具有可以使用以下语法访问的属性：foo.bar。如果您传递数组，则必须使用方括号语法：foo['bar']

{{ post.title }} {# for $post->title #}
{{ post['title'] }} {# for $post['title'] #}

过滤器

可以使用过滤器格式化或修改变量。管道运算符 (|) 用于将过滤器应用于变量

{{ post.title|e }}
{{ post.content|striptags }}
{{ name|capitalize|trim }}

以下是可以使用的过滤器列表

Filter	描述
abs	将 abs PHP 函数应用于值。
Capitalize	通过将 ucwords PHP 函数应用于该值来大写字符串
convert_encoding	将字符串从一种字符集转换为另一种字符集
默认	设置一个默认值，以防评估的表达式为空（未设置或计算结果为假值）
escape	将 Phalcon\Escaper->escapeHtml() 应用于该值
escape_attr	将 Phalcon\Escaper->escapeHtmlAttr() 应用于该值
json_encode	将值转换为其 JSON 表示形式
json_decode	将值从其 JSON 表示形式转换为 PHP 表示形式