加入收藏 | 设为首页 | 会员中心 | 我要投稿 我爱故事小小网_铜陵站长网 (http://www.0562zz.com/)- 视频终端、云渲染、应用安全、数据安全、安全管理!
当前位置: 首页 > 站长学院 > PHP教程 > 正文

详解PHP EasyTpl的功能及安装使用技巧

发布时间:2022-07-11 12:56:24 所属栏目:PHP教程 来源:互联网
导读:EasyTpl - 简单快速的 PHP 模板引擎 简单快速的 PHP 模板引擎。 功能特性 简单、轻量且快速。 无学习成本 仅仅简单处理并转换为原生PHP语法 兼容PHP原生语法使用 更加简单的输出语法。 例如:{{= $var }} {{ $var }} {{ echo $var }} 支持所有控制语法。 例
  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 PhpPkgEasyTplEasyTemplate;
 
   
 
  $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 PhpPkgEasyTplEasyTemplate;$t = EasyTemplate::new([
 
      'tplDir' => 'path/to/templates',
 
      'allowExt' => ['.php', '.tpl'],]);// do something ...
 
  更多设置:
 
 
 
 
 
 
  /** @var PhpPkgEasyTplEasyTemplate $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 PhpPkgEasyTplEasyTemplate;$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

(编辑:我爱故事小小网_铜陵站长网)

【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!

    热点阅读