smarty程序員應該知道37個變量

1、變量1、 SMARTY_DIR Smarty 目錄定位 Smarty 類文件的完整系統(tǒng)路徑，如果沒有定義Smarty 目錄， Smarty 將會試著自動創(chuàng)建合適的值。如果定義了 , 路徑必須要以斜線結束。define("SMARTY_DIR","/usr/local/lib/php/Smarty/");require_once(SMARTY_DIR."Smarty.class.php");2、 $template_dir 模板目錄變量該變量定義默認模板目錄的名字。 當包含文件時， 如果不提供一個源類型 (即源地址) ， 那么將會到模板

2、目錄中尋找。 默認情況下， 目錄是：“ ./templates ”，也就是說他將會在和 php 執(zhí)行腳本相同的目錄下尋找模板目錄。3、 $compile_dir 編譯目錄變量該變量定位編譯模板的目錄名字。 默認情況下， 目錄是： “ ./templates_c ”，也就是說他將會在和 php 執(zhí)行腳本相同的目錄下尋找編譯目錄。4、 $config_dir 配置目錄變量該變量定義用于存放模板配置文件的目錄，默認情況下，目錄是：“ ./configs ”， 也就是說他將會在和 php 執(zhí)行腳本相同的目錄下尋找配置目錄。5、 $plugins_dir 插件目錄變量該變量定義Smarty尋找所需插件的

3、目錄。默認是在 SMART錄錄下的 “plugins ”目錄。如果提供了一個相對路徑，Smarty將首先在SMARTY錄下尋找，然后到當前工作目錄下尋找，繼而到 php 包含路徑中的每個路徑中尋找。6、 $debugging 調試變量它能啟動調試控制臺。 該控制臺是一個javascript 窗口， 該窗口告訴你被包含的模板和應用于當前模板頁面的變量。7、 $debug_tpl 調試模板該變量定義用于調試控制臺的模板文件名字。默認情況下，其名字為：debug.tpl ，位于 Smarty 目錄中。8、 $debugging_ctrl 調試控制變量該變量作用是允許以交替的方式啟動調試設置。NONE

4、!示不允許交替方式。URLg示當關鍵詞 SMARTY_DEBUG在QUERY_STRING詢字符串)中時，針對此腳本的調用，調試被啟動。如果$debugging 變量是真，則忽略其調試控制變量值。9、 $global_assign 全局配置變量定義一組總是隱式地作用于模板引擎的變量列表。這對于使全局變量或服務器變量可用于所有模板是很方便的， 因為無需手工配置它們。 在全局配置中的每一元素應 當要么是一全局變量的名字， 要么是一鍵 / 值對 (鍵是全局數組名， 值是對應該全局數組的變量數組)。$SCRIPT_NAME量默認屬于$HTTP_SERVER_VARS 010、 $undefined 未

