ThinkPHP 템플릿 엔진 구현 및 일반적인 문제

템플릿 엔진의 유래

PHP로 WEB 애플리케이션을 개발하는 초기에는 PHP 코드와 HTML 템플릿이 혼합되어 있었습니다. 템플릿 엔진의 탄생은 주로 백엔드와 프론트엔드의 완전한 분리를 해결하는 것이었습니다. 이제는 실제로는 불완전한 분리인 것 같습니다)) 문제를 해결하여 개발자와 아티스트가 함께 작업할 수 있도록 하고(실제로 최종 템플릿 작업의 대부분은 여전히 ​​백엔드 개발자가 수행하지만) 이를 통해 개발 효율성이 향상되고 유지 관리가 용이해집니다.

PHP의 급속한 성장과 함께 점점 더 많은 템플릿 엔진이 있지만 크게 해석형과 컴파일형의 두 가지 유형으로 나뉩니다. 현재 주류 템플릿 엔진의 대부분은 컴파일됩니다. 즉, 템플릿이 PHP로 컴파일됩니다. 먼저 파일 실행은 템플릿 파일 자체가 변경되지 않는 한 이전 Smarty와 같이 다시 컴파일할 필요가 없습니다. 해석된 템플릿 엔진은tinybutstrong과 같이 실행될 때마다 템플릿 구문 분석 프로세스를 수행합니다.

ThinkPHP는 처음부터 XML 태그 라이브러리 기술을 기반으로 하는 컴파일된 템플릿 엔진을 내장하고 있으며 초기에 Struts에서 참조되었으며 새로운 아이디어를 흡수하여 지속적으로 발전하고 있습니다.

템플릿 엔진을 선택하는 방법

현재 주류 프레임워크에는 템플릿 엔진 구성 요소가 함께 제공되거나 템플릿 엔진 구현을 캡슐화하므로 기능과 안정성이 보장된 내장 솔루션을 선택하는 것이 최선의 선택입니다. 현재 가장 널리 사용되는 템플릿 엔진은 Laravel의 자체 Blade 템플릿 엔진과 Symfony의 자체 Twig 템플릿 엔진입니다.

템플릿 엔진 확장 기능을 설치하면 ThinkPHP에서 Angular, Twig, Blade 등의 템플릿 엔진을 쉽게 사용할 수 있고, 템플릿 엔진을 전혀 사용하지 않고도 PHP 파일을 직접 템플릿으로 사용할 수도 있습니다.

최근 3대 프론트엔드 프레임워크(React/Vue/Angular)의 인기로 인해 점차 프론트엔드와 백엔드의 분리 개발이 주류가 되었습니다. 따라서 ThinkPHP5.0부터는 API 개발을 위해 설계되었기 때문에 템플릿 엔진의 개념이 약화되었습니다. ThinkPHP 버전 5.1의 템플릿 엔진은 내부 재구성을 거쳐 템플릿 태그를 더 쉽게 사용하고 PHP 구문에 더 가깝게 만들었습니다.

적어도 대부분의 새로운 애플리케이션의 경우 보다 주류인 프런트엔드와 백엔드 분리 설계를 선택하여 서버에 가해지는 부담을 최대한 줄이고 프런트엔드와 백엔드를 별도로 테스트하기가 더 쉽도록 해야 합니다. 시장에서 Vue 및 ThinkPHP를 사용하는 제품을 우연히 보게 될 것입니다(ThinkPHP Developer Weekly의 이전 호에서는 여러 가지에 대해 보고했습니다). 일부 오래된 프로젝트, 특히 콘텐츠 관리 제품을 유지 관리하는 경우 템플릿 엔진을 계속 사용할 수 있습니다.

이러한 상황을 고려하여 ThinkPHP 프레임워크의 다음 버전에는 템플릿 엔진이 내장되어 있지 않지만 템플릿 엔진을 사용해야 하는 개발자는 특정 용도로 공식 독립적인 think-template 클래스 라이브러리를 계속 사용할 수 있습니다. 이 글을 참고해주세요.

다음 섹션에서는 ThinkPHP에 내장된 템플릿 엔진의 사용 및 기술을 주로 요약합니다.

템플릿 실행 과정

시스템 내 템플릿 엔진 호출 관계는 다음과 같습니다.

视图（View） <=> 模板驱动（Driver） <=> 模板引擎（Template）

뷰와 템플릿 엔진 사이에 드라이버 레이어가 추가되어 다른 템플릿 엔진을 쉽게 교체할 수 있습니다. 일반적으로 우리가 컨트롤러에서 호출하는 할당/가져오기 및 기타 메소드는 실제로 호출되는 thinkView 클래스의 메소드입니다. 물론 필요하다면 컨트롤러에서 템플릿 엔진 클래스를 직접 조작할 수도 있지만, 다른 템플릿 엔진으로 전환하는 것은 불편하다.

가져오기 메서드를 예로 들어 최종 호출 프로세스를 살펴보겠습니다.

think\Controller->fetch();
think\View->fetch();
think\view\driver\Think->fetch();
think\Template->fetch();

