EasyTpl|EasyTpl - 简单快速的 PHP 模板引擎
EasyTpl - 简单快速的 PHP 模板引擎
?? 简单快速的 PHP 模板引擎。
功能特性
- 简单、轻量且快速。
- 无学习成本
- 仅仅简单处理并转换为原生PHP语法
- 兼容PHP原生语法使用
- 更加简单的输出语法。 例如:
{{= $var }}
{{ $var }}
{{ echo $var }}
- 支持所有控制语法。 例如
if,elseif,else; foreach; for; switch
- 支持链式访问数组值。 例如:
{{ $arr.0 }}
{{ $map.name }}
{{ $map.user.name }}
- 更加安全,默认会自动通过
htmlspecialchars
将输出结果进行处理
- 除非设置了禁用或者手动使用
raw
过滤器
- 除非设置了禁用或者手动使用
- 支持使用PHP内置函数作为过滤器。 例如:
{{ $var | ucfirst }}
- 支持添加自定义过滤器
- 默认内置过滤器:
upper
lower
nl
- 默认内置过滤器:
- 支持添加自定义指令,提供自定义功能
- 支持模板中添加注释。 例如:
{{# comments ... #}}
- 需要 PHP 8.0+
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+' : '<= 20' }}
默认会自动通过htmlspecialchars
将输出结果进行处理,除非设置了禁用或者手动使用raw
过滤器
- 设置禁用输出过滤
$t->disableEchoFilter()
- 模板中禁用输出过滤
{{ $name | raw }}
可以使用
.
来快速访问数组值。原来的写法也是可用的,简洁写法也会自动转换为原生写法。$arr = [
'val0',
'subKey' => 'val1',
];
在模板中使用:
first value is: {{ $arr.0 }} // val0
'subKey' value is: {{ $arr.subKey }} // val1
If 语句块
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 < 20.
{{ endif }}
if...elseif...else
语句:hi, my name is {{ $name }}
age is {{ $age }}, and
{{ if ($age >= 50) }}
age >= 50.
{{ elseif ($age >= 20) }}
age >= 20.
{{ else }}
age < 20.
{{ endif }}
For/Foreach 语句块
foreach
:tags:{{ foreach($tags as $tag) }}
- {{ $tag }}{{ endforeach }}
with keys:
tags:{{ foreach($tags as $index => $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: https://github.com/phppkg/eas...?? 简单快速的 PHP 模板引擎。
功能特性
- 简单、轻量且快速。
- 无学习成本
- 仅仅简单处理并转换为原生PHP语法
- 兼容PHP原生语法使用
- 更加简单的输出语法。 例如:
{{= $var }}
{{ $var }}
{{ echo $var }}
- 支持所有控制语法。 例如
if,elseif,else; foreach; for; switch
- 支持链式访问数组值。 例如:
{{ $arr.0 }}
{{ $map.name }}
{{ $map.user.name }}
- 更加安全,默认会自动通过
htmlspecialchars
将输出结果进行处理
- 除非设置了禁用或者手动使用
raw
过滤器
- 除非设置了禁用或者手动使用
- 支持使用PHP内置函数作为过滤器。 例如:
{{ $var | ucfirst }}
- 支持添加自定义过滤器
- 默认内置过滤器:
upper
lower
nl
- 默认内置过滤器:
- 支持添加自定义指令,提供自定义功能
- 支持模板中添加注释。 例如:
{{# comments ... #}}
- 需要 PHP 8.0+
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+' : '<= 20' }}
默认会自动通过htmlspecialchars
将输出结果进行处理,除非设置了禁用或者手动使用raw
过滤器
- 设置禁用输出过滤
$t->disableEchoFilter()
- 模板中禁用输出过滤
{{ $name | raw }}
可以使用
.
来快速访问数组值。原来的写法也是可用的,简洁写法也会自动转换为原生写法。$arr = [
'val0',
'subKey' => 'val1',
];
在模板中使用:
first value is: {{ $arr.0 }} // val0
'subKey' value is: {{ $arr.subKey }} // val1
If 语句块
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 < 20.
{{ endif }}
if...elseif...else
语句:hi, my name is {{ $name }}
age is {{ $age }}, and
{{ if ($age >= 50) }}
age >= 50.
{{ elseif ($age >= 20) }}
age >= 20.
{{ else }}
age < 20.
{{ endif }}
For/Foreach 语句块
foreach
:tags:{{ foreach($tags as $tag) }}
- {{ $tag }}{{ endforeach }}
with keys:
tags:{{ foreach($tags as $index => $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;
}
);
【EasyTpl|EasyTpl - 简单快速的 PHP 模板引擎】在模板中使用:
{{ include('part/header.tpl', ['title' => 'My world']) }}
Github: https://github.com/phppkg/eas...
推荐阅读
- 科学养胃,别被忽悠,其实真的很简单
- opencv|opencv C++模板匹配的简单实现
- 松软可口易消化,无需烤箱超简单,新手麻麻也能轻松成功~
- 简单心理2019春A期+32+张荣
- 《算法》-图[有向图]
- android防止连续点击的简单实现(kotlin)
- 机器学习一些简单笔记
- Android超简单实现沉浸式状态栏
- v-charts简单使用
- 校园非自愿来访者辅导问句学习