前面的話
對PHP來講,有不少模板引擎可供選擇,但Smarty是一個使用PHP編寫出來的,是業界最著名、功能最強大的一種PHP模板引擎。Smarty像PHP同樣擁有豐富的函數庫,從統計字數到自動縮進、文字環繞以及正則表達式均可以直接使用,若是以爲不夠,SMARTY還有很強的擴展能力,能夠經過插件的形式進行擴充。另外,Smarty也是一種自由軟件,用戶能夠自由使用、修改,以及從新分發該軟件。本文將詳細介紹Smarty模板引擎javascript
1 Smarty.class.php(主文件) 2 SmartyBC.class.php(兼容其餘版本Smarty) 3 sysplugins/* (系統函數插件) 4 plugins/* (自定義函數插件) 5 Autoloader.php 6 debug.tpl
【實例化】php
/* 並指定了Smarty.class.php所在位置,注意'S'是大寫的*/ require './libs/Smarty.class.php'; /* 實例化Smarty類的對象$smarty */ $smarty = new Smarty();
【init】
Smarty要求4個目錄,默認下命名爲:tempalates、templates_c、configs和cache。每一個都是能夠自定義的,能夠分別修改Smarty類屬性或相關方法:$template_dir、$compile_dir、$config_dir和$cache_dirhtml
1 /** file: init.inc.php Smarty對象的實例化及初使化文件 */ 2 define("ROOT", str_replace("\\", "/",dirname(__FILE__)).'/'); 3 //指定項目的根路徑 require ROOT.'libs/Smarty.class.php'; 4 //加載Smarty類文件 $smarty = new Smarty(); 5 //實例化Smarty類的對象$smarty 6 /* 推薦用Smarty3以上版本方式設置默認路徑,成功後返回$smarty對象自己,可連貫操做 */ 7 $smarty ->setTemplateDir(ROOT.'templates/') 8 //設置全部模板文件存放的目錄 9 // ->addTemplateDir(ROOT.'templates2/') 10 //能夠添加多個模板目錄 ->setCompileDir(ROOT.'templates_c/') 11 //設置全部編譯過的模板文件存放的目錄 ->addPluginsDir(ROOT.'plugins/') 12 //添加模板擴充插件存放的目錄 ->setCacheDir(ROOT.'cache/') 13 //設置緩存文件存放的目錄 ->setConfigDir(ROOT.'configs'); 14 //設置模板配置文件存放的目錄 $smarty->caching = false; 15 //設置Smarty緩存開關功能 $smarty->cache_lifetime = 60*60*24; 16 //設置模板緩存有效時間段的長度爲1天 $smarty->left_delimiter = '<{'; 17 //設置模板語言中的左結束符 $smarty->right_delimiter = '}>'; //設置模板語言中的右結束符
【demo】前端
1 <!-- main.tpl --> 2 <!DOCTYPE html> 3 <html lang="en"> 4 <head> 5 <meta charset="UTF-8"> 6 <title>Document</title> 7 </head> 8 <body> 9 <{$content}> 10 </body> 11 </html>
1 <?php 2 require './init.inc.php'; 3 $smarty -> assign('content','this is content.....'); 4 $smarty -> display('main.tpl'); 5 ?>
【變量】
模板變量用美圓符號$開始,能夠包含數字、字母和下劃線,這與php變量很像。能夠引用數組的數字或非數字索引,固然也能夠引用對象屬性和方法
配置文件變量是一個不用美圓符號$,而是用#號包圍着變量(#hashmarks#),或者是一個$smarty.config形式的變量
[注意]Smarty能夠識別嵌入在雙引號中的變量java
1 數學和嵌入標籤 2 {$x+$y} // 輸出x+y的和 {assign var=foo value=$x+$y} 3 // 屬性中的變量 {$foo[$x+3]} 4 // 變量做爲數組索引 {$foo={counter}+3} 5 // 標籤裏面嵌套標籤 {$foo="this is message {counter}"} 6 // 引號裏面使用標籤 7 定義數組 8 {assign var=foo value=[1,2,3]} 9 {assign var=foo value=['y'=>'yellow','b'=>'blue']} 10 {assign var=foo value=[1,[9,8],3]} // 能夠嵌套 11 短變量分配 12 {$foo=$bar+2} 13 {$foo = strlen($bar)} 14 {$foo = myfunct( ($x+$y)*3 )} // 做爲函數參數 {$foo.bar=1} // 賦值給指定的數組索引 {$foo.bar.baz=1} 15 {$foo[]=1} 16 17 點語法 18 {$foo.a.b.c} => $foo['a']['b']['c'] 19 {$foo.a.$b.c} => $foo['a'][$b]['c'] 20 {$foo.a.{$b+4}.c} => $foo['a'][$b+4]['c'] 21 {$foo.a.{$b.c}} => $foo['a'][$b['c']] 22 23 PHP語法 24 {$foo[1]} 25 {$foo['bar']} 26 {$foo['bar'][1]} 27 {$foo[$x+$x]} 28 {$foo[$bar[1]]} 29 {$foo[section_name]}
1 <!-- main.tpl --> 2 <!DOCTYPE html> 3 <html lang="en"> 4 <head> 5 <meta charset="UTF-8"> 6 <title>Document</title> 7 </head> 8 <body> 9 <{***定義數組:10***}> 10 <{assign var=foo value=[10,20,30]}> 11 <{$foo[0]}><br> 12 <{***短變量分配:0***}> 13 <{$foo=0}> <{$foo}><br> 14 <{***點語法:1***}> 15 <{$test.a}><br> 16 <{***PHP語法:1***}> 17 <{$test['a']}><br> 18 <{***數學運算:3***}> 19 <{$test.a+$test.b}><br> 20 </body> 21 </html>
1 <?php 2 require './init.inc.php'; 3 $smarty -> assign('test',['a'=>1,'b'=>2]); 4 $smarty -> display('main.tpl'); 5 ?>
【函數】web
每個smarty標籤輸出一個變量或者調用某種函數。在定界符內函數和其屬性將被處理和輸出正則表達式
1 <{funcname attr1="val" attr2="val"}> 編程
1 {config_load file="colors.conf"} 2 3 {include file="header.tpl"} 4 5 {if $highlight_name} 6 Welcome, <div style="color:{#fontColor#}">{$name}!</div> 7 {else} 8 Welcome, {$name}! 9 {/if} 10 11 {include file="footer.tpl"}
【屬性】
大多數函數都帶有本身的屬性以便於明確說明或者修改他們的行爲,smarty函數的屬性很像HTML中的屬性。靜態數值不須要加引號,可是字符串建議使用引號。可使用普通smarty變量,也可使用帶調節器的變量做爲屬性值,它們也不用加引號。甚至可使用php函數返回值和複雜表達式做爲屬性值
一些屬性用到了布爾值(true或false),它們代表爲真或爲假。若是沒有爲這些屬性賦布爾值,那麼默認使用true爲其值後端
1 {include file="header.tpl"} 2 {include file="header.tpl" nocache} // 等於nocache=true {include file="header.tpl" attrib_name="attrib value"} 3 4 {include file=$includeFile} 5 {include file=#includeFile# title="My Title"} {assign var=foo value={counter}} 6 {assign var=foo value=substr($bar,2,5)} 7 {assign var=foo value=$bar|strlen} 8 {assign var=foo value=$buh+$bar|strlen} 9 10 {html_select_date display_days=true} 11 12 {mailto address="smarty@example.com"} 13 14 <select name="company_id"> 15 {html_options options=$companies selected=$company_id} 16 </select>
變量
Smarty有幾種不一樣類型的變量,變量的類型取決於它的前綴符號是什麼(或者被什麼符號包圍)。Smarty的變量能夠直接被輸出或者做爲函數屬性和調節器(modifiers)的參數,或者用於內部的條件表達式等等。若是要輸出一個變量,只要用定界符將它括起來就能夠
一、從PHP分配的變量api
1 index.php: $smarty = new Smarty; 2 $smarty->assign('Contacts',array('fax' => '555-222-9876','email' => 'zaphod@slartibartfast.com')); 3 $smarty->display('index.tpl'); 4 5 index.tpl: <{$Contacts.fax}><br> <{$Contacts.email}><br> 6 7 OUTPUT: 555-222-9876<br> 8 zaphod@slartibartfast.com<br>
二、從配置文件讀取的變量
加載配置文件後,配置文件中的變量須要用兩個井號"#"包圍或者是smarty的保留變量$smarty.config.來調用
1 foo.conf: 2 pageTitle = "This is mine" 3 tableBgColor = "#bbbbbb" 4 rowBgColor = "#cccccc" 5 6 <!-- main.tpl --> 7 <{config_load file='foo.conf'}> 8 <!DOCTYPE> 9 <html> 10 <title><{#pageTitle#}></title> 11 <body> 12 <table style="background:<{#tableBgColor#}>"> 13 <tr style="background:<{#rowBgColor#}>"> 14 <td>First</td> 15 <td>Last</td> 16 <td>Address</td> 17 </tr> 18 </table> 19 </body> 20 </html> 21 22 23 <?php 24 require './init.inc.php'; 25 $smarty -> display('main.tpl'); 26 ?>
1 foo.conf: 2 3 [a] 4 x=1 5 6 [b] 7 x=2 8 9 [c] 10 x=3 11 12 <!-- main.tpl --> 13 <{config_load file='foo.conf' section="a"}> 14 <{#x#}> 15 16 output:1
四、模板裏定義的變量
1
2
3
4
5
|
<{$name=
'Bob'
}>
The value of $name
is
<{$name}>.
output:
The value of $name
is
Bob.
|
五、保留變量
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
$smarty.
get
$smarty.post
$smarty.cookies
$smarty.server
$smarty.env
$smarty.session
$smarty.request
$smarty.now
//當前時間戳
$smarty.
const
//訪問php常量
$smarty.capture
//捕獲內置的{capture}...{/capture}模版輸出
$smarty.config
//取得配置變量。{$smarty.config.foo}是{#foo#}的同義詞
$smarty.section
//指向{section}循環的屬性
$smarty.template
//返回通過處理的當前模板名
$smarty.current_dir
//返回通過處理的當前模板目錄名
$smarty.version
//返回通過編譯的Smarty模板版本號
|
1
2
3
4
5
6
|
<!-- main.tpl -->
<{$smarty.now}><br>
<{date(
'Y-m-d'
,$smarty.now)}><br>
<{$smarty.template }><br>
<{$smarty.current_dir }><br>
<{$smarty.version }><br>
|
變量調節器做用於變量、自定義函數或字符串。變量調節器的用法是:‘|’符號右接調節器名稱。變量調節器可接收附加參數影響其行爲。參數位於調節器右邊,並用‘:’符號分開
[注意]對於同一個變量,可使用多個修改器。它們將從左到右按照設定好的順序被依次組合使用。使用時必需要用"|"字符做爲它們之間的分隔符
capitalize[首字符大寫]
將變量裏的全部單詞首字大寫,與php的ucwords()函數相似。默認參數爲false用於肯定帶數字的單詞是否須要大寫
1
2
3
4
5
6
7
8
9
10
|
<{$articleTitle=
"next x-men film, x3, delayed."
}>
<{$articleTitle}><br>
<{$articleTitle|capitalize}><br>
<{$articleTitle|capitalize:
true
}> <br>
output:
next x-men film, x3, delayed.
Next X-Men Film, x3, Delayed.
Next X-Men Film, X3, Delayed.
|
lower[小寫]
將變量字符串小寫,做用等同於php的strtolower()函數
1
2
3
4
5
6
7
8
|
<{$articleTitle=
"Next x-men film, x3, delayed."
}>
<{$articleTitle}><br>
<{$articleTitle|lower}><br>
output:
Next x-men film, x3, delayed.
next x-men film, x3, delayed.
|
upper[大寫]
將變量改成大寫,等同於php的strtoupper()函數
1
2
3
4
5
6
7
8
|
<{$articleTitle=
"Next x-men film, x3, delayed."
}>
<{$articleTitle}><br>
<{$articleTitle|upper}><br>
output:
Next x-men film, x3, delayed.
NEXT X-MEN FILM, X3, DELAYED.
|
cat[鏈接字符串]
將cat裏的值後接到給定的變量後面
1
2
3
|
<{$articleTitle=
"next x-men film, x3, delayed."
}> <{$articleTitle|cat:
" yesterday."
}>
OUTPUT: next x-men film, x3, delayed. yesterday.
|
count_characters[字符計數]
計算變量裏的字符數。默認參數爲false,用於肯定是否計算空格字符
1
2
3
4
5
6
7
8
9
|
<{$articleTitle=
"next x-men film, x3, delayed."
}>
<{$articleTitle}><br>
<{$articleTitle|count_characters}><br>
<{$articleTitle|count_characters:
true
}><br>
OUTPUT:
next x-men film, x3, delayed.
25
29
|
count_paragraphs[計算段數]
計算變量裏的段落數量
1
2
3
4
5
6
7
|
<{$articleTitle=
"next x-men\n film, x3, delayed."
}>
<{$articleTitle}><br>
<{$articleTitle|count_paragraphs}><br>
OUTPUT:
next x-men film, x3, delayed.
2
|
count_sentences[計算句數]
計算變量裏句子的數量
1
2
3
4
5
6
7
|
<{$articleTitle=
"next x-men. film, x3, delayed."
}>
<{$articleTitle}><br>
<{$articleTitle|count_sentences}><br>
OUTPUT:
next x-men. film, x3, delayed.
2
|
count_words[計算詞數]
計算變量裏的詞數
1
2
3
4
5
6
7
|
<{$articleTitle=
"next x-men film, x3, delayed."
}>
<{$articleTitle}><br>
<{$articleTitle|count_words}><br>
OUTPUT:
next x-men film, x3, delayed.
5
|
date_format[格式化日期]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
|
%a - 當前區域星期幾的簡寫
%A - 當前區域星期幾的全稱
%b - 當前區域月份的簡寫
%B - 當前區域月份的全稱
%c - 當前區域首選的日期時間表達
%C - 世紀值(年份除以 100 後取整,範圍從 00 到 99)
%d - 月份中的第幾天,十進制數字(範圍從 01 到 31)
%D - 和 %m/%d/%y 同樣
%e - 月份中的第幾天,十進制數字,一位的數字前會加上一個空格(範圍從
' 1'
到
'31'
)
%g - 和 %G 同樣,可是沒有世紀
%G - 4 位數的年份,符合 ISO 星期數(參見 %V)。和 %V 的格式和值同樣,只除了若是 ISO 星期數屬於前一年或者後一年,則使用那一年。
%h - 和 %b 同樣
%H - 24 小時制的十進制小時數(範圍從 00 到 23)
%I - 12 小時制的十進制小時數(範圍從 00 到 12)
%j - 年份中的第幾天,十進制數(範圍從 001 到 366)
%m - 十進制月份(範圍從 01 到 12)
%M - 十進制分鐘數
%n - 換行符
%p - 根據給定的時間值爲 `am
' 或 `pm'
,或者當前區域設置中的相應字符串
%r - 用 a.m. 和 p.m. 符號的時間
%R - 24 小時符號的時間
%S - 十進制秒數
%t - 製表符
%T - 當前時間,和 %H:%M:%S 同樣
%u - 星期幾的十進制數表達 [1,7],1 表示星期一
%U - 本年的第幾周,從第一週的第一個星期天做爲第一天開始
%V - 本年第幾周的 ISO 8601:1988 格式,範圍從 01 到 53,第 1 周是本年第一個至少還有 4 天的星期,星期一做爲每週的第一天。(用 %G 或者 %g 做爲指定時間戳相應週數的年份組成。)
%W - 本年的第幾週數,從第一週的第一個星期一做爲第一天開始
%w - 星期中的第幾天,星期天爲 0
%x - 當前區域首選的時間表示法,不包括時間
%X - 當前區域首選的時間表示法,不包括日期
%y - 沒有世紀數的十進制年份(範圍從 00 到 99)
%Y - 包括世紀數的十進制年份
%Z 或 %z - 時區名或縮寫
%% - 文字上的 `%' 字符
|
1
2
3
4
5
6
|
<{$smarty.now|date_format}><br>
<{$smarty.now|date_format:
"%D"
}><br>
output:
Mar 25, 2017
03/25/17
|
default[默認值]
爲變量設置一個默認值。當變量未設置或爲空字符串時,將由給定的默認值替代其輸出
1
2
3
4
5
6
7
|
<{$articleTitle|
default
:
'a'
}><br>
<{$articleTitle=
"next x-men film, x3, delayed."
}>
<{$articleTitle|
default
:
'a'
}><br>
output:
a
next x-men film, x3, delayed.
|
escape[轉義]
escape做用於變量,用以html、url、單引號、十六進制、十六進制實體、javascript、郵件的轉碼或轉義。第一個參數默認爲'html',可選參數有'html,htmlall,url,quotes,hex,hexentity,javascript';第二個參數默認爲'utf-8',可選參數有'ISO-8859-1,UTF-8'...
1
2
3
4
5
6
7
|
<{$articleTitle=
"'Stiff Opposition Expected to Casketless Funeral Plan'"
}>
<{$articleTitle|escape}><br>
<{$articleTitle|escape:
'url'
}>
output:
'Stiff Opposition Expected to Casketless Funeral Plan'
%27Stiff%20Opposition%20Expected%20to%20Casketless%20Funeral%20Plan%27
|
indent[縮進]
在每行縮進字符串,默認是4個字符。對於第一個可選參數,能夠指定縮進字符數,對於第二個可選參數,能夠指定使用什麼字符縮進,例如'\t'做爲tab
1
2
3
4
5
6
7
|
<{$articleTitle=
"'Stiff Opposition Expected to Casketless Funeral Plan'"
}>
<{$articleTitle}><br>
<{$articleTitle|indent}>
output:
'Stiff Opposition Expected to Casketless Funeral Plan'
'Stiff Opposition Expected to Casketless Funeral Plan'
|
nl2br[換行符替換成<br />]
全部的換行符將被替換成 <br />,功能同PHP中的nl2br()函數同樣
1
2
3
4
5
6
7
8
|
<{$articleTitle=
"Next x-men\nfilm, x3, delayed."
}>
<{$articleTitle}><br>
<{$articleTitle|nl2br}><br>
output:
Next x-men film, x3, delayed.
Next x-men
film, x3, delayed.
|
regex_replace[正則替換]
使用正則表達式在變量中搜索和替換,語法來自php的preg_replace()函數
1
2
3
4
5
6
7
8
|
<{$articleTitle=
"Next x-men\nfilm, x3, delayed."
}>
<{$articleTitle}><br>
<{$articleTitle|regex_replace:
"/[\r\t\n]/"
:
" "
}><br>
output:
Next x-men
film, x3, delayed.
Next x-men film, x3, delayed.
|
replace[替換]
一種在變量中進行簡單的搜索和替換字符串的處理。等同於php的str_replace()函數
1
2
3
4
5
6
7
|
<{$articleTitle=
"Next x-men film, x3, delayed."
}>
<{$articleTitle}><br>
<{$articleTitle|replace:
"x"
:
"y"
}><br>
output:
Next x-men film, x3, delayed.
Neyt y-men film, y3, delayed.
|
spacify[插空]
插空是一種在變量的字符串的每一個字符之間插入空格或者其餘的字符(串)的方法
1
2
3
4
5
6
7
8
9
|
<{$articleTitle=
"Next x-men film, x3, delayed."
}>
<{$articleTitle}><br>
<{$articleTitle|spacify}><br>
<{$articleTitle|spacify:
"^"
}><br>
output:
Next x-men film, x3, delayed.
N e x t x - m e n f i l m , x 3 , d e l a y e d .
N^e^x^t^ ^x^-^m^e^n^ ^f^i^l^m^,^ ^x^3^,^ ^d^e^l^a^y^e^d^.
|
string_format[字符串格式化]
一種格式化字符串的方法,例如格式化爲十進制數等等。實際運用的是php的sprintf()函數
1
2
3
4
5
6
7
8
9
|
<{$number=23.5678}>
<{$number}><br>
<{$number|string_format:
"%.2f"
}><br>
<{$number|string_format:
"%d"
}>
output:
23.5678
23.57
23
|
strip[去除(多餘空格)]
用一個空格或一個給定字符替換全部重複空格、換行和製表符
1 <{$articleTitle="Grandmother of\neight makes\t hole in one."}> 2 <{$articleTitle}><br> 3 <{$articleTitle|strip}><br> 4 <{$articleTitle|strip:' '}><br> 5 6 output: 7 Grandmother of 8 eight makes hole in one. 9 Grandmother of eight makes hole in one. 10 Grandmother of eight makes hole in one.
strip_tags[去除html標籤]
去除<和>標籤,包括在<和>之間的所有內容
1
2
3
4
5
6
7
|
<{$articleTitle=
"Blind Woman Gets New Kidney from Dad she Hasn't Seen in <b>years</b>."
}>
<{$articleTitle}><br>
<{$articleTitle|strip_tags}><br>
output:
Blind Woman Gets New Kidney
from
Dad she Hasn't Seen
in
<b>years</b>.<br>
Blind Woman Gets New Kidney
from
Dad she Hasn't Seen
in
years .<br>
|
truncate[截取]
從字符串開始處截取某長度的字符,默認是80個,也能夠指定第二個參數做爲追加在截取字符串後面的文本串。該追加字串被計算在截取長度中。默認狀況下,smarty會截取到一個詞的末尾。若是想要精確的截取多少個字符,把第三個參數改成"true";第四個參數默認設置爲FALSE,表示將截取至字符串末尾,設置爲TRUE則截取到中間。注意若是設了TRUE,則忽略字符邊界
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
<{$articleTitle=
'Two Sisters Reunite after Eighteen Years at Checkout Counter.'
}>
<{$articleTitle}><br>
<{$articleTitle|truncate}><br>
<{$articleTitle|truncate:30}><br>
<{$articleTitle|truncate:30:
""
}><br>
<{$articleTitle|truncate:30:
"---"
}><br>
<{$articleTitle|truncate:30:
""
:
true
}><br>
<{$articleTitle|truncate:30:
"..."
:
true
}><br>
<{$articleTitle|truncate:30:
'..'
:
true
:
true
}><br>
output:
Two Sisters Reunite after Eighteen Years at Checkout Counter.
Two Sisters Reunite after Eighteen Years at Checkout Counter.
Two Sisters Reunite after...
Two Sisters Reunite after
Two Sisters Reunite after---
Two Sisters Reunite after Eigh
Two Sisters Reunite after E...
Two Sisters Re..ckout Counter.
|
wordwrap[行寬約束]
能夠指定段落的列寬(也就是一行多少個字符,超過這個字符數換行),默認80。第二個參數可選,指定在約束點使用什麼換行符,默認爲"\n"。默認狀況下smarty將截取到詞尾,若是想精確到設定長度的字符,請將第三個參數設爲ture。本調節器等同於php的wordwrap()函數
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
<{$articleTitle=
"Blind woman gets new kidney from dad she hasn't seen in years."
}>
<{$articleTitle}><br>
<{$articleTitle|wordwrap:30}><br>
<{$articleTitle|wordwrap:20}><br>
<{$articleTitle|wordwrap:30:
"<br />\n"
}><br>
<{$articleTitle|wordwrap:26:
"\n"
:
true
}><br>
output:
Blind woman gets
new
kidney
from
dad she hasn't seen
in
years.<br>
Blind woman gets
new
kidney
from
dad she hasn't seen
in
years.<br>
Blind woman gets
new
kidney
from
dad she
hasn't seen
in
years.<br>
Blind woman gets
new
kidney<br />
from
dad she hasn't seen
in
<br />
years.<br>
Blind woman gets
new
kidney
from
dad she hasn't
seen
in
years.<br>
|
{$var=...} 變量賦值
這是{assign}函數的簡寫版,能夠直接賦值給模版,也能夠爲數組元素賦值
1
2
3
4
|
<{$name=
'Bob'
}>The value of $name
is
<{$name}>.
output:
The value of $name
is
Bob.
|
{append} 追加
{append}用於在模板執行期間創建或追加模板變量數組
1
2
3
4
5
6
7
8
9
10
11
|
<{append
var
=
'name'
value=
'Bob'
index=
'first'
}>
<{append
var
=
'name'
value=
'Meyer'
index=
'last'
}>
<{* 或者 *}>
<{append
'name'
'Bob'
index=
'first'
}> <{* 簡寫 *}>
<{append
'name'
'Meyer'
index=
'last'
}> <{* 簡寫 *}>
The first name
is
<{$name.first}>.<br>
The last name
is
<{$name.last}>.
output:
The first name
is
Bob.The last name
is
Meyer.
|
{assign} 賦值
{assign}用來在模板運行時爲模板變量賦值
<{assign var="name" value="Bob"}> <{assign "name" "Bob"}> <{* 簡寫 *}> The value of $name is <{$name}>. output: The value of $name is Bob.
{config_load}
{config_load}用來從配置文件中加載config變量(#variables#)到模版
foo.conf: [a] x=1 [b] x=2 [c] x=3 <!-- main.tpl --> <{config_load file='foo.conf' section="a"}> <{#x#}> output:1
{for} 循環
{for}、{forelse}標籤用來建立一個簡單循環,支持如下不一樣的格式:
{for $var=$start to $end}步長爲1的簡單循環;
{for $var=$start to $end step $step}其它步長循環
當循環無迭代時執行{forelse}
1 <ul> 2 <{for $foo=1 to 3}> 3 <li><{$foo}></li><{/for}> 4 </ul> 5 6 output: 7 <ul> 8 <li>1</li> 9 <li>2</li> 10 <li>3</li> 11 </ul>
1 <ul> 2 <{for $foo=2 to 10 max=3}> 3 <li><{$foo}></li><{/for}> 4 </ul> 5 6 output: 7 <ul> 8 <li>2</li> 9 <li>3</li> 10 <li>4</li> 11 </ul>
{while}循環
隨着一些特性加入到模版引擎,Smarty的{while}循環與php的while語句同樣富有彈性。每個{while}必須與一個{/while}成對出現,全部php條件和函數在它身上一樣適用,諸如||、or、&&、and、is_array()等等
下面是一串有效的限定符,它們的左右必須用空格分隔開,注意列出的清單中方括號是可選的,在適用狀況下使用相應的等號(全等或不全等)
{foreach},{foreachelse}遍歷
{foreach}用來遍歷數據數組,{foreach}與{section}循環相比更簡單、語法更乾淨,也能夠用來遍歷關聯數組
1 {foreach $arrayvar as $itemvar} 2 {foreach $arrayvar as $keyvar=>$itemvar}
{foreach}循環能夠嵌套;數組變量一般是(另)一個數組的值,用來指導循環的次數,能夠爲專有循環傳遞一個整數;當數組變量無值時執行{foreachelse};
{foreach}的屬性是@index、@iteration、@first、@last、@show、@total;
能夠用循環項目中的當前鍵({$item@key})代替鍵值變量
1 <{$myColors['a'] = 'red'}> 2 <{$myColors['b'] = 'green'}> 3 <{$myColors['c'] = 'blue'}> 4 <ul> 5 <{foreach $myColors as $color}> 6 <li><{$color@key}>:<{$color}></li> 7 <{/foreach}> 8 </ul> 9 10 output: 11 <ul> 12 <li>a:red</li> 13 <li>b:green</li> 14 <li>c:blue</li> 15 </ul>
@index:包含當前數組的下標,開始時爲0
@iteration:包含當前循環的迭代,老是以1開始,這點與index不一樣。每迭代一次值自動加1
@first:當{foreach}循環第一個時first爲真
@last:當{foreach}迭代到最後時last爲真
@show:檢測{foreach}循環是否無數據顯示,show是個布爾值(true or false)
@total:包含{foreach}循環的總數(整數),能夠用在{forach}裏面或後面
{break}:中止/終止數組迭代
{continue}:停止當前迭代而開始下一個迭代/循環
1 <{$myColors['a'] = 'red'}> 2 <{$myColors['b'] = 'green'}> 3 <{$myColors['c'] = 'blue'}> 4 <{$myColors['d'] = 'pink'}> 5 <{$myColors['e'] = 'yellow'}> 6 <ul> 7 <{foreach $myColors as $color}> 8 <{if $color@first}> 9 <li><b><{$color@iteration}>:<{$color@index}>:<{$color@key}>:<{$color}></b></li> 10 <{elseif $color@last}> 11 <li><b><{$color@iteration}>:<{$color@index}>:<{$color@key}>:<{$color}></b></li> 12 <{else}> 13 <li><{$color@iteration}>:<{$color@index}>:<{$color@key}>:<{$color}></li> 14 <{/if}> 15 <{foreachelse}> 16 no result... 17 <{/foreach}> 18 </ul> 19 20 output: 21 <ul> 22 <li><b>1:0:a:red</b></li> 23 <li>2:1:b:green</li> 24 <li>3:2:c:blue</li> 25 <li>4:3:d:pink</li> 26 <li><b>5:4:e:yellow</b></li> 27 </ul>
{if}{elseif}{else} 條件
隨着一些特性加入到模版引擎,Smarty的{if}語句與php的if語句同樣富有彈性。每個{if}必須與一個{/if}成對出現,容許使用{else}和{elseif},全部php條件和函數在這裏一樣適用,諸如||、or、&&、and、is_array()等等
<{if $name == 'Fred' || $name == 'Wilma'}><br> ... <br><{/if}> <br><{* 容許使用圓括號 *}> <br><{if ( $amount < 0 or $amount > 1000 ) and $volume >= #minVolAmt#}> <br>... <br><{/if}> <br><{* 能夠嵌入函數 *}><br> <{if count($var) gt 0}> <br>... <br><{/if}> <br><{* 數組檢查 *}> <br><{if is_array($foo) }> <br>..... <br><{/if}> <br><{* 是否空值檢查 *}> <br><{if isset($foo) }> <br>..... <br><{/if}> <br><{* 測試值爲偶數仍是奇數 *}> <br><{if $var is even}> <br>... <br><{/if}> <br><{if $var is odd}> <br>... <br><{/if}> <br><{if $var is not odd}> <br>... <br><{/if}> <br><{* 測試var可否被4整除 *}> <br><{if $var is div by 4}> <br>... <br><{/if}> <br><{* 測試發現var是偶數,2個爲一組,也就是0=even, 1=even, 2=odd, 3=odd, 4=even, 5=even, 等等 *}> <br><{if $var is even by 2}> <br>... <br><{/if}> <br><{* 0=even, 1=even, 2=even, 3=odd, 4=odd, 5=odd, etc. *}> <br><{if $var is even by 3}> <br>... <br><{/if}>
{include}
{include}標籤用於在當前模板中包含其它模板。當前模板中的任何有效變量在被包含模板中一樣可用
必須指定file屬性,該屬性指明模板資源的位置
變量能夠做爲屬性參數傳遞給被包含模板,任何明確傳遞給被包含模板的變量只在被包含文件的做用域中有效。若是傳遞的屬性變量在當前模板中有同名變量,那麼傳遞的屬性變量將覆蓋當前模板變量
1
2
3
4
5
6
7
8
9
10
11
|
<!-- main.tpl -->
<{include file=
"header.tpl"
test=
"小火柴"
}>
<!-- header.tpl -->
<{$test}>
<{$test=
"aaa"
}><br>
<{$test}>
output:
小火柴
aaa
|
{function}
{function}用來在模板中建立函數,能夠像調用插件函數同樣調用它們
咱們不寫一個表達內容的插件,而是讓它保留在模板中,一般這是個更易於管理的選擇。同時,它也簡化了對數據的遍歷,例如深度嵌套菜單。另外能夠在模板中直接使用{funcname...}函數。
{function}標籤必須包含模板函數名的name屬性,該name標籤名必須可以調用模板函數
默認變量值應能做爲屬性傳遞到模板函數,當模板函數被調用的時候,默認值應能被複寫
在模板函數內部應能使用被調用模板的全部變量值,在模板函數中更改或新建變量的值必須具局部做用域,並且在執行模板函數後這些變量值在被調用模板內部應不可見
調用函數時,能夠直接使用函數名,或者使用{call}
1
2
3
4
5
6
7
8
9
10
11
12
13
|
<!-- main.tpl -->
<{function name=test a=0 b=0}>
<{$a}>+<{$b}>=<{$a+$b}>
<{/function}>
<{test}><br>
<{test a=1 b=2}><br>
<{call test a=3 b=3}><br>
output:
0+0=0
1+2=3
3+3=6
|
Smarty中的插件老是按需加載。只有在模板腳本中調用特定的調節器、函數、資源插件等時纔會自動加載。此外,每一個插件只加載一次,即使在同一個請求中存在幾個不一樣的Smarty實例同時運行
插件目錄能夠是一個包含路徑的字符串或包含多個路徑的數組。安裝插件的時候,將插件簡單地置於其中一個目錄下,Smarty會自動識別使用
插件文件和函數必須遵循特定的命名約定以便Smarty識別
插件文件必須命名以下:
type.name.php
其中type爲下面這些插件類型中的一種:
name爲合法標識符,僅包含字母、數字和下劃線
function.html_select_date.php, resource.db.php, modifier.spacify.php
插件內的函數應遵循以下命名約定
smarty_type_name ()
若是調節器(modifier)命名爲foo,那麼按規則函數爲smarty_modifier_foo()。若是指定的插件文件不存在或文件、函數命名不合規範,Smarty會輸出對應的錯誤信息
Smarty既可自動從文件系統加載插件,也可在運行時經過register_* API函數註冊插件。固然,也能夠經過unregister_* API函數卸載已經載入的插件
對於只在運行時註冊的插件函數沒必要遵照命名約定
若是某個插件依賴其它插件的某些功能(事實上,一些插件被綁定在Smarty中),那麼能夠經過以下方法加載須要的插件:
1
2
3
|
<?php
require_once $smarty->_get_plugin_filepath(
'function'
,
'html_options'
);
?>
|
按照慣例,Smarty對象一般做爲最後一個參數傳遞給插件,但有兩個例外:一、調節器不須接受Smarty對象的傳遞;二、爲了向前兼容舊版Smarty,塊插件將$repeat排在Smarty對象後面做爲最後一個參數($smarty做爲倒數第二個參數)
【模板函數】
1
2
3
|
void
smarty_function_name($
params
, $smarty);
array $
params
;
object
$smarty;
|
模板傳遞給模板函數的全部屬性都包含在關聯數組$params中
在模板中,函數的輸出內容(返回值)在原位置用函數標籤代替,例如{fetch}函數。做爲另外一種選擇,函數也能夠單純地用來作些非輸出內容的任務,如{assign}函數
若是函數須要分配(俗話說的賦值)一些變量給模板或者使用Smarty提供的一些函數,能夠經過$smarty對象實現,如$smarty->foo()
1
2
3
4
5
6
7
8
9
10
11
12
|
//function.eightball.php
<?php
function smarty_function_eightball($
params
, $smarty){
$answers = array(
'Yes'
,
'No'
,
'No way'
,
'Outlook not so good'
,
'Ask again soon'
,
'Maybe in your reality'
);
$result = array_rand($answers);
return
$answers[$result];}
?>
<!-- main.tpl -->
Question: Will we ever have time travel?<br>
Answer: <{eightball}>.
|
除了使用以上方式,還可使用registerPlugin()方式來進行插件註冊,可是因爲與PHP代碼混合在一塊兒,不建議使用
registerPlugin()
void registerPlugin(string type, string name, mixed callback, bool cacheable, mixed cache_attrs);
registerPlugin()方法在腳本中註冊函數或方法做爲插件。其參數以下:
「type」定義插件的類型,其值爲下列之一:「function」、「block」、「compiler」和「modifier」
「name」定義插件的函數名
「callback」爲定義的php回調函數,其類型爲下列之一:
一、包含函數名的字符串;
二、格式爲(&$object, $method)的數組,其中,&$object爲引用對象,$method爲包含方法名的字符串;
三、格式爲($class, $method)的數組,其中,$class爲類名,$method爲類中的方法。
「cacheable」和「cache_attrs」參數大多狀況下能夠省略
1 <?php 2 header("content-type:text/html;charset=utf-8"); 3 require './init.inc.php'; 4 function eightball($params, $smarty){ 5 $answers = array('Yes', 'No','No way','Outlook not so good','Ask again soon','Maybe in your reality'); 6 $result = array_rand($answers); 7 return $answers[$result]; 8 } 9 $smarty -> registerPlugin('function', 'test', 'eightball'); 10 $smarty -> display('main.tpl'); 11 ?> 12 <!-- main.tpl --> 13 Question: Will we ever have time travel?<br> 14 Answer: <{test}>. <br>
【調節器】
調節器是一些簡短的函數,這些函數被應用於顯示模板前做用於一個變量,或者其它情形中。調節器能夠鏈接起來(執行)
mixed smarty_modifier_name($value, $param1); mixed $value; [mixed $param1, ...];
調節器插件的第一個參數應該直接了當地聲明處理什麼類型(能夠是字符串、數組、對象等等這些類型)。其它的參數是可選的,取決於執行的操做類型。調節器必須返回處理結果
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
//modifier.u.php
<?php
function smarty_modifier_u($str){
return
ucwords($str);
}
?>
<!-- main.tpl -->
<{$testValue =
'Question: Will we ever have time travel?'
}><br>
<{$testValue}><br>
<{$testValue|u}><br>
output:
Question: Will we ever have time travel?
Question: Will We Ever Have Time Travel?
|
【塊函數】
1
2
3
4
5
|
void
smarty_block_name($
params
, $content, $smarty, &$repeat);
array $
params
;
mixed $content;
object
$smarty;
boolean &$repeat;
|
塊函數的形式是這樣的:{func} .. {/func}。換句話說,他們被封閉在一個模板區域內,而後對該區域的內容進行操做。塊函數優先於同名的自定義函數,換句話說,不能同時使用自定義函數{func}和塊函數{func} .. {/func}。
默認地,函數實現會被Smarty調用兩次:一次是在開始標籤,另外一次是在閉合標籤
從Smarty3.1開始打開標籤回調(函數)的返回值一樣會被顯示
只有塊函數的開始標籤具備屬性。全部屬性包含在做爲關聯數組的$params變量中,經由模板傳遞給模板函數。當處理閉合標籤時,函數一樣可訪問開始標籤的屬性
$content變量值取決於函數是被開始標籤調用仍是被閉合標籤調用。假如是開始標籤,變量值將爲NULL,若是是閉合標籤,$content變量值爲模板塊的內容。請注意這時模板塊已經被Smarty處理過,所以所接收到的是模板的輸出而不是模板資源
&$repeat參數經過引用傳遞給函數執行,併爲其提供控制塊顯示多少次的可能性。默認狀況下,在首次調用塊函數(塊開始標籤)時,&$repeat變量爲true,在隨後的全部塊函數(閉合標籤)調用中其值始終爲false。函數每次執行返回的&$repeat值爲true時,{func} .. {/func}之間的內容會被求值,同時參數$content裏的新塊內容會再次調用執行函數
若是嵌套了塊函數,能夠經過$smarty->_tag_stack變量訪問找出父塊函數。只須對塊函數運行一下var_dump(),函數結構就能夠一目瞭然了
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
//block.s.php
<?php
function smarty_block_s($
params
, $content, $smarty, &$repeat){
return
substr($content,0,$
params
[
'num'
]+1);
}
?>
<!-- main.tpl -->
<{$testValue =
'Question: Will we ever have time travel?'
}><br>
<{$testValue}><br>
<{s num=
"5"
}>
<{$testValue}>
<{/s}>
output:
Question: Will we ever have time travel?
Quest
|
繼承帶來了模板面向對象概念(oop),它容許定義一個或多個基模板供子模板繼承。繼承意味着子模板可覆蓋全部或部份父模板中命名相同的塊區域
模板繼承是一種編譯時進程,其將創建一個獨立的編譯模板文件。與對應的基於載入{include}子模板解決方案相比,當解釋模板時,前者有更好的性能
{extends} 繼承
{extends}標籤用在模板繼承中子模版對父模板的繼承
{extends}標籤用在模版中的第一行
若是子模板用{extends}標籤繼承父模板,那麼它只能包含{block}標籤(內容),其它任何模板內容都將忽略
使用此語法爲模板資源繼承$template_dir目錄外的文件
{extends file='parent.tpl'} {extends 'parent.tpl'} {* short-hand *}
{block} 塊
{block}用來給模板繼承定義一個模板資源的命名區域。子模板的{block}資源區域將會取代父模板中的相應區域。{block}能夠嵌套
任意的子、父模板{block}區域能夠彼此結合。能夠經過子{block}定義使用append、prepend選項標記追加或預置父{block}內容。使用{$smarty.block.parent}可將父模板的{block}內容插入至子{block}內容中的任何位置。使用{$smarty.block.child}可將子模板{block}內容插入至父{block}內容中的任何位置
[注意]子模板不能定義任何內容,除了須要覆蓋父模板的{block}標籤塊,全部在{block}標籤外的內容將被自動移除
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
<!-- parent.tpl-->
<!DOCTYPE html>
<html lang=
"en"
>
<head>
<meta charset=
"UTF-8"
>
<title>Document</title>
</head>
<body>
<{block name=
"one"
}>
one
<{/block}><br>
<{block name=
"two"
}>
two
<{/block}><br>
<{block name=
"three"
}>
three
<{/block}><br>
<{block name=
"four"
}>
four <{$smarty.block.child}>
<{/block}><br>
<{block name=
"five"
}>
five
<{/block}><br>
</body>
</html>
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
<!-- child.tpl-->
<{extends
'parent.tpl'
}>
<{block name=
"one"
}>
1
<{/block}><br>
<{block name=
"two"
prepend}>
2
<{/block}><br>
<{block name=
"three"
append}>
3
<{/block}><br>
<{block name=
"four"
}>
4
<{/block}><br>
<{block name=
"five"
}>
5 <{$smarty.block.parent}>
<{/block}><br>
block區域以外的內容不會顯示
|
1
2
3
4
5
6
7
8
9
10
11
12
|
<!-- parent.php-->
<?php
header(
"content-type:text/html;charset=utf-8"
);
require
'./init.inc.php'
;
$smarty -> display(
'parent.tpl'
);
?>
<!-- child.php-->
<?php
header(
"content-type:text/html;charset=utf-8"
);
require
'./init.inc.php'
;
$smarty -> display(
"child.tpl"
);
?>
|