Ausführliche Erläuterung der Funktionen sowie Installation und Nutzung von PHP EasyTpl

                                                                                                                LEasytpl – Einfache und schnelle PHP-Vorlagen-Engine

Einfache und schnelle PHP-Vorlagen-Engine.

Funktionen

Einfach, leicht und schnell.

Keine Lernkosten

• Nur einfache Verarbeitung und Konvertierung in die native PHP-Syntax
  • Kompatibel mit der nativen PHP-Syntax
  • Einfachere Ausgabesyntax. Zum Beispiel: {{= $var }} {{ $var }} {{ echo $var }}
  unterstützt die gesamte Steuersyntax . Beispielsweise unterstützt if,elseif,else;foreach;for;switch
• den verketteten Zugriff auf Array-Werte. Zum Beispiel: {{ $arr.0 }} {{ $map.name }} {{ $map.user.name }} {{= $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+' : '<blockquote><p>默认会自动通过 <code>htmlspecialchars</code> 将输出结果进行处理，除非设置了禁用或者手动使用 <code>raw</code> 过滤器</p></blockquote>

• 设置禁用输出过滤 $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 <p><code>if...elseif...else</code> 语句:</p><pre class="brush:php;toolbar:false">hi, my name is {{ $name }}age is {{ $age }}, and{{ if ($age >= 50) }}
 age >= 50.{{ elseif ($age >= 20) }}
 age >= 20.{{ else }}
 age <h3>
<span class="header-link octicon octicon-link"></span>For/Foreach 语句块</h3><p><code>foreach</code>:</p><pre class="brush:php;toolbar:false">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
Sicherer, die Ausgabeergebnisse werden standardmäßig automatisch über htmlspecialchars verarbeitet

Es sei denn, es ist deaktiviert oder der raw-Filter wird manuell verwendet.

Unterstützt die Verwendung von PHP Integrierte Funktionen als Filter. Zum Beispiel: {{ $var |. ucfirst }}

Unterstützt das Hinzufügen benutzerdefinierter FilterStandardmäßiger integrierter Filter: upper lower nl

Unterstützt das Hinzufügen benutzerdefinierter Anweisungen und die Bereitstellung benutzerdefinierter Funktionen

Unterstützt das Hinzufügen von Kommentaren zu Vorlagen. Zum Beispiel: {{# comments ... #}}

Installation

Erfordert PHP 8.0+

composer

{{ 'inhere' | ucfirst }} // Inhere {{ 'inhere' | upper }} // INHERE

Schnellstart

{{ 'inhere' | ucfirst | substr:0,2 }} // In{{ '1999-12-31' | date:'Y/m/d' }} // 1999/12/31

Rendering-Ausgabe

:

{{ $name | ucfirst | substr:0,1 }}{{ $user['name'] | ucfirst | substr:0,1 }}{{ $userObj->name | ucfirst | substr:0,1 }}{{ $userObj->getName() | ucfirst | substr:0,1 }}

🎜Weitere Nutzungsanweisungen🎜🎜Die Syntax ist die gleiche wie bei der nativen PHP-Vorlage, die spezielle Syntax wurde nur hinzugefügt, um die Verwendung komfortabler zu gestalten. 🎜🎜🎜EasyTemplate aktiviert standardmäßig die Ausgabefilterung und kann zum Rendern von Ansichtsvorlagen verwendet werden. 🎜🎜TextTemplate deaktiviert die Ausgabefilterung und wird hauptsächlich für die Textverarbeitung, Codegenerierung usw. verwendet. usw. 🎜🎜🎜 🎜🎜Konfigurationseinstellungen🎜

{{
    $suffix = '￥';}}{{ '12.75' | add_suffix:$suffix }} // 12.75￥

🎜Weitere Einstellungen:🎜

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);
    },]);

🎜Variablenwert ausgeben🎜🎜Die folgenden Anweisungen können zum Ausdrucken von Variablenwerten verwendet werden🎜

{{
  $name = 'inhere';}}{{ $name | upper }} // INHERE{{ $name | last3chars }} // ere{{ $name | last3chars | upper }} // ERE

🎜Mehr:🎜

$tpl = EasyTemplate::new();$tpl->addDirective(
    'include',
    function (string $body, string $name) {
        /** will call {@see EasyTemplate::include()} */
        return '$this->' . $name . $body;
    });

🎜🎜Standardmäßig ist htmlspecialchar s wird automatisch übergeben Die Ausgabeergebnisse werden verarbeitet, sofern sie nicht deaktiviert oder manuell verwendet werden raw Filter 🎜

🎜🎜Legen Sie fest, dass die Ausgabefilterung deaktiviert werden soll $t->disableEchoFilter( )🎜🎜Ausgabefilterung in Vorlagen deaktivieren <code>{{ $name |. raw }}🎜🎜🎜🎜🎜Schnell auf Array-Werte zugreifen🎜🎜Sie können . verwenden, um Schneller Zugriff auf Array-Werte. Die ursprüngliche Schreibmethode ist ebenfalls verfügbar und die prägnante Schreibmethode wird automatisch in die native Schreibmethode konvertiert. 🎜

{{ include('part/header.tpl', ['title' => 'My world']) }}

🎜 Wird in Vorlagen verwendet: 🎜rrreee🎜🎜🎜If-Anweisungsblock 🎜🎜if-Anweisung: 🎜rrreee🎜if else-Anweisung: 🎜rrreee🎜if . .elseif...else-Anweisung:🎜rrreee🎜🎜🎜For/Foreach-Anweisungsblock🎜🎜foreach:🎜rrreee🎜mit Schlüsseln:🎜rrreee🎜🎜🎜Kommentare zur Vorlage hinzufügen🎜 🎜Inhalte, die mit {{# und #}} umschlossen sind, werden als Kommentare ignoriert. 🎜rrreee🎜mehrzeilig:🎜rrreee🎜🎜🎜Filter verwenden🎜🎜Standardmäßige integrierte Filter:🎜🎜🎜upper – entspricht strtoupper🎜🎜lower – Äquivalent zu <code>strtolower🎜🎜nl – Zeilenumbruchzeichen anhängen n🎜🎜🎜🎜🎜Filterverwendungsbeispiel🎜🎜Sie können es finden in Verwenden Sie Filter in jeder Vorlage. 🎜🎜🎜Grundlegende Verwendung🎜:🎜rrreee🎜🎜Kettenverwendung🎜:🎜rrreee🎜🎜Nichtstatische Werte übergeben🎜:🎜rrreee🎜🎜Variablen als Filter übergeben. Parameter🎜:🎜rrreee🎜🎜🎜 Benutzerdefinierter Filter🎜rr reee 🎜Verwenden in Vorlagen:🎜rrreee🎜🎜🎜Benutzerdefinierte Direktiven🎜🎜Sie können Direktiven verwenden, um eine spezielle Logik zu implementieren. 🎜rrreee🎜In Vorlage verwenden: 🎜rrreee🎜🎜Github: github.com/phppkg/easytpl🎜

Empfohlenes Lernen: „PHP-Video-Tutorial“

Das obige ist der detaillierte Inhalt vonAusführliche Erläuterung der Funktionen sowie Installation und Nutzung von PHP EasyTpl. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!