PHP Twig模版的Filters详解（中文）

来源：互联网发布：男士内裤品牌知乎编辑：程序博客网时间：2024/05/16 18:52

目前支持的过滤器包括:

date format replace number_format url_encode json_encode convert_encoding title capitalize nl2br upper lower striptags join reverse length sort default keys escape raw merge

date过滤器

1.1版本新增时区支持，1.5版本增加了默认的日期格式。

这个过滤器和php的date函数无限类似

[html]view plaincopyprint?
{{ post.published_at|date("m/d/Y") }}  
{{ "now"|date("m/d/Y") }}  

如果想在格式里输出字母，需要在每个字母前输入\\

[html]view plaincopyprint?
{{ post.published_at|date("F jS \\a\\t g:ia") }}  

注意：经过我的测试，不能输入中文字符，这样写不行。。 {{ 'now'|date("F jS \\上\\午 g:ia") }}

你可以指定时区

[html]view plaincopyprint?
{{ post.published_at|date("m/d/Y", "Europe/Paris") }}  

如果你提供的格式化字符串是不支持，会自动使用默认格式（F j, Y H:i）你可以用代码修改这个默认格式

[php]view plaincopyprint?
$twig = new Twig_Environment($loader);  
$twig->getExtension('core')->setDateFormat('d/m/Y', '%d days');  

format过滤器

和php的printf函数一样，用来替换占位符

[html]view plaincopyprint?
{{ "I like %s and %s."|format(foo, "bar") }}  
  
{# returns I like foo and bar  
   if the foo parameter equals to the foo string. #}  

replace过滤器

这个自己看吧

[html]view plaincopyprint?
{{ "I like %this% and %that%."|replace({'%this%': foo, '%that%': "bar"}) }}  
  
{# returns I like foo and bar  
   if the foo parameter equals to the foo string. #}  

number_format过滤器

1.5版本新增过滤器。

他是php函数 number_format的一个包装直接见函数参考吧

[html]view plaincopyprint?
{{ 200.35|number_format }}  

另外就是可以用php来修改默认的格式

[php]view plaincopyprint?
$twig = new Twig_Environment($loader);  
$twig->getExtension('core')->setNumberFormat(3, ',', '.');  

url_encode过滤器

这个直接使用 urlencode函数

[html]view plaincopyprint?
{{ data|url_encode() }}  

json_encode过滤器

直接使用json_encode函数

[html]view plaincopyprint?
{{ data|json_encode() }}  

convert_encoding过滤器

1.4版本新加内容

转换一个字符串，第一个参数是输出编码，第二个参数是输入编码

本函数依赖于iconv 或者mbstring 所以至少需要安装一个

[html]view plaincopyprint?
{{ data|convert_encoding('UTF-8', 'iso-2022-jp') }}  

title过滤器

会让每个单词的首字母大写。

[html]view plaincopyprint?
{{ 'my first car'|title }}  
  
{# outputs 'My First Car' #}  

capitalize过滤器

会把字符串变成首字母大写，其余字母小写的格式

[html]view plaincopyprint?
{{ 'my first car'|capitalize }}  
  
{# outputs 'My first car' #}  

nl2br过滤器

会把换行符\n 变成<br />

[html]view plaincopyprint?
{{ "I like Twig.\nYou will like it too."|nl2br }}  
{# outputs  
  
    I like Twig.<br />  
    You will like it too.  
  
#}  

upper lower 过滤器

让字符串变大小写

striptags过滤器

直接使用的是strip_tags函数

join过滤器

这个我很喜欢，跟python的join一样，用来将一个数组的内容连接起来，并用指定的字符串分割。

[html]view plaincopyprint?
{{ [1, 2, 3]|join }}  
{# returns 123 #}  
{{ [1, 2, 3]|join('|') }}  
{# returns 1|2|3 #}  

reverse 过滤器

反转一个数组，或者是一个实现了Iterator接口的对象

[html]view plaincopyprint?
{% for use in users|reverse %}  
    ...  
{% endfor %}  

length过滤器

返回一个数组或者字符串的长度

[html]view plaincopyprint?
{% if users|length > 10 %}  
    ...  
{% endif %}  

sort过滤器

使用的是sort函数

[html]view plaincopyprint?
{% for use in users|sort %}  
    ...  
{% endfor %}  

default过滤器

当变量没定义或者为空的时候，返回预先设置的内容

[html]view plaincopyprint?
{{ var|default('var is not defined') }}  
  
{{ var.foo|default('foo item on var is not defined') }}  
  
{{ var['foo']|default('foo item on var is not defined') }}  
  
{{ ''|default('passed var is empty')  }}  

keys过滤器

返回key数组

[html]view plaincopyprint?
{% for key in array|keys %}  
    ...  
{% endfor %}  

escape过滤器

主要转义 & < > ' " 。并且它有个简写方式 e。

[html]view plaincopyprint?
{{ user.username|escape }}  
{{ user.username|e }}  

还可以转义 js

[html]view plaincopyprint?
{{ user.username|escape('js') }}  
{{ user.username|e('js') }}  

实际上他使用的是php函数 htmlspecialchars

raw过滤器

用于在autoescape标签内部，标记出不需要转义的内容。

[html]view plaincopyprint?
{% autoescape true %}  
    {{ var|raw }} {# var won't be escaped #}  
{% endautoescape %}  

merge过滤器

用来合并数组

[html]view plaincopyprint?
{% set items = { 'apple': 'fruit', 'orange': 'fruit' } %}  
  
{% set items = items|merge({ 'peugeot': 'car' }) %}  
  
{# items now contains { 'apple': 'fruit', 'orange': 'fruit', 'peugeot': 'car' } #}  

0 0