Smarty 模板引擎安裝配置與變數調節器完整指南

Smarty 是 PHP 經典的模板引擎，嚴格分離業務邏輯與表現層。本文從下載安裝、核心配置、目錄結構到常用變數調節器（修飾符），提供完整上手指南。

一、安裝與目錄結構

1. 下載：Smarty 官網
2. 解壓並重命名資料夾為 smarty，置於專案目錄。
3. 手動建立以下目錄（需可寫入權限）：
   • templates/ — 模板檔
   • templates_c/ — 編譯快取
   • temp/ / cache/ — 快取目錄
   • configs/ — 設定檔

二、核心配置檔 smarty.inc.php

<?php
require_once 'smarty/Smarty.class.php';

$smarty = new Smarty();
// 目錄配置
$smarty->template_dir = 'templates/';
$smarty->compile_dir  = 'templates_c/';
$smarty->cache_dir    = 'temp/';
$smarty->config_dir   = 'configs/';

// 快取設定（開發階段建議關閉）
$smarty->caching = 0;          // 0=關閉, 1=開啟
$smarty->cache_lifetime = 60;  // 快取壽命(秒)

// 網站根網址常數
if (!defined('SITE_URL')) {
    $url = $_SERVER['REQUEST_SCHEME'] . '://' . $_SERVER['HTTP_HOST'];
    define('SITE_URL', $url);
}

// 專案根目錄常數
if (!defined('__ROOT__')) {
    define('__ROOT__', rtrim(dirname(__FILE__), '\\') . '\\');
}

// Magic Quotes 相容處理（PHP 5.4+ 已移除，視版本決定是否保留）
if (get_magic_quotes_gpc()) {
    function stripcslashes_arr($array) {
        return is_array($array) ? array_map('stripcslashes_arr', $array) : stripslashes($array);
    }
    $_POST    = stripcslashes_arr($_POST);
    $_GET     = stripcslashes_arr($_GET);
    $_REQUEST = stripcslashes_arr($_REQUEST);
    $_COOKIE  = stripcslashes_arr($_COOKIE);
    $_SESSION = stripcslashes_arr($_SESSION);
}

// 時區設定
date_default_timezone_set('PRC'); // 中國標準時間

// 載入通用函式庫
if (file_exists('common/common.php')) {
    require_once 'common/common.php';
}
?>

三、控制器範例 index.php

<?php
require_once 'smarty.inc.php';

// 指派單一變數
$title = '第一個標題';
$smarty->assign('title', $title);

// 指派陣列資料（volist 迴圈用）
$people = array(
    array('name' => '張三', 'sex' => '男', 'age' => '20'),
    array('name' => '李四', 'sex' => '男', 'age' => '40'),
    array('name' => '王五', 'sex' => '女', 'age' => '32'),
);
$smarty->assign('people', $people);

// 輸出模板
$smarty->display('index.tpl');
?>

四、模板範例 templates/index.tpl

<html>
<head><title>{$title}</title></head>
<body>
<h1>{$title}</h1>
<table border="1">
    <tr><th>姓名</th><th>性別</th><th>年齡</th></tr>
    {volist name=$people id=vo}
    <tr>
        <td>{$vo.name}</td>
        <td>{$vo.sex}</td>
        <td>{$vo.age}</td>
    </tr>
    {/volist}
</table>
</body>
</html>

五、常用變數調節器（修飾符）速查表

六、開發建議

• 開發階段關閉快取（caching=0），否則修改模板不會即時生效。
• 模板中盡量避免複雜邏輯，僅做資料呈現；業務運算放在 PHP 控制器。
• 善用 {include file="header.tpl"} 拆分公共區塊（頭部、導航、頁尾）。
• 輸出使用者輸入內容時，務必加上 |escape:"html" 防範 XSS 攻擊。

1. 上一篇文章： PHP require() 檔案包含路徑解析機制深度解析
2. 下一篇文章： ThinkPHP RBAC 權限控制官方範例深度解析

PHP 綜合知識

快遞查詢 API 接口對接完整指南（以愛查快遞為例）

本文整理愛查快遞（ickd.cn）API 的參數說明、返回格

CodeIgniter 分頁類別實作：可配置樣式、支援首尾頁、上下頁導航

Page_list 類別特色 支援 CodeIgniter

解決 PHP getallheaders 無法獲取自定義 Header 的問題

在 Nginx 環境下，getallheaders() 無法

PHP 優於 Node.js 的五大理由：託管、部署與穩定性考量

前言 Node.js 擁有優雅架構與高效能，但在實務佈署、維