Implémentation du moteur de modèles ThinkPHP et problèmes courants-tutoriel php-php.cn

Origine du moteur de modèles

Au début du développement d'applications WEB en PHP, le code PHP et les modèles HTML étaient mélangés. La naissance du moteur de modèles était principalement destinée à résoudre le problème complet. problème de séparation du back-end et du front-end (maintenant, il semble que ce soit en fait une séparation incomplète), de sorte que le développement et les artistes peuvent se diviser et coopérer (bien qu'en fait, la plupart du travail de modèle final soit encore complété par le back-end). développeurs finaux), améliorant ainsi l’efficacité du développement et facilitant la maintenance.

Avec la croissance rapide de PHP, il existe de plus en plus de moteurs de modèles, mais ils sont grossièrement divisés en deux types : interprétés et compilés. La plupart des moteurs de modèles traditionnels actuels sont compilés, c'est-à-dire qu'ils seront d'abord compilés. Le modèle est compilé dans un fichier PHP pour exécution. Tant que le fichier modèle lui-même ne change pas, il n'est pas nécessaire de le recompiler, comme l'ancien Smarty. Un moteur de modèle interprété effectuera un processus d'analyse de modèle à chaque fois qu'il est exécuté, comme tinybutstrong.

ThinkPHP a intégré dès le début un moteur de modèles compilé basé sur la technologie de bibliothèque de balises XML. Il a été référencé dès le début à partir de Struts et évolue constamment en absorbant de nouvelles idées.

Comment choisir un moteur de modèles

Actuellement, les frameworks grand public sont livrés avec des composants de moteur de modèles ou encapsulent la mise en œuvre de moteurs de modèles, le choix d'une solution intégrée est donc la solution Le meilleur choix, la fonctionnalité et la stabilité sont garantis. Actuellement, les moteurs de modèles les plus populaires sont le moteur de modèles Blade de Laravel et le moteur de modèles Twig de Symfony.

En installant l'extension du moteur de modèles, vous pouvez facilement utiliser des moteurs de modèles, notamment Angular, Twig et Blade dans ThinkPHP, ou même utiliser des fichiers PHP directement comme modèles sans utiliser de moteur de modèles du tout.

En raison de la popularité des trois principaux frameworks front-end (React/Vue/Angular) ces dernières années, le développement séparé du front-end et du back-end est progressivement devenu courant. Par conséquent, ThinkPHP5.0 est devenu courant. a été positionné pour le développement d'API, ce qui a conduit à un affaiblissement du concept de moteur de modèles. Le moteur de modèles de ThinkPHP version 5.1 a subi une reconstruction interne, rendant les balises de modèles plus faciles à utiliser et plus proches de la syntaxe PHP.

Au moins pour la plupart des nouvelles applications, vous devriez choisir une conception de séparation front-end et back-end plus courante afin de réduire autant que possible la pression sur le serveur et de faciliter les tests des front-end et back-end. séparément. Vous verrez par inadvertance des produits utilisant Vue et ThinkPHP sur le marché (les numéros précédents de ThinkPHP Developer Weekly en ont fait état de plusieurs). Si vous gérez certains anciens projets, notamment des produits de gestion de contenu, vous pouvez toujours utiliser des moteurs de modèles.

Compte tenu de cette situation, la prochaine version du framework ThinkPHP n'aura pas de moteur de modèle intégré, mais les développeurs qui ont besoin d'utiliser le moteur de modèle peuvent toujours utiliser la bibliothèque de classes think-template indépendante officielle. Pour une utilisation spécifique, veuillez vous référer à cet article.

Dans les sections suivantes, nous résumerons principalement l'utilisation et les techniques du moteur de modèles intégré de ThinkPHP.

Processus d'exécution du modèle

La relation d'appel du moteur de modèle au sein du système est la suivante :

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

Copier après la connexion

Une couche de pilote est ajoutée entre la vue et le moteur de modèles, afin qu'il puisse être facilement remplacé par d'autres moteurs de modèles. Habituellement, les méthodes assign/fetch et autres que nous appelons dans le contrôleur sont en fait les méthodes de la classe thinkView appelée. Bien sûr, si nécessaire, vous pouvez également utiliser directement la classe du moteur de modèle dans le contrôleur, mais il n'est pas pratique de passer à d'autres moteurs de modèle.

Prenons la méthode fetch comme exemple. Jetons un coup d'œil au processus d'appel final :

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

