PHP使用模板引擎基础教学_PHP与Smarty模板使用说明

舞夢輝影

发布时间：2025-12-15 20:43:35

630人浏览过

来源于php中文网

原创

Smarty 是一个老牌、稳定、轻量的 PHP 模板引擎，通过自动转义变量防 XSS、简洁模板语法、支持缓存与插件，实现逻辑与界面分离；三步即可运行：引入类、配置路径、assign 数据并 display 模板。

php使用模板引擎基础教学_php与smarty模板使用说明

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 编码保存