3-1 使用 Smarty

一、Smarty基本操作

1. 大原則：和外觀有關的東西都放到.html或.tpl中，所需要的資料全由.php提供，簡單範例，index.php內容：

   <?php
   require_once 'smarty/libs/Smarty.class.php';
   $smarty  = new Smarty;
   $name    = 'Tad';
   $smarty->assign('name', $name);
   $smarty->display('index.tpl');
   

2. 樣板檔一律放至 templates 目錄中
3. PHP檔中最常用的就是利用 $smarty->assign('樣板標籤名稱', $變數值); 將變數送至樣板檔。
4. templates/index.tpl 內容：

   <h2>Hello {$name}</h2>
   

 二、Smarty變數及陣列

$name="tad";
$smarty->assign('name', $name);

{$name}

$user['name']="tad";
$user['birthday']="1973-06-16";
$smarty->assign('user', $user);

{$user.name} 的生日是 {$user.birthday}

$users[1]['name']="tad";
$users[1]['birthday']="1973-06-16";
$users[2]['name']="phebe";
$users[2]['birthday']="1973-03-10";
$smarty->assign('users', $users);

{foreach $users as $user}
  {$user.name} 的生日是{$user.birthday}
{/foreach}

或

{$user.1.name} 的生日是 {$user.1.birthday}
{$user.2.name} 的生日是 {$user.2.birthday}

三、 常用Smarty迴圈用法

1. Smarty迴圈用來處理陣列，常用方法如下：

   {foreach $來源變數 as $別名}
     {$別名.索引}
   {foreachelse}
     該變數沒有值時要出現的內容
   {/foreach}

2. 迴圈還有一些特別的用法：
   • {$別名@first} 迴圈第一圈
   • {$別名@last} 迴圈最後一圈
   • {$別名@index} 取得迴圈的索引值，依序輸出0、1、2......
   • {$別名@iteration} 取得迴圈的計數值，依序輸出1、2、3......
   • {$別名@total} 取得迴圈執行總數
3. 詳情可見：http://www.smarty.net/docs/en/language.function.foreach.tpl

四、Smarty 其他常用用法

1. 在樣板中，可以直接用 $samrty.get 來取得所有 $_GET 的變數陣列，同理若要在樣板中取得 $_SESSION，那就是用 $smarty.session
2. 註解的寫法 {* 註解 *}
3. 在樣板中，Smarty 也可以直接拿PHP的函數來用，我們稱之為「變數修飾器」，例如：

   {if $變數|in_array:$陣列}

4. 變數後面要加上 |

5. | 後面加上函數名稱，函數需要的參數用 : 格開

6. 刪除快取：

   $smarty->clearAllCache();