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      ← 入口文件

步骤如下：

• 下载 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 不复杂但容易忽略细节，先跑通一个例子，再慢慢加功能，比硬啃文档快得多。