php 模板 怎么用_PHP模板引擎（Smarty/Twig）使用方法

Smarty和Twig是PHP中实现视图与逻辑分离的主流模板引擎。首先，通过Composer安装各自库，然后配置模板路径并创建实例；Smarty使用assign赋值、display渲染，模板中用{$var}输出变量；Twig需初始化Environment和Loader，通过render传递数据，模板使用{{ var }}显示内容。两者均支持条件判断与循环：Smarty用{if}{/if}和{foreach}，Twig用{% if %}{% endif %}和{% for %}{% endfor %}，建议避免在模板写复杂逻辑。此外，都支持模板继承与布局复用：Twig通过{% extends %}和{% block %}定义可复用结构，Smarty可通过插件或include实现公共部分引用，提升开发效率与维护性。

如果您在开发 PHP 项目时希望实现视图与逻辑的分离，提升代码可维护性，可以使用模板引擎来渲染页面。以下是关于 Smarty 和 Twig 两种主流 PHP 模板引擎的具体使用方法：

一、Smarty 模板引擎的基本使用

Smarty 是一个成熟的 PHP 模板引擎，它通过将业务逻辑与 HTML 页面分离，使前端开发和后端开发可以独立进行。其核心机制是将 PHP 变量赋值给模板，并在 .tpl 文件中使用标签进行展示。

1、安装 Smarty 可通过 Composer 执行命令：composer require smarty/smarty。

2、创建实例对象并设置模板目录、编译目录、缓存目录等路径，例如：

立即学习“PHP免费学习笔记（深入）”；

$smarty = new Smarty();

$smarty->setTemplateDir(‘templates/’);

$smarty->setCompileDir(‘templates_c/’);

$smarty->setCacheDir(‘cache/’);

3、在 PHP 文件中分配变量，如：$smarty->assign(‘name’, ‘John’);。

4、在模板文件 name.tpl 中使用 {$name} 输出变量内容。

5、最后调用 $smarty->display(‘name.tpl’); 渲染输出页面。

二、Twig 模板引擎的基本使用

Twig 是由 Symfony 项目推出的高性能模板引擎，语法简洁且安全，支持模板继承、过滤器和函数等功能，适合现代 PHP 应用开发。

1、使用 Composer 安装 Twig：composer require twig/twig。

2、初始化 Environment 对象，配置 Loader 路径：

$loader = new \Twig\Loader\FilesystemLoader(‘templates’);

$twig = new \Twig\Environment($loader);

3、在 PHP 中传递数据到模板，例如：

echo $twig->render(‘index.html.twig’, [‘title’ => ‘首页’, ‘content’ => ‘欢迎使用 Twig’]);

4、在 index.html.twig 模板中使用 {{ title }} 显示变量，也可使用 {% if %}、{% for %} 等控制结构。

5、可通过扩展函数或自定义过滤器增强模板功能，如添加日期格式化处理。

三、在模板中使用条件判断与循环

无论是 Smarty 还是 Twig，都支持在模板中进行逻辑控制，以动态生成 HTML 内容。

1、在 Smarty 中使用 {if $value > 10}…{else}…{/if} 实现条件判断。

2、使用 {foreach $list as $item}…{/foreach} 遍历数组。

3、在 Twig 中使用 {% if value > 10 %}…{% else %}…{% endif %} 控制流程。

4、使用 {% for item in list %}…{% endfor %} 进行循环输出。

5、注意避免在模板中编写复杂逻辑，保持模板清晰易读。

四、模板继承与布局复用

模板继承机制允许定义基础模板，并让其他页面继承该模板的结构，从而减少重复代码。

1、在 Twig 中创建 base.html.twig 文件，包含通用的 HTML 结构和 {% block content %}{% endblock %} 占位符。

2、子模板使用 {% extends “base.html.twig” %} 继承父模板。

3、通过 {% block content %}…{% endblock %} 覆盖指定区块内容。

4、Smarty 也支持类似功能，需启用模板继承插件或手动包含公共部分。

5、利用 include 指令可在不同模板间复用头部、侧边栏等组件。