Smarty模板引擎入门指南：从安装到基础使用

什么是Smarty

Smarty是一款广受欢迎的PHP模板引擎，它实现了业务逻辑（PHP代码）与显示逻辑（HTML模板）的分离。通过使用Smarty，开发者可以更高效地组织代码结构，提高项目的可维护性。

环境要求

Smarty支持PHP 7.2到PHP 8.4版本，兼容性良好，适合大多数PHP项目。

安装Smarty

推荐使用Composer进行安装，这是PHP生态中最常用的依赖管理工具。

安装最新稳定版：

composer require smarty/smarty

如需安装开发中的最新版本（可能不稳定）：

composer require smarty/smarty:dev-master

如需安装前一个主要版本（Smarty 4）：

composer require smarty/smarty:^4

初始化Smarty实例

安装完成后，可以通过以下两种方式创建Smarty实例：

1. 通过Composer自动加载：

require 'vendor/autoload.php';
use Smarty\Smarty;
$smarty = new Smarty();

2. 直接引入类文件：

require("/path/to/smarty/libs/Smarty.class.php");
use Smarty\Smarty;
$smarty = new Smarty();

目录结构配置

Smarty需要四个核心目录：

1. templates - 存放模板文件
2. configs - 存放配置文件
3. templates_c - 存放编译后的模板
4. cache - 存放缓存文件

默认情况下，这些目录位于当前工作目录下。如需自定义路径：

$smarty->setTemplateDir('/some/template/dir');
$smarty->setConfigDir('/some/config/dir');
$smarty->setCompileDir('/some/compile/dir');
$smarty->setCacheDir('/some/cache/dir');

重要提示：编译目录和缓存目录必须对PHP进程可写。在Linux系统中，通常需要设置正确的权限：

chown nobody:nobody /path/to/templates_c/
chmod 770 /path/to/templates_c/

chown nobody:nobody /path/to/cache/
chmod 770 /path/to/cache/

可以使用testInstall()方法验证安装是否正确：

$smarty->testInstall();

基础使用示例

创建模板文件

在模板目录中创建index.tpl文件：

{* 这是Smarty模板注释 *}
<h1>你好，{$name|escape}，欢迎使用Smarty！</h1>

模板注释{* *}不是必须的，但建议在每个模板文件开头添加，便于识别文件类型。

编写PHP脚本

require 'vendor/autoload.php';

use Smarty\Smarty;
$smarty = new Smarty();

// 设置目录路径（建议使用绝对路径）
$smarty->setTemplateDir('/path/to/templates/');
$smarty->setCompileDir('/path/to/templates_c/');
$smarty->setConfigDir('/path/to/configs/');
$smarty->setCacheDir('/path/to/cache/');

// 分配变量并显示模板
$smarty->assign('name', '张三');
$smarty->display('index.tpl');

运行后，你将看到"你好，张三，欢迎使用Smarty！"的输出。

自动转义功能

在HTML环境中，为了防止XSS攻击，建议启用自动转义功能：

$smarty->setEscapeHtml(true);

启用后，所有输出到HTML的变量都会自动转义，无需手动添加|escape修饰符。

高级配置：扩展Smarty类

对于大型项目，建议通过继承Smarty类来统一配置：

class MyApplication extends Smarty {
    public function __construct() {
        parent::__construct();
        
        // 统一设置目录
        $this->setTemplateDir('/path/to/templates/');
        $this->setCompileDir('/path/to/templates_c/');
        $this->setConfigDir('/path/to/configs/');
        $this->setCacheDir('/path/to/cache/');
        
        // 启用自动转义
        $this->setEscapeHtml(true);
        
        // 设置缓存策略
        $this->caching = Smarty::CACHING_LIFETIME_CURRENT;
        
        // 分配全局变量
        $this->assign('app_name', '我的应用');
    }
}

使用时只需实例化自定义类：

$smarty = new MyApplication();
$smarty->assign('name', '李四');
$smarty->display('index.tpl');

这种方式使配置更集中，便于维护和重用。

总结

通过本文，你已经掌握了Smarty的基本安装、配置和使用方法。Smarty的强大之处在于它的模板继承、插件系统等高级功能，这些内容将在后续文章中详细介绍。建议从简单的项目开始实践，逐步掌握这个强大的模板引擎。