Smarty 作為經典的 PHP 模板引擎,其核心功能之一便是將 PHP 端的各類資料結構分配給模板進行顯示。本文將系統梳理 Smarty 中基本資料、陣列(含多維陣列)以及物件的分配與讀取方式,並輔以完整代碼示例,幫助開發者快速掌握資料傳遞的關鍵技巧。
Smarty 的 assign() 方法可直接將字串、整數、浮點數、布林值等純量資料傳給模板:
$smarty->assign("str", "hello smarty!");
$smarty->assign("int", 143);
$smarty->assign("double", 12.1344);
$smarty->assign("bool", true);
$smarty->assign("bool2", false);
模板中使用 {$str}、{$int} 等語法即可輸出。值得注意的是,布林值 true 會顯示為 1,而 false 則輸出空白(相當於 null)。

Smarty 支援索引陣列、關聯陣列以及多維陣列,且在模板中提供了靈活的存取語法。
// 索引陣列
$res = array('上海', '北京', '深圳');
$smarty->assign("arr", $res);
// 關聯陣列
$res2 = array('city1'=>'北京', 'city2'=>'廣州', 'city3'=>'湖南');
$smarty->assign("arr2", $res2);
模板讀取:
{* 索引陣列 *}
{$arr[0]}, {$arr[1]}, {$arr[2]}
{* 關聯陣列:兩種寫法,推薦使用點號語法 *}
{$arr2.city1}, {$arr2.city2}, {$arr2.city3}
{* 不推薦:{$arr2['city1']} *}
包含索引二維、關聯二維以及帶鍵名的關聯二維陣列:
// 索引二維
$res3 = array(
array('蕭曉','常山','吳蓓'),
array('珊珊','常明')
);
$smarty->assign("arr3", $res3);
// 關聯二維(形式1)
$res4 = array(
array('id'=>'001','name'=>'張三','email'=>'zhangsan@1163.com'),
array('url'=>'https://www.baidu.com','age'=>'28')
);
$smarty->assign("arr4", $res4);
// 關聯二維(形式2:帶外層鍵名)
$res5 = array(
'emp1'=>array('id'=>'001','name'=>'張三','email'=>'zhangsan@1163.com'),
'emp2'=>array('url'=>'https://www.baidu.com','age'=>'28')
);
$smarty->assign("arr5", $res5);
模板中巢狀 foreach 或直接指定鍵路徑均可讀取:
{* 二維索引 *}
{$arr3[0][0]}, {$arr3[0][1]}, {$arr3[0][2]}, {$arr3[1][0]}, {$arr3[1][1]}
{* 關聯二維形式1 *}
{$arr4[0].id}, {$arr4[0].name}, {$arr4[0].email}, {$arr4[1].url}, {$arr4[1].age}
{* 關聯二維形式2 *}
{$arr5.emp1.id}, {$arr5.emp1.name}, {$arr5.emp1.email}, {$arr5.emp2.url}, {$arr5.emp2.age}

Smarty 允許直接將物件實例分配給模板,模板可透過 -> 操作符存取公開屬性,甚至支援巢狀物件與陣列屬性的混合存取。
class Master {
var $name;
var $age;
function __construct($name, $age) {
$this->name = $name;
$this->age = $age;
}
}
class Dog {
var $name;
var $age;
var $color;
var $arr;
var $master;
function __construct($name, $age, $color, $arr6, $master) {
$this->name = $name;
$this->age = $age;
$this->color = $color;
$this->arr = $arr6;
$this->master = $master;
}
}
$arr6 = array('001','002','003');
$master = new Master('小明', 22);
$dog1 = new Dog('小白', 1, 'white', $arr6, $master);
$smarty->assign("dog", $dog1);
模板讀取:
{* 基本屬性 *}
{$dog->name}, {$dog->age}, {$dog->color}
{* 陣列屬性 *}
{$dog->arr[0]}, {$dog->arr[1]}, {$dog->arr[2]}
{* 物件屬性(巢狀) *}
{$dog->master->name}, {$dog->master->age}

掌握上述資料類型的分配與讀取方式,能讓你在 Smarty 模板開發中靈活應對各種業務場景,實現邏輯與顯示的清晰分離。