가져오기 메서드를 호출할 때 렌더링할 전체 템플릿 파일 이름을 전달하지 않으면 자동으로 파일을 식별합니다. 세 번째 단계에서 렌더링됩니다.

분명히 가장 중요한 단계는 마지막 단계입니다. 템플릿 컴파일 및 실행 과정은 모두

think\Template->fetch();

방법으로 완료됩니다. 이 링크는 크게 여러 프로세스로 나눌 수 있습니다.

1. 페이지 렌더링 캐시 결정 및 읽기

현재 템플릿에 페이지 출력 캐시가 설정되어 렌더링 및 출력된 경우 캐시의 출력 콘텐츠를 직접 읽고 출력합니다.

if (!empty($this->config['cache_id']) && $this->config['display_cache'])
 {
    // 读取渲染缓存
    $cacheContent = $cache->get($this->config['cache_id']);

    if (false !== $cacheContent) {
        echo $cacheContent;
        return;
    }
}

2. 템플릿 파일 찾기

실제 템플릿 파일 위치 지정 작업은 템플릿 엔진 클래스의parseTemplateFile 메서드에 의해 구현됩니다. 파일이 존재하지 않으면 템플릿 파일이 존재하지 않는다는 예외가 발생합니다.

$template = $this->parseTemplateFile($template);

3. 컴파일 캐시 확인

현재 템플릿 파일이 컴파일된 경우 캐시가 여전히 유효한지 판단됩니다. 구문 분석을 반복하고 캐시된 구문을 직접 읽을 필요가 없습니다. 콘텐츠. 이는 checkCache 메소드에 의해 수행됩니다.

if (!$this->checkCache($cacheFile)) {
    // 缓存无效 重新模板编译
    $content = file_get_contents($template);
    $this->compiler($content, $cacheFile);
}

4. 템플릿 컴파일 및 캐싱

이 단계는 템플릿 엔진의 핵심 링크이자 가장 복잡한 기능으로 주로 현재 템플릿 파일의 템플릿 태그 구문을 PHP 실행 파일로 구문 분석합니다. 그런 다음 템플릿 구문 분석 캐시 파일을 생성합니다. 이는 정규식 대체 기술을 많이 사용하는 소위 템플릿 "컴파일"입니다. 정규식 구문 분석에는 특정 성능 오버헤드가 있지만 다중 호출 캐시의 이점이 있습니다. 한 번의 구문 분석 후에는 기본적으로 템플릿 구문 분석의 성능 오버헤드가 실제 성능에 영향을 미치지 않는다는 것이 원칙입니다.

템플릿 컴파일 방법의 핵심 코드는 구문 분석 방법입니다. 구문 분석 방법은 템플릿 파일의 태그를 구문 분석한 다음 이를 컴파일 캐시 파일에 쓰는 역할을 합니다. 컴파일 캐시는 기본적으로 파일 캐시를 사용하며 확장을 지원합니다. .

5. 컴파일 캐시 읽기

模板编译的过程只是生成了模板编译缓存文件，并没有真正载入模板，这一步骤就是载入模板编译缓存，然后导入模板变量。实现方法可以参考think\template\driver\File类的read方法。

public function read($cacheFile, $vars = []){
    $this->cacheFile = $cacheFile;

    if (!empty($vars) && is_array($vars)) {
        // 模板阵列变量分解成为独立变量
        extract($vars, EXTR_OVERWRITE);
    }

    //载入模版缓存文件
    include $this->cacheFile;
}

6、缓存页面输出

如果当前模板渲染的时候开启了页面输出缓存，就会这一步生成页面渲染后的输出缓存。

模板编译原理

我们来了解下ThinkPHP的模板引擎的实现原理。前面提到过，ThinkPHP的模板引擎最早源于Struts的设计理念，基于XML和标签库的技术实现。在设计模板语言的时候使用系统固定的标签来实现普通的变量输出功能（所以称之为普通标签），而利用XML标签库技术实现的动态标签用于变量的控制或者条件判断输出。

普通标签的解析是由think\Template类的parseTag方法完成的，主要实现了下面几个模板功能：

变量输出（包括系统变量）；

函数过滤；

变量运算；

三元运算；

执行函数以及输出结果；

模板注释；

标签库采用的是动态扩展的设计方案，采用了类似XML的闭合/开放定义方式（这个其实也是目前模板引擎的一个局限所在），例如下面的这个：

// 闭合类型标签
<tagLib:tagName name="value" >...</tagLib:tagName>
// 开放类型标签
<tagLib:tagName name="value" />

tagLib就代表了一个标签库（类），后面的tagName标签就表示该标签库下面的某个标签（通常对应了标签库类的某个方法），后面的属性就是该标签支持的属性定义。具体该标签的属性和功能则完全由标签库类的这个方法来决定。

可以在模板开头明确指出，当前模板使用了哪些标签库

{taglib name="html,article" /}

所以要扩展模板引擎的功能只需要通过扩展一个标签库类就可以了。大多数的内容管理系统都会定义一套自己的模板二次开发标签，利用标签库功能就可以很方便的定义一套属于自己的标签功能。