5、定義變量該變量為 Smarty 設定沒有得到定義的變量的值, 默認為空 . 當前僅用來設定全局配置中的未定義變量為一個默認值.11、 $autoload_filters 自動加載過濾器變量如果你希望在每次模板調用過程中加載過濾器, 你可以指定他們使用此變量 ,Smarty 將自動為你加載它們. 該變量是一個聯(lián)合數組 , 在數組中鍵是過濾器類型 , 值是過濾器名字所組成的數組. 例如 :$smarty->autoload_filters = array('pre' => array('trim', 'stamp'),'outpu

6、t' => array('convert');12、 $compile_check 編譯檢查變量每次調用PHP應用程序,Smarty會試著查看自上次編譯時間以來，當前模板是否被修改過. 如果修改過了 , 她會重新編譯那個模板 . 如果模板還沒有被編譯過她將編譯模板而不管編譯檢查如何設置 . 默認情況下編譯檢查這個變量設置為true. 一旦一個應用程序投入產品中 (模板將不會修改了 ), 就不再需要編譯檢查這一步了 .為了最大性能，確定 將$compile_check設為"false”.注意：如果設為了 "false", 雖然模板文件被

7、修改, 但你不會看到修改結果, 因為模板沒有得到重新 編譯 . 如果啟動了緩存和編譯檢查 , 一旦有關模板文件或配置文件被更新, 緩存文件將會重建.13、 $force_compile 強迫編譯變量強迫Smarty每次調用(重新)編譯模板時.這項設置不受$compile_check的限 制 . 默認情況下 , 它是無效的 . 它對于開發(fā)和調試很方便. 但它決不能使用于產品環(huán)境下 . 如果啟動了緩存, 每次將會重新生成緩存文件 .14、 $caching 緩存變量告訴 Smarty 是否緩存模板的輸出 . 默認情況下 , 她設為 0, 或無效 . 如果模板產生冗余內容, 建議打開緩存. 這樣有利

8、于獲得良好的性能增益. 你也可以為同一模板設有多個緩存. 當值為 1 或 2 時啟動緩存.1 告訴 Smarty 使用當前的$cache_lifetime 變量判斷緩存是否過期 .2 告訴 Smarty 使用生成緩存時的cache_lifetime 值 . 用這種方式你正好可以在獲取模板之前設置緩存生存時間，以便較精確地控制緩存何時失效.如果啟動了編譯檢查 , 一旦任何的模板文件或配置文件（ 有關緩存部分的配置文件 ） 被修改 , 緩存的內容將會重新生成 . 如果啟動了強迫編譯, 緩存的內容將總會重新生成.15、 $cache_dir 緩存目錄變量這是存放模板緩存的目錄名 . 默認情況下, 它

9、是 :"./cache", 也就是說你可以在和 php 執(zhí)行腳本相同目錄下尋找緩存目錄 . 你也可以用你自己的自定義緩存處理函數來控制緩存文件, 它將會忽略這項設置.16、 $cache_lifetime 緩存生存時間變量該變量定義模板緩存有效時間段的長度（ 單位秒 ）, 一旦這個時間失效, 則緩存將會重新生成. 如果要想實現所有效果,$caching 必須 因 $cache_lifetime 需要而設為 "true". 值為 -1 時, 將強迫緩存永不過期 .0 值將導致緩存總是重新生成（ 僅有利于測試, 一個更有效的使緩存無效的方法是設置$cachi

10、ng = false.）如果啟動了強迫編譯, 則緩存文件每次將會重新生成. 要想有效地停止緩存,你可以利用 clear_all_cache（） 函數清除所有的緩存文件, 或者利用clear_cache（） 函數清除個別文件（ 或文件組 ）.17、 $cache_handler_func 緩存處理函數變量你可以提供一個自定義函數來處理緩存文件, 而不是通過變量$cache_dir 使用內置方法. 祥見 :cache handler function section18、 $cache_modified_check 緩存修改檢查變量如果設置該變量為真,Smarty 將分析客戶端發(fā)送來的 If-Mo

11、dified-Since 頭信息 . 如果緩存文件時間戳自上次訪問以來沒有改變, 則發(fā)送一個"304 NotModified" 頭 , 而不是緩存文件內容. 這種方式僅工作于沒有insert 標記的緩存內容 .19、 $config_overwrite 配置覆蓋變量如果設該變量為真, 則從配置文件中讀取出來的變量將會互相覆蓋 . 否則 , 變量將會放到一個數組中 . 如果你想把配置文件中的數據存儲到數組里, 這種方式是很有用的 , 僅僅列出每個元素多次就可以了 . 默認情況下 , 設為真 .20、$config_booleanize配置布爾化變量如果該變量設為真，配置文件中

12、的on/true/yes 和off/false/no 值會自動 轉化為布爾值.這樣的話，你就可以在模板中像if #foobar# pp815/if）這樣使 用這些值了 .如果foobar為on, true 或yes,那么if語句就會執(zhí)行了 .默認情況下，該變量值為真.21、$config_read_hidden配置讀取隱藏變量如果設為真，在配置文件中的隱藏節(jié)塊（*不會翻譯啦）可以從模版中讀 取出來.典型的你會設為假，這樣你可以在配置文件里存放敏感數據，例如數據庫 參數,而不用擔心模版會調用他們.默認情況下，該變量設為假.22、$config_fix_newlines配置固定換行符變量如果該變量

13、設為真，那么在配置文件中的 mac和dos換行符（r and rn） 在語法解析時將會轉換為n.默認情況下，該變量為真.23、$default_template_handler_func默認模板處理函數變量該函數在模板不能從它的源目錄下獲取時會得到調用.24、$php_handling php 處理變量該變量告訴Smarty怎樣處理嵌入到模版中的php代碼.有四種可能的設置， 默認為SMARTY_PHP_PASSTHRU:改變量的設置不會影響模板里面 php/php標記中的php代碼.原樣輸出標記.作為html實體引用標記從模板中移出標記.將作為php代碼執(zhí)行標記.極度不贊成將php代碼嵌入到

14、模板中.25、$security 安全變量安全變量要么是真，要么是假.默認為假.當你不信任模板中的可編輯部分（例 如通過ftp方式上傳編輯的），并想通過模板語言減小系統(tǒng)非安全的風險時，安 全變量設為真比較適合.設為真會將下面的規(guī)則強加于模板語言中，除非特別地 用 $security_settings 覆蓋.? 如果變量$php_handling設為了 SMARTY_PHP_ALL則隱式地被修改成 SMARTY_PHP_PASSTHRU? PHP函數在IF語句中是不允許的，除了在$security_settings中另行指出.? 模板僅可以包含于$secure_dir 數組列出的目錄中 .? 本

15、地文件僅可以用 fetch 獲取于 $secure_dir 數組列出的目錄中 .? php/php tags are not allowed不允許有 php/php 標記 .? PHP函數不允許彳為修正器，除了在$security_settings中指出.26、 $secure_dir 安全目錄變量這是一個與安全有關的本地目錄數組變量. 當啟動安全變量時include 和fetch 會用到此數組變量 .27、 $security_settings 安全配置變量These are used to override or specify the security settings when sec

16、urity is enabled. These are the possible settings: 用于當啟動安全變量時覆蓋或另行指定安全配置. 有以下幾種可能的配置? PHP_HANDLING 真或假-. 如果真 ,則不檢查 $php_handling 的配置 .? IF_FUNCS - 這是一個可允許包含在if 語句中的 php 函數名數組 .? INCLUDE_ANY -真或假. 如果真 ,可以從文件系統(tǒng)中包含任何模板,而不管$secure_dir 目錄設置如何.? PHP_TAGS -真或假. 如果真 ,php/php 允許在模板中存在.? MODIFIER_FUNCS這是一個可用作

17、修正器的php函數名數組.28、 $trusted_dir 信任目錄變量信任目錄變量僅用在$security 啟動之后 . 這是一個所有建立信任的目錄數組變量 . 你可以將 php 腳本放到這些信任目錄中 , 這些腳本會直接在模板里以include_php 標記得到執(zhí)行.29、 $left_delimiter 左結束符變量用于模板語言中, 默認是"".30、 $right_delimiter 右結束符變量用于模板語言中, 默認是"".31、 $compiler_class 編譯類變量指定 Smarty 用來編譯模板的編譯類名 . 默認為 :'Sm

18、arty_Compiler'. 僅適合 于高級用戶 .32、$request_vars_order 變量順序變量請求變量的順序在這里配置，類似于php.ini中的變量順序.33、$request_use_auto_globals自動全局變量指定Smarty是否使用php的$HTTP_*_VARS散組變量(默認 $request_use_auto_globals=false)或$_*數組($request_use_auto_globals=true) 變量.這對使用了 $smarty.request.*, $smarty.get.*等標記的模板有影響.值得注意的是：如果設置$request_use_auto_globals 為真,variable.request.var