Copier après la connexion

Si vous ne transmettez pas le nom complet du fichier modèle à afficher lorsque vous appelez. la méthode fetch, ce sera Dans la troisième étape, le fichier modèle à restituer est automatiquement identifié.

Évidemment, l'étape la plus critique est la dernière étape. Le processus de compilation et d'exécution du modèle est entièrement complété par la méthode

think\Template->fetch();

Copier après la connexion

Ce lien peut être grossièrement divisé en plusieurs processus.

1. Déterminez et lisez le cache de rendu de page

Si le modèle actuel a un cache de sortie de page défini et a été rendu et affiché, si tel est le cas, le contenu de sortie dans le cache sera lu et sortie directement.

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

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

Copier après la connexion

2. Localisez le fichier modèle

L'opération de positionnement du fichier modèle réelle est implémentée par la méthode parseTemplateFile de la classe du moteur de modèle. méthode de la classe du pilote de vue, si le fichier modèle final n’existe pas, une exception de fichier modèle n’existe pas sera levée.

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

Copier après la connexion

3. Déterminez le cache de compilation

Si le fichier modèle actuel a été compilé, il sera jugé si le cache est toujours valide. S'il est valide, ce n'est pas nécessaire. pour répéter l'analyse et lire directement le contenu d'analyse mis en cache. Cela se fait par la méthode checkCache.

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

Copier après la connexion

4. Compilation et mise en cache des modèles

Cette étape est la partie centrale du moteur de modèles et la fonction la plus complexe. Elle est complétée par la méthode du compilateur, qui analyse principalement le courant. modèle. La syntaxe des balises de modèle dans le fichier est du code exécutable PHP, puis un fichier cache d'analyse de modèle est généré, qui est ce qu'on appelle la "compilation" de modèle, qui utilise de nombreuses technologies de remplacement d'expressions régulières. une certaine surcharge de performances, Grâce au principe de mise en cache consistant à analyser plusieurs appels une fois, fondamentalement, la surcharge de performances de l'analyse du modèle n'affectera pas les performances réelles.

Le code clé de la méthode de compilation du modèle est la méthode d'analyse. La méthode d'analyse est chargée d'analyser les balises dans le fichier modèle, puis de les écrire dans le fichier cache de compilation. par défaut et prend en charge l’expansion.

5. Lire le cache de compilation

模板编译的过程只是生成了模板编译缓存文件，并没有真正载入模板，这一步骤就是载入模板编译缓存，然后导入模板变量。实现方法可以参考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;
}

Copier après la connexion

6、缓存页面输出

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

模板编译原理

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

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

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

函数过滤；

变量运算；

三元运算；

执行函数以及输出结果；

模板注释；

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

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

Copier après la connexion

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

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

{taglib name="html,article" /}

Copier après la connexion

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

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

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

Copier après la connexion

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

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

遵循的原则

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

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

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

明确指定渲染模板

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

变量统一赋值

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

系统变量无需赋值到模板

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

常见问题

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

修改定界符

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

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

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

Copier après la connexion

标签库标签定界符

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

Copier après la connexion

保持原样输出

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

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

Copier après la connexion

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

避免输出转义

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

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

{$data.content|raw}

Copier après la connexion

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

关于模板主题

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

例如

$theme = &#39;blue&#39;;$this->fetch(&#39;/&#39; . $theme. &#39;/user/index&#39;);

Copier après la connexion

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

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

Copier après la connexion

如何关闭模板缓存

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

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

&#39;tpl_cache&#39;          => false, // 关闭模板缓存

Copier après la connexion

使用PHP作为模板引擎

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

 &#39;type&#39;         => &#39;php&#39;,

Copier après la connexion

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

如何使用第三方模板引擎

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

如何跨模块输出模板

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

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

$this->fetch(&#39;User@order/index&#39;);

Copier après la connexion

是否支持变量运算

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

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

Copier après la connexion

文件包含是否支持变量

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

{include file="$file" /}

Copier après la connexion

而不能使用

{include file="file_$name" /}

Copier après la connexion

可以支持模板输出替换么

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

&#39;tpl_replace_string&#39;  =>  [
    &#39;__STATIC__&#39;=>&#39;/static&#39;,
&#39;__JS__&#39; => &#39;/static/javascript&#39;,
]

Copier après la connexion

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

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

Copier après la connexion

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

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

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!