系统内置了一套标签库Cx，主要用于文件包含、条件控制、循环输出等功能。内置标签库在使用的时候无需引入，而且在使用的时候可以省略标签库前缀，例如：

{foreach $list as $key=>$vo } 
    {$vo.id}:{$vo.name}{/foreach}

这个模板语法相信PHP开发的很容易上手，上面的标签解析由think\template\taglib\Cx类的tagForeach方法完成，该方法的返回值是一个字符串，其实就是最终会解析成的一段包含变量的PHP可执行代码。

到这里，模板引擎的执行过程和原理现在基本就明白了，剩下的就是模板标签的解析细节，考验的就是正则表达式的掌握程度了。本文就不做深入了，有兴趣的朋友可以去看一些正则表达式的相关资料（例如这本《正则指引》，开发者周刊第14期也提供了一些在线的正则工具）。

遵循的原则

使用模板引擎，要尽量遵循几个重要的原则。

不要在模板文件中添加任何的业务逻辑

模板的作用主要是进行模板变量的控制和输出，不要在模板文件中添加业务逻辑代码。

明确指定渲染模板

养成明确指定渲染模板的好习惯，避免当方法名发生变化，或者被其它方法调用的时候发生错误。也不易受模板命名规范的影响。

变量统一赋值

使用assign方法或者在view助手函数的时候，统一一次传入模板变量。不要多次赋值，以免混乱。

系统变量无需赋值到模板

对于系统变量（包括请求变量、$_SESSION和$_SERVER等系统变量）无需进行模板变量赋值，可以直接在模板中输出。

常见问题

这里总结一下经常会遇到的一些常见问题。

修改定界符

可以通过模板配置文件修改模板标签的定界符。

例如，修改普通标签定界符

'tpl_begin'          => '{{', // 模板引擎普通标签开始标记
'tpl_end'            => '}}', // 模板引擎普通标签结束标记

标签库标签定界符

&#39;taglib_begin&#39;       => &#39;<{&#39;, // 标签库标签开始标记
&#39;taglib_end&#39;         => &#39;}>&#39;, // 标签库标签结束标记

保持原样输出

如果担心模板标签和JS代码产生混淆，可以使用literal标签

{literal} Hello,{$name}！ {/literal}

页面最终会直接输出Hello,{$name}！

避免输出转义

5.1版本为了避免XSS攻击，默认对模板变量的输出使用了安全转义，默认的转义函数是htmlentities，你可以通过更改default_filter配置改变默认的转义函数。

如果你不需要对某个模板变量输出进行转义（例如包含了HTML代码），可以使用：

{$data.content|raw}

分页输出就是一个需要输出HTML的典型例子，因此必须增加|raw。

关于模板主题

新版取消了原来的模板主题功能，因为模板主题对模板引擎来说，其实无非是一个模板目录，完全可以根据自己的需求控制。

例如

$theme = 'blue';$this->fetch('/' . $theme. '/user/index');

或者动态设置模板引擎的view_path参数

$this->view->config('view_path', \think\facade\App::getModulePath(). 'view/'. $theme . '/');

如何关闭模板缓存

由于是编译型模板引擎，模板标签不能被直接执行，必须编译成PHP语法后才能执行，因此不能关闭模板编译缓存，模板引擎每次执行渲染的时候会检测模板文件是否有变化，当模板文件的修改时间超过模板编译缓存的修改时间后，模板引擎会自动更新编译缓存。

但你可以强制模板引擎每次都重新编译，只需要在配置文件中设置

'tpl_cache'          => false, // 关闭模板缓存

使用PHP作为模板引擎

如果不希望使用内置的模板引擎，直接使用PHP作为模板引擎，可以配置

 'type'         => 'php',

配置使用PHP作为模板引擎的话，是不会生成模板编译缓存的。

如何使用第三方模板引擎

系统支持扩展其它的第三方模板引擎，你只需要开发一个模板引擎驱动，目前已经支持的第三方模板引擎包括Smarty、Twig和Blade。

如何跨模块输出模板

要渲染一个跨模块的模板文件，你需要使用

// 渲染user模块的模板文件

$this->fetch('User@order/index');

是否支持变量运算

可以直接在模板文件中进行变量运算而不需要在控制器中进行运算后再赋值都模板变量输出。

{$score1+$score2}
{$count++}

文件包含是否支持变量

include标签可以支持传入变量，但只能使用

{include file="$file" /}

而不能使用

{include file="file_$name" /}

可以支持模板输出替换么

支持两个方式对模板进行输出替换，如果需要对模板文件的内容进行替换，可以配置：

'tpl_replace_string'  =>  [
    '__STATIC__'=>'/static',
'__JS__' => '/static/javascript',
]

如果是对模板渲染输出的内容进行替换，可以在控制器中使用视图过滤功能：

public function index(){
    // 使用视图输出过滤
    return $this->filter(function($content){
    return str_replace("\r\n",&#39;<br/>&#39;,$content);
    })->fetch();
}

模板继承的block是否支持嵌套

目前模板继承的block无法支持嵌套功能，你应该使用其它方式解决。

위 내용은 ThinkPHP 템플릿 엔진 구현 및 일반적인 문제의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!