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

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

# php # linux # html # 编码 # 中文乱码 # 解压 # 常见问题 # 格式化输出 # 为什么 # xss # if # foreach # include # require # 循环 # 类模板 # class # default # bom # display # 是一个 # 报错 # 三步 # 放在 # 暂无 # 第一个 # 就能 # 这类 # 自定义 # 数据处理

返回目录在线咨询

上一篇：jquery实现图片平滑滚动详解
下一篇：如何在2025年利用开源工具创建响应式网站设计

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。