需要对模板输出使用函数进行过滤或其它处理的时候,可以使用:
~~~
{$data.name|md5}
~~~
可以使用空格,例如下面的写法是一样的:
~~~
{$data.name | md5}
~~~
编译后的结果是:
~~~
<?php echo htmlentities(md5($data['name'])); ?>
~~~
其中`htmlentities`方法是系统默认添加的(无需手动指定。
>[danger] 为了避免出现XSS安全问题,默认的变量输出都会使用`htmlentities`方法进行转义输出。
你还可以设置默认的过滤方法,在配置文件`template.php`中设置
~~~
'default_filter' => 'htmlspecialchars'
~~~
就会默认使用`htmlspecialchars`方法过滤输出。
如果你不需要转义(例如你需要输出html表格等内容),可以使用:
~~~
{$data.name|raw}
~~~
编译后的结果是:
~~~
<?php echo $data['name']; ?>
~~~
系统内置了下面几个固定的过滤规则(不区分大小写)
过滤方法|描述
---|---
date|日期格式化(支持各种时间类型)
format|字符串格式化
upper|转换为大写
lower|转换为小写
first|输出数组的第一个元素
last|输出数组的最后一个元素
default|默认值
raw|不使用(默认)转义
例如
~~~
{$data.create_time|date='Y-m-d H:i'}
{$data.number|format='%02d'}
~~~
如果函数有多个参数需要调用,可以使用
~~~
{$data.name|substr=0,3}
~~~
表示输出
~~~
<?php echo htmlentities(substr($data['name'],0,3)); ?>
~~~
还可以支持多个函数过滤,多个函数之间用“|”分割即可,例如:
~~~
{$name|md5|upper|substr=0,3}
~~~
编译后的结果是:
~~~
<?php echo htmlentities(substr(strtoupper(md5($name)),0,3)); ?>
~~~
函数会按照从左到右的顺序依次调用(系统默认的过滤规则会在最后调用)。
>[danger] 变量输出使用的函数可以支持内置的PHP函数或者用户自定义函数,甚至是静态方法。
如果你觉得这样写起来比较麻烦,也可以直接这样写:
~~~
{:substr(strtoupper(md5($name)),0,3)}
~~~
>[danger] 使用该方法输出的值不会使用默认的过滤方法进行转义。
可以在模板中直接使用系统的助手函数进行输出
~~~
{:app('cache')->get('name')}
~~~
表示调用容器中的`think\Cache`对象实例输出`name`缓存标识内容。
`{:`开头的变量输出表示调用函数或者类的方法及属性,如果你要带命名空间调用类的属性,例如:
~~~
{:think\\App::VERSION}
{:think\\facade\\Request::get('name')}
~~~
>[danger]类的命名空间中的`\`需要改成`\\`才能正常调用。