Smarty初始化必须手动设置模板目录和编译目录，否则因路径不存在或权限不足导致报错；变量名严格区分大小写且不可含点号；foreach需显式声明key/item别名；调试模式需手动启用且仅限开发环境。
Smarty 初始化必须手动设置模板目录和编译目录
不显式指定 $smarty->setTemplateDir() 和 $smarty->setCompileDir()，Smarty 会尝试使用默认路径（如 templates/ 和 templates_c/），但这些路径往往不存在或权限不足，导致报错 SmartyException: unable to write file 或 template not found。
实操建议：
- 确保模板目录（如
./templates/）存在且 Web 服务器用户（如 www-data、apache）有读取权限 - 编译目录（如
./templates_c/）必须可写，建议用chmod 755 templates_c或更严格地设为775并确认组属正确 - 初始化时强制指定路径，避免依赖默认行为：
$smarty = new Smarty(); $smarty->setTemplateDir(__DIR__ . '/templates/'); $smarty->setCompileDir(__DIR__ . '/templates_c/'); $smarty->setCacheDir(__DIR__ . '/cache/'); // 如启用缓存，同样需指定且可写
assign() 传值到模板后，变量名大小写敏感且不能含点号
在 PHP 中调用 $smarty->assign('user_name', $name)，模板里必须用 {$user_name}，写成 {$User_Name} 或 {$user.name} 都无法解析——Smarty 的变量命名规则是纯字母+数字+下划线，且严格区分大小写。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
友邻phpB2B电子商务系统是一套用PHP开发的B2B电子商务系统应用程序，本系统基于PHP+MySQL开发, 采用优秀的MVC架构思想，同时本系统采用了流行的Smarty模板技术，静态模板与动态程序完全分离，系统自带十余个内容丰富的调用标签，同时可自由扩展各种插件或其他功能，秉承开源、开放的原则，是目前搭建B2B行业门户网站最好的程序。安装说明首先请确保目录attachment、data、con
- 模板中显示空白，但 PHP 端已确认赋值成功 → 检查变量名拼写与大小写是否完全一致
- 误用点号访问数组或对象属性（如
{$data.user.id}）→ 实际应先在 PHP 层展开或用->语法（{$data->user->id}），或改用assign()传入扁平化变量 - 动态键名无法直接在模板中计算（如
{$arr.$key}可行，但{$arr.{$key}}语法错误）→ 需用{assign var="val" value=$arr[$key]}中转
foreach 循环中 key 和 item 别名必须显式声明
Smarty 的 {foreach} 不像 PHP foreach 那样自动推导键/值，漏写 key 或 item 别名会导致语法错误或意外输出。例如 {foreach $users as $u} 是非法的，必须写成 {foreach $users as $u} → 实际应为 {foreach $users as $u}？不对，Smarty 正确写法是：{foreach $users as $u} 也不对——它要求明确关键字：
{foreach $users as $u}
{$u.name}
{/foreach} 这种写法在 Smarty 3+ 是允许的（等价于 item=$u），但若需 key，必须显式写：{foreach $users key=$i item=$u}
[{$i}] {$u.name}
{/foreach}
使用场景提醒：
- 遍历关联数组时，不声明
key就拿不到键名；不声明item就拿不到值（哪怕只写item=$v也比省略安全） - 嵌套循环时别名容易冲突，比如外层用
$item，内层也用$item会导致覆盖 → 建议用语义化别名，如$category/$product - 空数组时
{foreach}不执行内容，无需额外判空，但若需 fallback 提示，得用{foreachelse}
开启调试控制台需手动启用且仅限开发环境
Smarty 自带的调试模板（按 Ctrl+Shift+I 弹出变量面板）不是默认打开的，必须调用 $smarty->debugging = true;，否则即使页面加载完成也看不到调试窗口。
但要注意：
- 生产环境绝对禁止开启
debugging，它会暴露全部已分配变量、配置、模板路径，构成信息泄露风险 - 如果用了
$smarty->enableDebugging(false)或部署时未注释掉该行，调试窗口不会出现，且无任何提示 - 某些 CDN 或反向代理可能拦截响应头中的
X-Debug相关字段，导致调试窗口不弹出 → 优先检查浏览器控制台是否有 JS 报错，再确认 PHP 端是否真正执行了$smarty->debugging = true
