Composer安装Smarty需正确配置路径与自动加载：先执行composer require smarty/smarty，再在入口文件引入vendor/autoload.php；初始化时必须用绝对路径设置setTemplateDir()和setCompileDir()，否则触发SmartyException。
Composer 本身不“安装 Smarty”，它只是下载并管理 Smarty 的 PHP 包；Smarty 也不依赖任何特定“框架”，它是一个独立的模板引擎。直接用 composer require smarty/smarty 就能装上，但要真正用起来，关键在初始化方式、模板路径配置和自动加载时机——这些地方最容易出 SmartyException 或 Uncaught Error: Class 'Smarty' not found。
如何用 Composer 正确引入 Smarty 类
Smarty 官方包已迁移到 smarty/smarty（不是旧版 smarty/smarty 的别名或 fork），且仅支持 PHP 7.2+。安装后必须确保 Composer 自动加载生效：
- 确认项目根目录存在
vendor/autoload.php，且你的入口脚本中已包含它：require __DIR__ . '/vendor/autoload.php';
- 不要手动
include或requireSmarty 的libs/Smarty.class.php—— Composer 已通过 PSR-4 映射处理了命名空间 - 类名是
Smarty，不是SmartyBC（后者仅用于兼容极老模板语法，不推荐新项目使用）
初始化 Smarty 实例时必须设置的路径
Smarty 不会自动猜测你的模板和编译目录位置。漏设 setTemplateDir() 或 setCompileDir() 会导致运行时报错 Unable to load template 或写入失败。典型安全配置如下：
-
setTemplateDir()指向你存放.tpl文件的目录，如templates/ -
setCompileDir()必须是 Web 服务器有写权限的绝对路径，如/var/www/myapp/templates_c/（不能是相对路径或templates_c/这种） -
setCacheDir()和setConfigDir()可选，但一旦启用缓存，setCacheDir()同样需可写
$smarty = new Smarty(); $smarty->setTemplateDir(__DIR__ . '/templates/'); $smarty->setCompileDir(__DIR__ . '/templates_c/'); $smarty->setCacheDir(__DIR__ . '/cache/'); $smarty->setConfigDir(__DIR__ . '/configs/');
为什么模板里 {$name} 不渲染？检查这三点
常见现象：PHP 中 assign 了变量，但模板输出空白。问题往往不在语法，而在上下文隔离或配置开关：
- Smarty 默认关闭
debugging，开启它可快速定位缺失变量：$smarty->debugging = true;，然后在页面右下角看到调试窗口 - 检查是否误用了
display()而非fetch()—— 前者直接输出，后者返回字符串；若你在框架中手动 echo，却调用了display()，可能被缓冲层吞掉 - 确认未启用
$smarty->escape_html = true（默认 false），否则特殊字符会被转义，看起来像“没渲染”
Smarty 的核心复杂点不在安装，而在于它对目录权限、路径绝对性、以及模板编译缓存生命周期的强依赖。哪怕 composer install 成功，只要 templates_c/ 不可写或路径拼错一个斜杠，就会静默失败。建议首次集成时，先用 var_dump($smarty->getTemplateVars()) 确认数据已传入，再排查模板解析环节。
