简单快速的 PHP 模板引擎。
{{= $var }}
{{ $var }}
{{ echo $var }}
if,elseif,else;foreach;for;switch
{{ $arr.0 }}
{{ $map.name }}
{{ $map.user.name }}
htmlspecialchars
将输出结果进行处理raw
过滤器{{ $var | ucfirst }}
upper
lower
nl
{{# comments ... #}}
composer
composer require phppkg/easytpl
use PhpPkg\EasyTpl\EasyTemplate; $tplCode = <<<'CODE' My name is {{ $name | strtoupper }}, My develop tags: {{ foreach($tags as $tag) }} - {{ $tag }} {{ endforeach }} CODE; $t = new EasyTemplate(); $str = $t->renderString($tplCode, [ 'name' => 'inhere', 'tags' => ['php', 'go', 'java'], ]); echo $str;
渲染输出:
My name is INHERE,My develop tags:- php- go- java
语法跟PHP原生模板一样的,加入的特殊语法只是为了让使用更加方便。
EasyTemplate
默认开启输出过滤,可用于渲染视图模板TextTemplate
则是关闭了输出过滤,主要用于文本处理,代码生成等use PhpPkg\EasyTpl\EasyTemplate;$t = EasyTemplate::new([ 'tplDir' => 'path/to/templates', 'allowExt' => ['.php', '.tpl'],]);// do something ...
更多设置:
/** @var PhpPkg\EasyTpl\EasyTemplate $t */ $t->disableEchoFilter(); $t->addFilter($name, $filterFn); $t->addFilters([]); $t->addDirective($name, $handler);
下面的语句一样,都可以用于打印输出变量值
{{ $name }}{{= $name }}{{ echo $name }}
更多:
{{ $name ?: 'inhere' }}{{ $age > 20 ? '20+' : '74a3835a50559319c970010127e40c0ddisableEchoFilter()
{{ $name | raw }}
可以使用 .
来快速访问数组值。原来的写法也是可用的,简洁写法也会自动转换为原生写法。
$arr = [ 'val0', 'subKey' => 'val1',];
在模板中使用:
first value is: {{ $arr.0 }} // val0'subKey' value is: {{ $arr.subKey }} // val1
if
语句:
{{ if ($name !== '') }}hi, my name is {{ $name }}{{ endif }}
if else
语句:
hi, my name is {{ $name }}age is {{ $age }}, and{{ if ($age >= 20) }} age >= 20.{{ else }} age 1151b160bdcc90f86856a2d25abad689= 50) }} age >= 50.{{ elseif ($age >= 20) }} age >= 20.{{ else }} age 2df235674a603143fda7a375e75eecf1 $tag) }}{{ $index }}. {{ $tag }}{{ endforeach }}
以 {{#
和 #}}
包裹的内容将会当做注释忽略。
{{# comments ... #}}{{ $name }} // inhere
multi lines:
{{# this comments block #}}{{ $name }} // inhere
默认内置过滤器:
upper
- 等同于 strtoupper
lower
- 等同于 strtolower
nl
- 追加换行符 \n
您可以在任何模板中使用过滤器。
基本使用:
{{ 'inhere' | ucfirst }} // Inhere {{ 'inhere' | upper }} // INHERE
链式使用:
{{ 'inhere' | ucfirst | substr:0,2 }} // In{{ '1999-12-31' | date:'Y/m/d' }} // 1999/12/31
传递非静态值:
{{ $name | ucfirst | substr:0,1 }}{{ $user['name'] | ucfirst | substr:0,1 }}{{ $userObj->name | ucfirst | substr:0,1 }}{{ $userObj->getName() | ucfirst | substr:0,1 }}
将变量作为过滤器参数传递:
{{ $suffix = '¥';}}{{ '12.75' | add_suffix:$suffix }} // 12.75¥
use PhpPkg\EasyTpl\EasyTemplate;$tpl = EasyTemplate::new();// use php built function$tpl->addFilter('upper', 'strtoupper');// 一次添加多个$tpl->addFilters([ 'last3chars' => function (string $str): string { return substr($str, -3); },]);
在模板中使用:
{{ $name = 'inhere';}}{{ $name | upper }} // INHERE{{ $name | last3chars }} // ere{{ $name | last3chars | upper }} // ERE
您可以使用指令实现一些特殊的逻辑。
$tpl = EasyTemplate::new();$tpl->addDirective( 'include', function (string $body, string $name) { /** will call {@see EasyTemplate::include()} */ return '$this->' . $name . $body; });
在模板中使用:
{{ include('part/header.tpl', ['title' => 'My world']) }}
Github: github.com/phppkg/easytpl
以上是详解PHP EasyTpl的功能及安装使用方法的详细内容。更多信息请关注PHP中文网其他相关文章!