Smarty

Smarty

Smarty是一個使用PHP寫出來的模板引擎，是目前業界最著名的PHP模板引擎之一。它分離了邏輯代碼和外在的內容，提供了一種易於管理和使用的方法，用來將原本與HTML代碼混雜在一起PHP代碼邏輯分離。

簡單的講，目的就是要使PHP程序員同前端人員分離，使程序員改變程序的邏輯內容不會影響到前端人員的頁面設計，前端人員重新修改頁面不會影響到程序的程序邏輯，這在多人合作的項目中顯的尤為重要。

目錄
1定義 2優點 3誕生過程
4簡明教程 5判斷 6循環
7常見問題 8解釋程序

定義

PHP模板
如何使PHP腳本從設計中獨立出來？這是在PHP郵件列表上所提問的最多的問題之一。雖然PHP被標榜為“HTML嵌入式語言”，在寫過許多PHP和HTML混合式的工程之後，一個分離表單和內容的想法產生了。而且，在許多公司里規劃設計者的角色和程序設計者是分開的。於是，這樣的一個模板解決方案產生了……
例如在一個公司，一個應用程序的開發流程如下：在提交計劃文檔之後，界面設計者[美工]製作了網站的外觀模型，然後把它交給後台程序員。程序員使用PHP實現商業邏輯，同時使用外觀模型做成基本架構。然後工程被返回到HTML頁面設計者繼續完善。就這樣工程可能在後台程序員和頁面設計者之間來來回回好幾次。由於後台程序員不喜歡干預任何有關HTML標籤，同時也不需要美工們和PHP代碼混在一起；美工設計者只需要配置文件，動態區塊和其他的界面部分，不必要去接觸那些錯綜複雜的PHP代碼。因此，這時候有一個很好的模板支持就顯得很重要了。
縱觀現今存在的許多PHP模板解決方案（比如PHPLIB），大多數都只是提供了用模板取代變數和將動態區塊的功能有限的格式化的基本方法。但是我們的需求比這個要高的多。我們完全不想要PHP程序員去設計HTML頁面，可是這又是不可避免的。例如：如果美工想要在動態區塊之間交替不同的背景顏色，他就可能得和程序員預先說好。同樣，美工們也應該有自己對於頁面設計的配置文件，這同樣可以通過變數把他們拉到模板裡邊去

優點

1. 速度：採用Smarty編寫的程序可以獲得最大速度的提高，這一點是相對於其它的模板引擎技術而言的。
2. 編譯型：採用Smarty編寫的程序在運行時要編譯成一個非模板技術的PHP文件，這個文件採用了PHP與HTML混合的方式，在下一次訪問模板時將WEB請求直接轉換到這個文件中，而不再進行模板重新編譯（在源程序沒有改動的情況下）
3. 緩存技術：Smarty選用的一種緩存技術，它可以將用戶最終看到的HTML文件緩存成一個靜態的HTML頁，當設定Smarty的cache屬性為true時，在Smarty設定的cachetime期內將用戶的WEB請求直接轉換到這個靜態的HTML文件中來，這相當於調用一個靜態的HTML文件。
4. 插件技術：Smarty可以自定義插件。插件實際就是一些自定義的函數。
5. 模板中可以使用if/elseif/else/endif。在模板文件使用判斷語句可以非常方便的對模板進行格式重排。
不適合使用Smarty的地方
需要實時更新的內容。例如像股票顯示，它需要經常對數據進行更新，這類型的程序使用smarty會使模板處理速度變慢。
小項目。小項目因為項目簡單而美工與程序員兼於一人的項目，使用Smarty會在一定程度上喪失PHP開發迅速的優點。
（PS：不過為了整個項目的規範，請大家嘗試去使用模板引擎。其實習慣了，開發速度會更加快，以上是沒有用習慣模板引擎的開發者遇到的問題）

誕生過程

早在1999年後期，就已經開始為模板引擎寫說明文檔。在完成這個文檔之後，開始嘗試用C寫一個模板引擎，並有希望被包含到PHP里去。在撞上了許多的技術難題的同時，“什麼是模板應該做的，什麼不該做”這個問題，也被熱烈的討論著。從這些經驗決定應該用PHP將模板引擎寫成一個類，讓任何覺得合適的人使用它。所以就有了Smarty。（註：這個類從來沒有公開發表過）。這個類幾乎達到了我們所有的要求：常規變數替換，支持引用其他模板，使用配置文件集成設置，嵌入PHP代碼，限制'if'語句的作用，還有更多的可以多層嵌套的健壯的動態區塊。它用正則表達式做到這一切，於是代碼變得相當令人費解。在每次調用的時候，都要去解析那些語法和正則表達式，於是在大型應用的時候，它顯然慢了下來。在程序員的眼光看來，最大的問題還是使用PHP腳本建立和處理模板和動態區塊的所有必要工作。我們應該如何使它變得更簡單？
我們可以想象Smarty應該有怎樣的最後表現。我們知道PHP代碼如果沒有了模板解析的開銷將有多快，我們也知道從一般的美工看來PHP語言是多麼的“恐怖”，然而這一切可以被一種更簡單的模板語法掩飾掉。我們應該怎樣把這兩種方法的長處結合起來？
於是，Smarty誕生了……

簡明教程

