当前位置：首页 > 文章列表 > 文章 > php教程 > Smarty模板引擎使用详解

Smarty模板引擎使用详解

2025-10-09 11:40:27 0浏览收藏

还在为PHP前后端分离烦恼吗？本教程将带你快速上手PHP老牌模板引擎Smarty，轻松实现前后端解耦，提升开发效率。Smarty通过`assign`进行变量赋值，`display`渲染模板，支持变量、循环、条件判断等常用语法。本文详细讲解Smarty的安装配置、模板创建、变量赋值与显示，并深入探讨Smarty常用语法、配置文件使用、以及强大的缓存机制。掌握Smarty，让你的PHP代码更清晰、易维护，更有助于你学习其他PHP框架。立即开始你的Smarty之旅，打造高效的PHP应用！

Smarty是PHP模板引擎，实现前后端分离，通过assign赋值、display渲染模板，支持变量、循环、条件判断等语法，可配置缓存提升性能，便于维护与开发。

PHP如何使用模板引擎_模板引擎Smarty使用教程

模板引擎，简单说，就是把PHP代码和HTML代码分离，让前端专注于HTML，后端专注于PHP逻辑。Smarty，是PHP界的老牌劲旅，用它能让你的代码更清晰，维护起来也更方便。

解决方案

下载和安装Smarty
去Smarty官网下载最新版本，解压后，把libs目录放到你的PHP项目里。

引入Smarty类

在你的PHP代码里，引入Smarty类：

require_once 'libs/Smarty.class.php';
$smarty = new Smarty();

设置模板目录和编译目录
```
$smarty->setTemplateDir('templates/');
$smarty->setCompileDir('templates_c/');
$smarty->setConfigDir('configs/');
$smarty->setCacheDir('cache/');
```
- templates/：存放你的.tpl模板文件。
- templates_c/：Smarty编译后的PHP文件存放地，需要可写权限。
- configs/：配置文件目录。
- cache/：缓存文件目录。
创建模板文件（.tpl）
比如，templates/index.tpl：
```
    {$title}


    {$heading}
    {$content}
```
注意：{$title}、{$heading}、{$content}是变量，将在PHP代码中赋值。

PHP代码赋值并显示模板

require_once 'libs/Smarty.class.php';

$smarty = new Smarty();

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

$smarty->assign('title', 'Smarty Demo');
$smarty->assign('heading', 'Welcome to Smarty!');
$smarty->assign('content', 'This is a simple example.');

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

assign()函数用于给模板变量赋值，display()函数用于显示模板。

Smarty的常用语法有哪些？

Smarty的语法挺丰富的，但掌握几个常用的就够用了。

变量：{$variable}，直接输出变量的值。

循环：{foreach}，遍历数组。


{foreach $items as $item}
    {$item.name} - {$item.price}
{/foreach}

条件判断：{if}，根据条件显示不同的内容。

{if $user.is_logged_in}
    Welcome, {$user.name}!
{else}
    Please log in.
{/if}

函数：Smarty内置了一些函数，比如{html_options}，用于生成select选项。你也可以自定义函数。
注释：{* This is a comment *}，Smarty注释不会输出到HTML。

如何在Smarty中使用配置文件？

配置文件可以让你把一些全局性的配置，比如网站名称、数据库连接信息等，放在一个单独的文件里，方便管理。

创建配置文件

比如，configs/config.conf：

title = "My Awesome Website"
db_host = "localhost"
db_user = "root"
db_pass = "password"

在PHP代码中加载配置文件
```
$smarty->configLoad('config.conf');
```
在模板中使用配置变量
```
{$smarty.config.title}
```

Smarty的缓存机制是怎样的，如何使用？

Smarty的缓存机制可以大大提高网站的性能，尤其是在访问量大的时候。它会将编译后的模板缓存起来，下次访问时直接读取缓存，而不用重新编译模板。

开启缓存

$smarty->caching = true;
$smarty->cache_lifetime = 3600; // 缓存有效期，单位秒

判断是否使用缓存

if (!$smarty->isCached('index.tpl')) {
    // 如果没有缓存，则进行赋值操作
    $smarty->assign('title', 'Smarty Demo');
    $smarty->assign('heading', 'Welcome to Smarty!');
    $smarty->assign('content', 'This is a simple example.');
}

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