程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> 網頁編程 >> PHP編程 >> 關於PHP編程 >> PHP詳細徹底學習Smarty

PHP詳細徹底學習Smarty

編輯:關於PHP編程

基本語法 
所有的smarty標簽都被加上了定界符.在smarty裡,所有定界符以外的內容都是靜態的,當smarty遇到了模板標簽,將嘗試解釋他們,然後再以恰當的方式輸出. 

默認情況下是 {和},但它們是可定制的.定制方法是: 
$smarty->left_delimiter = '<!--{'; 
$smarty->right_delimiter = '}-->'; 

1.注釋

模板注釋被*號包圍,例如 {* this is a comment *} 
smarty注釋將不被輸出.它是模板內在的注釋. 

2.變量 
模板變量以$開頭,可以包含數字,字母和下劃線。 
config_file變量是例外要用#變量名#的方法引用 

3.函數 
smarty標簽輸出一個變量或者調用某種函數. 
在定界符內函數和其屬性將被處理和輸出.例如: 
{funcname attr1="val" attr2="val"}. 
funcname為函數的名稱比如:include等,attr1,attr2為屬性名,val為屬性相應的值。 

在模板裡無論是內建函數還是自定義函數都有相同的語法. 
內建函數將在smarty內部工作,例如 {if}, {section} 和{strip}.他們不能被修改. 
自定義函數通過插件機制起作用,它們是附加函數,可以隨意修改,自行添加. 
例如 {html_options} and {html_select_date} 

4.屬性 
靜態數值不需要加引號,布爾值(真或假)也不需要引號,可以是true,on,yes或者false,off,no. 但是字符串例外.變量同樣被用到了,它們也不能加引號. 

5.在字符串中插入變量 
只能識別數字,字母,下劃線和[]的組合,如果為復雜的形式需要用``將變量隔起來。比如{func var="test $foo.bar test"} 中只能識別變量$foo,要識別$foo.bar,需要寫成{func var="test `$foo.bar` test"}的格式。 

6.一些保留字的顯示方法 
在模板中如果要將smarty的一些保留字作為語言的內容顯示出來,比如顯示分隔符,默認為{}的方法是: {ldelim},{rdelim} 或者{$smarty.ldelim},{$smarty.rdelim} 或者可以把{}放在{literal} .. {/literal} 中間輸出。 

smarty的保留變量 

{$smarty}保留變量可以被用於訪問一些特殊的模板變量. 
以下是全部. 

頁面請求變量 
以下是訪問頁面請求變量諸如get,post,cookies,server,enviroment和session變量的例子. 例如{$smarty.server.SERVER_NAME}取得服務器變量,{$smarty.env.PATH}取得系統環境變量path, {$smarty.request.username}取得get/post/cookies/server/env的復合變量。 

{$smarty.now}變量用於訪問當前時間戳. 
可以用 date_format調節器格式化輸出. 例如{$smarty.now|date_format:"%Y-%m-%d %H:%M:%S"} 

{$smarty.const} 
你可以直接訪問PHP常量. 例如{$smarty.const._MY_CONST_VAL} 

{$smarty.capture} 
可以通過 {capture}..{/capture}結構 截取的輸出可以使用{$smarty} 變量訪問. 

