PHP EasyTpl의 기능과 설치, 사용법에 대한 자세한 설명

                                                                                                                LEasytpl -간단하고 빠른 PHP 템플릿 엔진

간단하고 빠른 PHP 템플릿 엔진.

Features

간단하고 가볍고 빠릅니다.

학습 비용 없음

• 단순한 처리 및 네이티브 PHP 구문으로의 변환
  • PHP 네이티브 구문과 호환
  • 간단한 출력 구문. 예: {{= $var }} {{ $var }} {{ echo $var }}
  는 모든 제어 구문을 지원합니다. . 예를 들어 if,elseif,else;foreach;for;switch
• 는 배열 값에 대한 체인 액세스를 지원합니다. 예: {{ $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
더 안전하며 출력 결과는 기본적으로 htmlspecialchars를 통해 자동으로 처리됩니다

비활성화하거나 raw 필터를 수동으로 사용하지 않는 한

PHP 사용 지원 필터 기능이 내장되어 있습니다. 예: {{ $var | ucfirst }}

사용자 정의 필터 추가 지원기본 내장 필터: upper lower nl

사용자 정의 지침 추가 및 사용자 정의 기능 제공을 지원합니다.

템플릿에 주석 추가를 지원합니다. 예: {{# comments ... #}}

Installation

PHP 8.0+

composer

{{ '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 }}

🎜추가 사용 지침🎜🎜구문은 PHP 기본 템플릿과 동일하며, 사용하기 더 편리하도록 특수 구문이 추가되었습니다. 🎜🎜🎜EasyTemplate은 기본적으로 출력 필터링을 켜고 뷰 ​​템플릿을 렌더링하는 데 사용할 수 있습니다. 🎜🎜TextTemplate은 출력 필터링을 끄고 주로 텍스트 처리, 코드 생성, 🎜🎜🎜 🎜🎜구성 설정🎜

{{
    $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;
    });

🎜🎜기본적으로 htmlspecialchars 자동으로 전달됩니다 raw 필터를 비활성화하거나 수동으로 사용하지 않는 한 출력 결과는 처리됩니다. 🎜

🎜🎜출력 필터링을 비활성화하도록 설정 $t->disableEchoFilter( )🎜🎜템플릿 <code>{{ $name | raw }}🎜🎜🎜🎜🎜배열 값에 빠르게 액세스🎜🎜 .를 사용하여 출력 필터링을 비활성화할 수 있습니다. 배열 값에 빠르게 액세스합니다. 독창적인 글쓰기 방식도 가능하며, 간결한 글쓰기 방식은 자동으로 네이티브 글쓰기 방식으로 변환됩니다. 🎜

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

🎜 템플릿에 사용됨: 🎜rrreee🎜🎜🎜If 문 블록 🎜🎜if 문: 🎜rrreee🎜if else 문: 🎜rrreee🎜if. .elseif...else 문:🎜rrreee🎜🎜🎜For/Foreach 문 블록🎜🎜foreach:🎜rrreee🎜키 포함:🎜rrreee🎜🎜🎜템플릿에 댓글 추가🎜 🎜 {{# 및 #}}로 래핑된 콘텐츠는 주석으로 무시됩니다. 🎜rrreee🎜여러 줄:🎜rrreee🎜🎜🎜필터 사용🎜🎜기본 내장 필터:🎜🎜🎜upper - strtoupper🎜🎜lower - <code>strtolower🎜🎜nl와 동일 - 개행 문자 n🎜🎜🎜🎜🎜Filter 사용 예🎜🎜찾을 수 있습니다. 모든 템플릿에서 필터를 사용하세요. 🎜🎜🎜기본 사용법🎜:🎜rrreee🎜🎜체인 사용법🎜:🎜rrreee🎜🎜비정적 값 전달🎜:🎜rrreee🎜🎜변수를 필터 매개변수로 전달🎜:🎜rrreee🎜🎜🎜맞춤 필터🎜rr 🎜다음에서 사용 템플릿:🎜rrreee🎜🎜🎜사용자 지정 지시어🎜🎜 지시어를 사용하여 몇 가지 특별한 논리를 구현할 수 있습니다. 🎜rrreee🎜템플릿에서 사용: 🎜rrreee🎜🎜Github: github.com/phppkg/easytpl🎜

추천 학습: "PHP 비디오 튜토리얼"

위 내용은 PHP EasyTpl의 기능과 설치, 사용법에 대한 자세한 설명의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!