Smarty 中按页面动态分配模板变量的实践指南-php教程-PHP中文网

Smarty 中按页面动态分配模板变量的实践指南

本文介绍如何在 smarty 模板引擎中实现“按需分配变量”，避免在主入口文件中集中管理所有页面变量，通过分离页面逻辑与模板渲染，提升代码可维护性与可扩展性。

本文介绍如何在 smarty 模板引擎中实现“按需分配变量”，避免在主入口文件中集中管理所有页面变量，通过分离页面逻辑与模板渲染，提升代码可维护性与可扩展性。

在使用 Smarty 构建基于 $_GET['page'] 路由的单入口 Web 应用时，一个常见痛点是：将所有页面的变量（如 title、varA、varID）全部堆砌在 index.php 中，导致逻辑混乱、难以维护，且违背关注点分离原则。理想方案应是——每个页面（如 Home、Create）拥有专属的变量初始化逻辑，与模板一一对应，互不干扰。

✅ 推荐实践：页面专属 PHP 控制器文件

Smarty 本身不提供自动按模板名加载对应变量逻辑的功能（例如访问 ?page=Home 时自动执行 Home.php），但可通过轻量级约定 + PHP include 实现清晰解耦。核心思路是：主入口（index.php）负责初始化 Smarty 实例与公共配置；各页面由独立 .php 文件负责分配其专属变量并调用 display()。

示例结构

/  
├── index.php          ← 主入口，初始化 Smarty  
├── home.php           ← Home 页面逻辑（assign + display）  
├── create.php         ← Create 页面逻辑  
├── templates/  
│   ├── Home.tpl  
│   └── Create.tpl  
├── templates_c/       ← 编译缓存目录（自动生成）  
└── cache/             ← 运行时缓存目录（可选）

`index.php`（精简版）

<?php require 'smarty-4.2.0/libs/Smarty.class.php';
$smarty = new Smarty();

$smarty->setTemplateDir('templates');
$smarty->setCompileDir('templates_c');
$smarty->setCacheDir('cache');
$smarty->setConfigDir('configs');

// 公共变量（所有页面共享）
$smarty->assign('site_name', 'My App');

// 路由分发：根据 $_GET['page'] 加载对应控制器
$page = $_GET['page'] ?? 'home';

switch ($page) {
    case 'home':
        include 'home.php';
        break;
    case 'create':
        include 'create.php';
        break;
    default:
        $smarty->assign('title', '404 Not Found');
        $smarty->display('error.tpl');
        exit;
}

`home.php`（页面专属逻辑）

<?php // 此处仅处理 Home 页面所需变量
$smarty->assign('title', 'Home page');
$smarty->assign('varA', 'text text text');

// 渲染对应模板（注意：.tpl 后缀已由 Smarty 自动补全）
$smarty->display('Home.tpl');

`create.php`

<?php $smarty->assign('title', 'Create page');
$smarty->assign('varID', 33442222244);

$smarty->display('Create.tpl');

? 关于 `templates_c/` 目录的说明

templates_c/ 是 Smarty 的编译缓存目录，并非手动维护的 PHP 文件存放地。当 Smarty 首次解析 Home.tpl 时，会将其编译为高度优化的原生 PHP 代码（如 Home.tpl.php），并存入该目录。后续请求直接执行此编译后文件，大幅提升性能。
⚠️ 注意：

你无需、也不应手动编辑 templates_c/ 中的文件——它们由 Smarty 自动生成与更新；
cache/ 目录用于存储开启 caching = true 后的完整 HTML 输出缓存，与 templates_c/ 的编译缓存职责不同；
若修改了 .tpl 模板，Smarty 在开发模式下（$smarty->debugging = true; 或 force_compile = true）会自动重新编译，确保模板变更即时生效。

✅ 最佳实践建议

命名一致性：PHP 控制器文件（home.php）与模板文件（Home.tpl）保持语义关联，便于团队理解；
错误防御：在 switch 中加入 default 分支，防止非法 page 参数导致白屏；
安全加固：对 $_GET['page'] 做白名单校验（如 in_array($page, ['home','create'])），禁止路径遍历或任意文件包含；
进阶方向：未来可封装为简易路由类或集成 PSR-7 兼容框架（如 Slim + Smarty），进一步标准化。