{$smarty.config} 
{$smarty}變量 可以訪問已經加載的config變量. 
例如 {$smarty.config.foo}就可以表示 {#foo#}. 

{$smarty.section}, {$smarty.foreach} 
{$smarty} 變量可以訪問'section'和'foreach'循環的屬性. 

{$smarty.template} 
顯示當前被處理的模板的名字. 

{$smarty.version} 
顯示smarty模板的版本 

{$smarty.ldelim} 
顯示左分隔符 

{$smarty.rdelim} 
顯示右分隔符

變量調節器 
變量調節器用於變量,自定義函數和字符串. 
可以使用'|'符號和調節器名稱應用調節器. 
變量調節器由賦予的參數值決定其行為. 
參數由':'符號分開. 
如果你用變量調節器調節數組變量,結果是數組的每個值都被調節.如果你想要調節器調節整個數組,你必須在調節器名字前加上@符號. 
例如: {$articleTitle|@count}(這將會在輸出 $articleTitle 數組裡的數目) 

capitalize 
將變量裡的所有單詞首字大寫. 參數值boolean型決定帶數字的詞是否首字大寫。默認不大寫 

count_characters 
計算變量值裡的字符數.參數值boolean型決定是否計算空格數。默認不計算空格 

cat 
將cat裡的參數值連接到給定的變量後面.默認為空。 

count_paragraphs 
計算變量裡的段落數量 

count_sentences 
計算變量裡句子的數量 

count_words 
計算變量裡的詞數 

date_format 
日期格式 

第一個參數控制日期格式. 
如果傳給date_format的數據是空的,將使用第二個參數作為默認時間 

%a - 星期幾的簡寫 

%A - 星期幾的全寫 

%b - 月份的簡寫 

%B - 月份的全寫 

%c - 日期時間06/12/05 11:15:10 

%C - 世紀時間 

%d - 一個月的第幾號(從 01 到 31) 

%D - 同 %m/%d/%y 

%e - 一個月的第幾號,號為單數則前面加一空格 (從 1 到 31) 

%g - 世紀 

%G - 世紀 [0000,9999] 

%h - 同%b 

%H - 24小時形式的小時(從00到23) 

%I - 12小時形式的小時(從01到 12) 

%j - 一年中的第幾天(從 001 到 366) 

%k - 24小時形式的小時,單數字前面加空格. (從 0 到 23) 

%l - 12小時形式的小時,單數字前面加空格.(range 1 to 12) 

%m - 月份 (range 01 to 12) 

%M - 分 

%n - 換行符 

%p - 顯示早上還是下午`am' 或 `pm' 

%r - a.m. 或 p.m.形式的時間 

%R - 24小時形式的時間 

%S - 秒 

%t - tab符號 

%T - 同%H:%M:%S 

%u - 用 [1,7],表示星期幾 

%U - 計算是該年的第幾個星期,從該年的第一個星期天開始計算 

%V - 計算是該年的第幾個星期, 從 01 到 53, 第一個星期必須至少有4天在這一年, 星期天作為這個星期的第一天 

%w - 用數字的形式表示是星期的第幾天, 星期天 為 0 

%W - 用數字的形式是該年的第幾個星期,從該年的第一個星期一開始計算 

%x - 顯示日期:月/日/年 

%X - 顯示時間:小時:分鐘:秒 

%y - 不包括世紀的年份 

%Y - 包括世紀的年份 

%Z - 時區 

%% - 輸出% 

其中有些有時不能正常輸出。 

default 
默認 
為空變量設置一個默認值. 
當變量為空或者未分配的時候,將由給定的默認值替代輸出. 

escape 
轉碼 
參數值為html,htmlall,url,quotes,hex,hexentity,javascrīpt。默認是html轉碼 

indent 
縮進 
在每行縮進字符串,第一個參數指定縮進多少個字符,默認是4個字符.第二個參數,指定縮進用什麼字符代替。 

lower 
小寫 
This is used to lowercase a variable. 
將變量字符串小寫 

nl2br 
換行符替換成<br /> 

regex_replace 
正則替換 
尋找和替換正則表達式.必須有兩個參數,參數1是替換正則表達式. 參數2使用什麼文本字串來替換 

replace 
替換 
簡單的搜索和替換字符串必須有兩個參數,參數1是將被替換的字符串. 參數2是用來替換的文本 

spacify 
spacify是在字符串的每個字符之間插入空格或者其他的字符串. 參數表示將在兩個字符之間插入的字符串,默認為一個空格。 

string_format 字符串格式化 
是一種格式化浮點數的方法.例如十進制數.使用sprintf語法格式化。參數是必須的,規定使用的格式化方式。%d表示顯示整數,%.2f表示截取兩個浮點數。 

strip 去除(多余空格) 
替換所有重復的空格,換行和tab為單個或者指定的字符串. 如果有參數則是指定的字符串。 

strip_tags 去除所有html標簽 

truncate 截取 
參數1,規定截取的字符數.默認是80個. 
第二個參數指定在截取的那段字符串後加上什麼字符.默認為... 
第三個參數決定是否精確截取,默認情況下為false,則smarty不會分割單詞。 

upper 將變量改為大寫 

wordwrap 行寬約束 
第一個參數指定段落的寬度(也就是多少個字符一行,超過這個字符數換行).默認80. 
第二個參數指定在約束點使用什麼字符(默認是換行符\n). 
第三個參數決定是否精確截取字符,默認情況下是不精確截取,就是截取時不能分開單詞。
內建函數 
內建函數不能擅自修改。 
capture 
capture函數的作用是收集模板輸出的數據到一個變量裡,而不是把它們輸出到頁面.例如任何在 {capture name="foo"}和{/capture}之間的數據都被收到了由函數的名稱屬性指定的變量{$foo}裡,或者{$smarty.capture.foo}裡。如果函數沒有名字屬性,將使用"default".每個{capture}都必須對應{/capture},也不能嵌套使用capture函數。 

config_load 
引用配置文件 
file是必須的,說明要包含進來的配置文件名稱,section說明要加載的部分的名稱,scope被處理的變量的作用域.必須是local,parent或者global. 
local的意思是變量將在本模板裡被加載. 
parent 的意思是變量將在本模板和上級模板被加載. 
global的意思是變量將應用到所有的模板.默認為local。變量是否在上級模板可視,默認為no。如果scope屬性已經有了,這個值將被忽略. 

foreach,foreachelse 
foreach循環是選擇性的section循環.用於遍歷關聯數組.foreach的語法比section簡單的多,但是作為一個折中它只能用於簡單數組. 
foreach必須的參數是from和item. from變量表示需要循環的數組的名稱,item表示當前元素的變量名,key表示當前關鍵字的變量名,name表示訪問foreach屬性的foreach循環名。循環可以互相嵌套,被嵌套的循環之間的名字必須是獨立的.foreachelse 在from變量沒有值的時候被執行 

include 
用來引用其他的模板。 
file屬性是必須的用來表示所引用模板的名字,assign表示include文件將要分配的輸出的變量。你可以自行用屬性名="屬性值"的方式定義任意個局部變量。 

include_php 
用來在模板中引入php腳本。file是必須的用來表示php腳本的路徑,once確定如果在模板中引用了php腳本多次,是否只裝載一次。默認為true。 

insert 
用來包含php腳本中的函數,name是必須的,表示所插入的腳本的名稱,注意如果名稱是name,則包含的函數則是insert_name(),所以所有要插入的函數要有前綴insert_ 。如果用了assign屬性,則insert的輸出將會分配給模板變量而不會顯示。 scrīpt表示要引用的腳本路徑。這個程序產生的內容將不會被緩存,在每次調用該頁時重新執行,適用於廣告,投票,查詢結果等互動的地方。


if,elseif,else 
if語句和和條件同php差不多,但每個詞之間必須用空格分割開。也有一些新的條件語句,列舉如下:eq相等,ne、neq不相等,gt大於,lt小於,gte、ge大於等於,lte、le 小於等於,not非,mod求模。is [not] div by是否能被某數整除,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 

php 
php標記可以讓模板中能直接使用php語言。 

section,sectionelse 
section用來循環顯示數組的數據,name和loop是必須的參數。name表示嵌套名. section 可以嵌套使用,但是名字必須各不相同。loop表示循環的次數. sectionelse在loop參數為空的輸出。start用來規定循環開始的指針,如果值為負則從數組尾部計算開始的指針,默認為0.step表示循環的步數,為負則反向循環,默認為1.max設定循環的最大步數.show決定是否顯示section. 
section也有自己的變量處理section屬性,用{$smarty.section.sectionname.varname} 來顯示. 

index 
index用來顯示當前循環的指針,從0開始. 

index_prev 
用來顯示前一次循環的指針,從-1開始 

index_next 
用來顯示後一次循環的指針. 

iteration 
顯示當前循環的次數,從1開始. 

first 
如果當前循環為第一個循環,則值為true. 

last 
如果當前循環為最後一個循環,則值為true. 

rownum 
同iteration. 

loop 
顯示最後一次循環的指針,可以用在section中間的任何地方,也可以用在section之後. 

show 
show 決定是否顯示section. 

total 
顯示總共循環的次數,可以用在section中間的任何地方,也可以用在section之後. 

strip 
去掉多余的空格
常規函數 
assign 
assign用來在執行模板時分配變量值.var,value是必須的參數.var為要分配值的變量名,value為分配的值. 

counter 
counter用來輸出一個計數. 可以用多個計數,但是名字必須各不相同.name表示計數器名,默認為default.start表示計數的初始值,默認為1.skip計數的間隔,默認為1.direction表示計數方向,up或down,默認為up.print表示是否打印該值,默認為true.assign定義模板變量,計數器的輸出將被分配到assign定義的變量中. 

cycle 
Cycle用來循環顯示一組數值.name表示cycle名,values("值1","值2",...)表示循環顯示的一組數值.print表示是否顯示.advance決定是否顯示下一個數值. delimiter決定value的分隔符,默認為逗號. assign定義模板變量,cycle的輸出將被分配到assign定義的變量中. 

debug 
debug可以顯示所有分配了值的變量,但是不顯示模板內容,output屬性決定顯示的格式html或javascrīpt,默認是html. 

eval 
eval用來在變量裡插入變量。var是插入的變量名,assign把輸出分配給一個變量。 

fetch 
用來取得文件內容,並輸出文件內容,可以取得本地文件,http文件和ftp文件,file是取得文件的路徑, assign把輸出分配給一個變量。 

html_checkboxes 
html_checkbox用來用給定的數據創建checkbox。name表示checkbox的名稱,values表示checkbox的值,output表示checkbox的顯示,selected表示被選選項的值,options表示一組checkbox的值和顯示,separator表示分割每個checkbox的符號,labels表示給輸出添加標簽,默認為true。 

html_image 
html_image用來為一個圖片創建html標簽,如果height和width不分配值將會自動生成。file是圖片的路徑,height,width,alt同html標簽,basedir是圖片相對路徑開始的目錄的路徑,默認為服務器根目錄。href定義圖片的鏈接。 

html_options 
輸出下拉列表,參數有name,values,output,selected,options。 

html_radios 
輸出單選框,參數同復選框。 

html_select_date 
prefix定義各個下拉列表名字的前綴,默認為Date_。time決定使用的時間,默認是當前時間。start_year決定下拉列表開始的年份,可以用年份表示,也可以用與當前年份的相對年數來表示。默認是當前年份。end_year決定下拉列表結束的年份,可以用年份表示,也可以用與當前年份的相對年數來表示。默認是當前年份。display_days決定是否顯示日期。display_months決定是否顯示月份。display_years決定是否顯示年份。month_format決定顯示月份的格式,默認為%B。day_format決定顯示日期的格式,默認為%02d。day_value_format決定日期值的格式,默認為%d。month_value_format決定月份值的格式,默認為%m。year_as_text決定是否將年份按文本格式輸出。reverse_years決定是否反向輸出各年份。field_array用來取得一組變量,可以用name[Day],name[Month],name[Year]的方式從form取得獲得的值。day_size,month_size,year_size添加大小標簽。all_extra,day_extra,month_extra,year_extra添加額外的屬性到select或input標簽。field_order決定年月日下拉列表的順序,默認為MDY。field_separator不同下拉列表之間的分隔符,默認是\n。year_empty,month_empty,day_empty是在各下拉列表第一欄顯示的內容。 

html_select_time 
prefix定義各個下拉列表名字的前綴,默認為Time_。time決定使用的時間,默認是當前時間。display_hours決定是否顯示小時。display_minutes決定是否顯示分鐘。display_seconds決定是否顯示秒數。display_meridian 決定是否顯示上午或下午,即顯示am/pm。use_24_hours 決定是否24小時制。minute_interval 決定分鐘之間的間隔。second_interval 決定秒數之間的間隔。field_array用來取得一組變量,可以用name[Hour],name[Minute],name[Second]的方式從form取得獲得的值。all_extra,hour_extra,minute_extra,second_extra ,meridian_extra添加額外的屬性到select或input標簽。 

html_table 
loop定義用於循環的一組數據。cols決定列的數目,rows決定行的數目,如果其中一個為空,另一個有值,則根據元素個數和有值的屬性來計算另一個的值,兩者的默認值為3。inner決定元素的列舉方向cols則列跟著列排列,rows則行跟著行排列,默認為cols。table_attr,tr_attr,td_attr分別為table,tr,td增加標簽,如果tr_attr,td_attr是數組,將會循環增加標簽。trailpad用來填充最後一行沒有值的單元格,默認是 。hdir決定每行元素的排列方向,從左到右right或從右到左left,默認為right。vdir決定每列的排列方向,從上到下down或從下到上up,默認為down。 

math 
進行數字運算操作。equation和var是必須的。equation定義運算式,可以使用的運算符有+, -, /, *, abs, ceil, cos, exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt, srans and tan。var給運算變量賦值。format確定結果的格式。assign將輸出賦給一個參數。 

mailto 
使用mailto函數能使網絡蜘蛛很難獲取你的email地址,但是能在網頁上正常顯示,因為他把email地址進行了加密處理。address是必須的,定義email地址。text是顯示在頁面上的文本內容,默認是email地址。encode是加密email地址的方式,可以是none,hex或javascrīpt,默認是none。如果要把郵件發給其他的郵箱,可以用cc抄送,email地址之間用,分割。bcc則為密件抄送。subject是郵件主題。newsgroups是發表內容的新聞組,新聞組之間用,隔開。extra添加附加標簽。followupto意思不知。 

textformat 
textformat用來格式化文本,他會去掉空格和特殊字符,和規定行寬和縮進。style規定當前的格式,indent規定縮進的位數。indent_first規定第一行的縮進。indent_char用來縮進的字符,默認是一個空格。wrap規定行寬,即一行的字符數,默認是80。wrap_char規定每行的分隔符,默認是\n。wrap_cut決定是否分割單詞。assign將輸出分配給變量。
常量 
SMARTY_DIR 
是到smarty類目錄的完全路徑,必須以/結束。如果沒有定義,將會自動決定路徑. 

SMARTY_CORE_DIR 
是到smarty類core文件目錄的完全路徑,必須以/結束。如果沒有定義,將會自動定義為smarty_dir路徑下面的子目錄. 


變量 

$template_dir 
默認的模板目錄名,默認為"./templates". 
$compile_dir 
默認的編譯模板目錄名,默認為"./templates_c" 
$config_dir 
默認的config文件目錄名,默認為"./configs". 
$plugins_dir 
默認的插件目錄名,默認為"plugins". 
$debugging 
debugging控制台。即一個顯示變量的窗口. 
$debug_tpl 
debug窗口的模板 
$debugging_ctrl 
另一種控制debugging的方法。 
$autoload_filters 
對所有的模板使用過濾程序,這個變量是一個數組,其中關鍵字是過濾的類型,值是過濾的名字。 
$compile_check 
每次php執行將是否查看模板的內容是否改變。 

$caching 
決定是否緩存文件執行生成的文件。 
$cache_dir 
默認的模板緩存目錄名,默認為"./cache". 
$cache_lifetime 
緩存的模板的過期時間,以秒計算. $caching值為-1則緩存的模板永不過期.
最後我放個我用的例子.大家僅做一個參考吧

<?php
error_reporting(7);
$TurnDot  =  substr(PHP_OS, 0, 3) == 'WIN'  ?  ";"  :  ":"  ;
$doc_root=$_SERVER['DOCUMENT_ROOT'];   //默認獲取根路徑
//$doc_root="E:/Myweb/an-cool.com/Web" ; //這裡是指定路徑
$lib_root=".".$TurnDot.$doc_root."/shopadmin".$TurnDot.$doc_root."/shopadmin/inc".$TurnDot.$doc_root."/".$TurnDot.$doc_root."/jpgraph/src/".$TurnDot.$doc_root."/Smarty/libs/".$TurnDot.$doc_root."/Smarty";
ini_set("include_path",$lib_root);
include("conf.global.php");  //這裡是裝載一個全局配置文件.
$Templates_root = $doc_root."/templates";  //定義摸版根目錄
define("Templates",$Templates_root);
$templates  = isset($INFO['templates'])  ?  $INFO['templates']  :  'default'  ;
include_once('Smarty.class.php');
$tpl = new Smarty();                                                                   //建立smarty實例對象$tpl 
$tpl->debugging = false;
$tpl->template_dir   = Templates."/".$templates  ;                             //設置模板目錄
tpl->compile_dir    = Templates."/".$templates  ."/templates_c";     //設置編譯目錄
$tpl->cache_dir      = $doc_root."/cache";                                //設置緩存目錄
$tpl->cache_lifetime = 60 * 60 * 24;                                         //設置緩存時間
$tpl->cache_lifetime = 0;                                                          //設置緩存時間
$tpl->caching        = false;                                                        //這裡是調試時設為false,發布時請使用true
$tpl->left_delimiter = '<{';
$tpl->right_delimiter= '}>';
$tpl->assign("template_dir",  $INFO['site_url']."/templates/".$templates ); //摸板路徑
$tpl->assign("Site_Url",      $INFO['site_url']); //主站URL
$tpl->assign("LanguageIs",    $INFO['IS']); //語言包類型
$tpl->assign("HtmlTitle", $INFO['site_title']);     //TITLE內容
$tpl->assign("HtmlMeta",  $INFO['meta_keyword']);  //META內容
?>

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved