PHP 模板引擎

Begindev 编辑部 April 1, 2026

模板（Templates）提供了一种非常便捷的方式，将你的**控制器（Controller）和业务域逻辑（Domain logic）与你的表现层逻辑（Presentation logic，即页面展示）**彻底分离开来。

通常情况下，模板包含了你应用程序的 HTML 代码，但它同样可以用于生成 XML 等其他格式的数据。在软件工程中，模板通常被称为“视图 (Views)”，它是经典的模型-视图-控制器 (MVC) 软件架构模式中第二个核心组件的重要组成部分。

1. 模板的优势 (Benefits)

使用模板最大的好处在于，它能在表现层逻辑和应用程序的其他部分之间划定一条清晰的界限。

模板拥有唯一的职责：显示格式化的内容。它们绝对不负责数据库查询、数据持久化或其他复杂的业务任务。这种分离带来了更加整洁、可读性更高的代码。在团队开发环境中，这一点尤为重要：后端开发者可以专心编写服务器端代码（控制器、模型），而前端设计师可以专注于客户端代码（HTML 标记），两者互不干扰。

此外，模板还能极大地改善表现层代码的组织结构。模板通常统一存放在一个名为 views 的文件夹中，每一个模板定义在一个单独的文件里。这种方法鼓励代码重用，我们可以将大块的代码拆分成更小、可重用的片段（通常称为“局部视图”或 partials）。例如，你可以将网站的页眉（header）和页脚（footer）分别定义为独立的模板，然后在每个页面模板的开头和结尾引入它们。

最后，根据你所使用的模板库的不同，模板还可以通过自动转义（escaping）用户生成的内容来提供更高的安全性。有些模板库甚至提供了“沙盒（sand-boxing）”机制，模板设计师只能访问白名单内被允许的变量和函数，从而防止恶意代码执行。

2. 原生 PHP 模板 (Plain PHP Templates)

原生 PHP 模板，顾名思义，就是直接使用原生 PHP 代码编写的模板。

这其实是一个非常自然的选择，因为 PHP 本身最初就是作为一种模板语言诞生的。这意味着你可以极其简单地将 PHP 代码与其他代码（比如 HTML）混合在一起。这对 PHP 开发者来说有很多好处：

零学习成本： 不需要学习任何新的模板语法。
得心应手： 开发者已经熟知所有可用的原生 PHP 函数。
编辑器支持： 代码编辑器天然自带完美的 PHP 语法高亮和自动补全功能。
极致性能： 原生 PHP 模板运行速度极快，因为它们不需要经历任何“编译”阶段。

目前，几乎每一个现代 PHP 框架都采用了某种模板系统，其中大多数默认使用的就是原生 PHP。在框架之外，也有诸如 Plates 或 Aura.View 这样的独立库。它们为原生 PHP 模板引入了现代化的模板功能，例如模板继承（inheritance）、布局（layouts）和扩展（extensions），让原生 PHP 模板的开发体验更上一层楼。

2.1 原生 PHP 模板的简单示例

以下是使用 Plates 库的一个基础示例：

<?php // user_profile.php (用户主页) ?>

<?php // 引入页眉，并传入标题变量 ?>
<?php $this->insert('header', ['title' => '用户个人资料']) ?>

<h1>用户个人资料</h1>
<p>你好，<?=$this->escape($name)?></p>

<?php // 引入页脚 ?>
<?php $this->insert('footer') ?>

2.2 使用继承的原生 PHP 模板示例

以下是使用 Plates 库实现模板继承的示例：

<?php // template.php (基础布局文件) ?>
<html>
<head>
    <title><?=$title?></title>
</head>
<body>
<main>
    <?=$this->section('content')?>
</main>
</body>
</html>

<?php // user_profile.php (子模板文件) ?>

<?php // 声明继承 'template' 布局，并传入标题变量 ?>
<?php $this->layout('template', ['title' => '用户个人资料']) ?>

<h1>用户个人资料</h1>
<p>你好，<?=$this->escape($name)?></p>

3. 编译型模板 (Compiled Templates)

虽然 PHP 已经演变成一门成熟的面向对象编程语言，但它作为一种“模板语言”而言，却并没有太大的进步。

编译型模板（例如 Twig、Brainy 或 Smarty*）填补了这一空白。它们提供了一套专为模板渲染而设计的全新语法。从自动转义、模板继承到简化的控制结构（如循环、判断），编译型模板的设计初衷就是让代码更容易编写、更干净易读、且更安全。

编译型模板甚至可以跨不同的编程语言共享使用，Mustache 就是一个极佳的例子。不过，由于这些模板最终需要被“编译”成原生 PHP 代码才能执行，因此会带来轻微的性能损耗；但是，只要正确配置了缓存（caching），这种性能损耗是微乎其微的。

* 安全提示：虽然 Smarty 提供了自动转义功能，但此功能默认是未开启的，需要开发者手动配置开启！

3.1 编译型模板的简单示例

以下是使用 Twig 库的一个基础示例：

{# include 引入页眉并传递变量 #}
{% include 'header.html' with {'title': '用户个人资料'} %}

<h1>用户个人资料</h1>
{# 使用双大括号输出变量 #}
<p>你好，{{ name }}</p>

{# include 引入页脚 #}
{% include 'footer.html' %}

3.2 使用继承的编译型模板示例

以下是使用 Twig 库实现模板继承的示例：

{# template.html (基础布局文件) #}

<html>
<head>
    {# 定义一个名为 title 的区块 #}
    <title>{% block title %}{% endblock %}</title>
</head>
<body>

<main>
    {# 定义一个名为 content 的区块 #}
    {% block content %}{% endblock %}
</main>

</body>
</html>

{# user_profile.html (子模板文件) #}

{# 声明继承 template.html 布局 #}
{% extends "template.html" %}

{# 覆盖 title 区块 #}
{% block title %}用户个人资料{% endblock %}

{# 覆盖 content 区块 #}
{% block content %}
    <h1>用户个人资料</h1>
    <p>你好，{{ name }}</p>
{% endblock %}

4. 延伸阅读 (Further Reading)

为了帮助你更深入地掌握 PHP 模板技术，我们整理了以下优质的学习资源和流行的开源库。