首页  >  文章  >  后端开发  >  详解PHP EasyTpl的功能及安装使用方法

详解PHP EasyTpl的功能及安装使用方法

藏色散人
藏色散人转载
2021-11-17 14:08:463658浏览

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

composer require phppkg/easytpl

快速开始

use PhpPkg\EasyTpl\EasyTemplate;

$tplCode = <<<&#39;CODE&#39;
My name is {{ $name | strtoupper }},
My develop tags:

{{ foreach($tags as $tag) }}
- {{ $tag }}

{{ endforeach }}
CODE;

$t = new EasyTemplate();

$str = $t->renderString($tplCode, [
    &#39;name&#39; => &#39;inhere&#39;,
    &#39;tags&#39; => [&#39;php&#39;, &#39;go&#39;, &#39;java&#39;],
]);

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 语句:

    {{ 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视频教程》                                                

    以上是详解PHP EasyTpl的功能及安装使用方法的详细内容。更多信息请关注PHP中文网其他相关文章!

    声明:
    本文转载于:learnku.com。如有侵权,请联系admin@php.cn删除