Smarty 是一个老牌、稳定、轻量的 PHP 模板引擎，通过自动转义变量防 XSS、简洁模板语法、支持缓存与插件，实现逻辑与界面分离；三步即可运行：引入类、配置路径、assign 数据并 display 模板。
PHP 直接拼接 HTML 容易混乱，Smarty 这类模板引擎能帮你把逻辑和界面干净分开——PHP 文件只管数据处理，.tpl 文件专注展示，维护和协作都更轻松。
Smarty 是什么？为什么用它？
Smarty 是一个老牌、稳定、轻量的 PHP 模板引擎。它不强制你改写业务逻辑，只是在输出层加了一层“安全又清晰”的隔离：
- 自动转义变量（防 XSS，默认开启），比如
{$username}会自动过滤 HTML 标签 - 模板语法简洁：
{$name}输出变量，{if $age > 18}成年{/if}写条件，不用写 - 支持缓存、插件、自定义函数，但基础用法几行代码就能跑起来
- 设计师可直接编辑 .tpl 文件，无需懂 PHP 语法
三步跑通第一个 Smarty 页面
假设项目结构如下：
/project /libs/ ← Smarty 核心放这里（下载后解压的 libs/） /templates/ ← .tpl 文件放这里（如 index.tpl） /templates_c/ ← 编译后的 PHP 文件，需可写（755 或 777） /cache/ ← 可选，缓存目录，也需可写 index.php ← 入口文件
步骤如下：
立即学习“PHP免费学习笔记（深入）”；
启科网络PHP商城系统
下载
启科网络商城系统由启科网络技术开发团队完全自主开发，使用国内最流行高效的PHP程序语言，并用小巧的MySql作为数据库服务器，并且使用Smarty引擎来分离网站程序与前端设计代码，让建立的网站可以自由制作个性化的页面。 系统使用标签作为数据调用格式，网站前台开发人员只要简单学习系统标签功能和使用方法，将标签设置在制作的HTML模板中进行对网站数据、内容、信息等的调用，即可建设出美观、个性的网站。
- 下载 Smarty（推荐 3.x 版本），把
libs/复制到项目中 - 创建
index.tpl（放在/templates/）：欢迎，{$name}！
今天是 {$today|date_format:"%Y年%m月%d日"}
- 在
index.php中初始化并分配数据：
php
require './libs/Smarty.class.php';
$smarty = new Smarty();
$smarty->setTemplateDir('./templates/');
$smarty->setCompileDir('./templates_c/');
$smarty->assign('name', '小明');
$smarty->assign('today', time());
$smarty->display('index.tpl');
?>
常用模板语法速查
写 .tpl 时不用 PHP 标签，记住这几个就够日常开发：
-
输出变量：
{$title}，支持默认值{$intro|default:"暂无介绍"} -
格式化输出：
{$price|number_format:2:",":"."}→ 1234.56 -
条件判断：
{if $score >= 90}优秀{elseif $score >= 60}及格{else}不及格{/if} -
循环列表：
{foreach $users as $user}{$user.name} ({$user.age}){/foreach} -
包含子模板：
{include file="header.tpl" title="首页"}
调试与常见问题
刚上手容易卡在路径或权限，快速排查：
- 报错 “unable to write to $compile_dir” → 检查
templates_c/是否可写（Linux 下chmod 755 templates_c） - 页面空白，没报错 → 开启 Smarty 调试模式：
$smarty->debugging = true;，右下角会出现调试窗口 - 变量不显示 → 确认
assign()的键名和模板里{$xxx}完全一致（区分大小写） - 中文乱码 → 确保 PHP 文件、.tpl 文件都用 UTF-8 无 BOM 编码保存
基本上就这些。Smarty 不复杂但容易忽略细节，先跑通一个例子，再慢慢加功能，比硬啃文档快得多。
