首頁  >  文章  >  後端開發  >  詳解PHP EasyTpl的功能及安裝使用方法

詳解PHP EasyTpl的功能及安裝使用方法

藏色散人
藏色散人轉載
2021-11-17 14:08:463632瀏覽

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+' : '7496cc0ab5396de5ca6090db2f9dfe8adisableEchoFilter()
  • #模板中停用輸出過濾{{ $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 18c725303e8f3bbaa2fd646de2f486bb= 50) }}
     age >= 50.{{ elseif ($age >= 20) }}
     age >= 20.{{ else }}
     age 9fb5e34af58c17fb1a6cfcec3f437641 $tag) }}{{ $index }}. {{ $tag }}{{ endforeach }}

    模板中新增註解

    #以{{# 和#}} 包裹的內容將會當作註解而忽略。

    {{# comments ... #}}{{ $name }} // inhere

    multi lines:

    {{# this
     comments
     block
    #}}{{ $name }} // inhere

    使用過濾器

    預設內建過濾器:

    • upper - 等同於strtoupper
    • lower - 等同於strtolower
    • #    -追加換行符\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刪除