一. 安裝
下載最新版本的Smarty。解壓下載的文件。
接下來演示給大家一個安裝實例，看過應該會舉一反三的。
(1) 在根目錄下建立了新的目錄learn/，再在learn/里建立一個目錄smarty/。將剛才解壓縮出來的目錄的libs/拷貝到smarty/里，再在smarty/里新建templates目錄，templates里新建cache/，templates/，templates_c/， config/。
(2) 新建一個模板文件：index.tpl，將此文件放在learn/smarty/templates/templates目錄下，代碼如下：
聲明不全，下午糾結了好一會，終於看到了，新手朋友們關注下">
Smarty
{#$hello#}
新建index.php，將此文件放在learn/下：
require 'smarty/libs/Smarty.class.php';
$smarty = new Smarty();//設置各個目錄的路徑，這裡是安裝的重點
$smarty->template_dir ="smarty/templates/templates";
$smarty->compile_dir ="smarty/templates/templates_c";
$smarty->config_dir = "smarty/templates/config";
$smarty->cache_dir ="smarty/templates/cache";
//smarty模板有高速緩存的功能，如果這裡是true的話即打開caching，但是會造成網頁不立即更新的問題，當然也可以通過其他的辦法解決
$smarty->caching = false;
$smarty->left_delimiter = "{#"; //重新定義邊界，因為默認邊界“{}“符，在html頁面中嵌入js腳本文件編寫代碼段時使用的就是”{}“符，自定義邊界符還可以是<{ }>, {/ /} 等
$smarty->right_delimiter = "#}";
$hello = "Hello World!";//賦值
$smarty->assign("hello",$hello);//引用模板文件
$smarty->display('index.tpl');?>
(3) 執行index.php就能看到Hello World!了。
二. 賦值
在模板文件中需要替換的值用大括弧{}括起來，值的前面還要加$號。例如{$hello}。這裡可以是數組，比如{$hello.item1},{$hello.item2}…
而PHP源文件中只需要一個簡單的函數assign(var , value)。
簡單的例子：
*.tpl:
*.php:
$hello[name]= “Mr. Green”;
$hello[time]=”morning”;
$smarty->assign(“exp”,$hello);
output:
Hello,Mr.Green!Good morning
三. 引用
網站中的網頁一般header和footer是可以共用的，所以只要在每個tpl中引用它們就可以了。
示例：*.tpl:
{include file="header.tpl"}
{* body of template goes here *}
{include file="footer.tpl"}

判斷

模板文件中可以使用if else等判斷語句，即可以將一些邏輯程序放在模板里。"eq","ne", "neq", "gt", "lt","lte", "le", "gte" "ge","is even", "is odd", "is not even", "is notodd", "not", "mod", "div by", "evenby", "odd by","==","!=",">","<","<=",">="這些是if中可以用到的比較。看看就能知道什麼意思吧。
eq相等，
ne、neq不相等，
gt大於，
lt小於，
gte、ge大於等於，
lte、le 小於等於，
not非， mod求模。
is [not] div by是否能被某數整除，
,B z M E m I w0 is [not] even是否為偶數，
$a is [not] even by $b即($a / $b) % 2 == 0，
is [not] odd是否為奇，
$a is not odd by $b即($a / $b) % 2 != 0
示例：
{if $name eq "Fred"}
WelcomeSir.
{elseif $name eq "Wilma"}
WelcomeMa'am.
{else}
Welcome,whatever you are.
{/if}

循環

在Smarty里使用循環遍曆數組的方法是section，如何賦值遍歷都是在模板中解決，php源文件中只要一個assign就能解決問題。
示例：
{* this examplewill print out all the values of the $custid array *}
{section name=‘customer’ loop=$custid}
id: {$custid[customer]}
{/section}
OUTPUT:
id: 1000
id: 1001
id: 1002
Smarty還可以使用類似PHP的foreach來進行遍歷，在最新版本的Smarty里的語法與PHP更相似。
示例：
{foreach item='article' from=$art} //{foreach $art as $item}
{$article.title}
{$article.author}
{$article.content}
{/foreach}

常見問題

Smarty將所有大括弧{}里的東西都視為自己的邏輯程序，於是我們在網頁中想插入javascript函數就需要literal的幫忙了，literal的功能就是忽略大括弧{}。
示例：
{literal}
{/literal}

解釋程序

我們可以看到，smarty的程序部分實際就是符合php語言規範的一組代碼，我們依次來解釋一下：
1：語句：
包含的部分為程序篇頭註釋。主要的內容應該為對程序的作用，版權與作者及編寫時間做一個簡單的介紹，這在smarty中不是必需的，但從程序的風格來講，這是一個好的風格。
2：include_once語句：
它將安裝到網站的smarty文件包含到當前文件中，注意包含的路徑一定要寫正確。
3：$smarty = new Smarty():
這一句新建一個Smarty對象$smarty,簡單的一個對象的實例化。
4：$smarty->templates(""):
這一句指明$smarty對象使用tpl模板時的路徑，它是一個目錄，在沒有這一句時，Smarty默認的模板路徑為當前目錄的templates目錄，實際在寫程序時，我們要將這一句寫明，這也是一種好的程序風格。
5：$smarty->templates_c(""):
這一句指明$smarty對象進行編譯時的目錄。在模板設計篇我們已經知道Smarty是一種編譯型模板語言，而這個目錄，就是它編譯模板的目錄，要注意，如果站點位於linux伺服器上，請確保
teamplates_c里定義的這個目錄具有可寫可讀許可權，默認情況下它的編譯目錄是當前目錄下的templates_c，出於同樣的理由我們將其明確的寫出來。
6：$smarty->left_delimiter與$smarty->right_delimiter:
指明在查找模板變數時的左右分割符。默認情況下為"{"與"}"，但在實際中因為我們要在模板中使用