Smarty:insert函數(shù)

{insert}的工作方式和{include}函數(shù)很像， 除了當(dāng)模板開啟了caching時，{insert}函數(shù)是不會被緩存， 它會在每次模板調(diào)用的時候都執(zhí)行。

我們假設(shè)你有一個包含了橫幅廣告的模板，廣告將顯示在頁面的頂部。 橫幅廣告將包括HTML、圖片、FLASH等。 所以我們不能在橫幅內(nèi)使用靜態(tài)鏈接，也不能對其進(jìn)行緩存。 我們用{insert}：模板可以從配置文件中獲取到 #banner_location_id# 和 #site_id# 值, 并且調(diào)用一個函數(shù)來顯示橫幅廣告的內(nèi)容。

{* example of fetching a banner *}
{insert name="getBanner" lid=#banner_location_id# sid=#site_id#}
{insert "getBanner" lid=#banner_location_id# sid=#site_id#} {* short-hand *}

在這個例子中，我們使用了名為“getBanner”的insert函數(shù)，并且傳遞了 #banner_location_id# 和 #site_id#參數(shù)。 Smarty將查詢PHP程序，找到insert_getBanner()函數(shù)，用數(shù)組將#banner_location_id# 和 #site_id#作為該函數(shù)的第一個參數(shù)來傳遞。 程序中全部的{insert}對應(yīng)的函數(shù)都應(yīng)該以"insert_"開頭，以避免命名沖突。 你的insert_getBanner()函數(shù)應(yīng)該用傳進(jìn)去的參數(shù)做一些處理，并且返回結(jié)果。 這些結(jié)果將顯示在模板的{insert}標(biāo)簽的位置。 在這個例子中，Smarty將調(diào)用函數(shù)insert_getBanner(array("lid" => "12345","sid" => "67890")); 然后將返回的結(jié)果顯示在{insert}的位置。

傳遞的第二個參數(shù)是Smarty對象。 這樣你可以在 {insert} 函數(shù)內(nèi)引用和修改Smarty對象的信息。

如果該PHP文件無法找到，Smarty將尋找是否有相應(yīng)名稱的insert插件。

參見 {include}