這篇文章主要介紹了PHP模板引擎Smarty內建函數用法,結合實例形式分析了smarty中常見的內建函數功能,定義與使用方法,需要的朋友可以參考下
Smarty的內建函數:Smarty自帶一些內建函數,內建函數是模板語言的一部分,使用者不能創建名稱和內建函數一樣的自訂函數,也不能修改內建函數。
下面對Smarty 中的內建函數進行說明,並加以實例:
實例中使用到的Smarty 模板引擎初始化檔案init.inc.php 和主檔案index .php
init.inc.php
<?php define('ROOT_PATH', dirname(__FILE__)); //设置网站根目录 require ROOT_PATH.'/libs/Smarty.class.php'; //加载 Smarty 模板引擎 $_tpl = new Smarty(); //创建一个实例对象 $_tpl->template_dir = ROOT_PATH.'/tpl/'; //重新指定模板目录 $_tpl->compile_dir = ROOT_PATH.'./com/'; //重新指定编译目录 $_tpl->left_delimiter = '<{'; //重新指定左定界符 $_tpl->right_delimiter = '}>'; //重新指定右定界符 ?>
#index.php
##
<?php require 'init.inc.php'; //引入模板初始化文件 global $_tpl; $_tpl->display('index.tpl'); //引入模板 ?>
#1、capture
##類型 | 是否必須 | 預設值 | 描述 | |
---|---|---|---|---|
string | no | default | 資料擷取區域名稱 | |
assign | string | No | n/a | #資料擷取區域在哪分配給變數name[待考] |
<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>Capture</title> </head> <body> <!-- 定义capture --> <{capture name="foo"}> 这里是 capture 函数里面的内容,默认是不显示的。 <{/capture}> <!-- 调用capture,使用的是 Smarty 中的保留变量{$smarty.capture} --> <{$smarty.capture.foo}> </body> </html>
2、config_load
屬性 | 類型 | #是否必須 | 預設值 | #描述 |
---|---|---|---|---|
file | string | Yes | n/a | 待包含的設定檔的名稱 |
section | string | No | #n/a | 設定檔中待載入部分的名稱 |
scope | string | no | local | 載入資料的作用域,取值必須為local, parent 或global. local 說明該變量的作用域為目前範本. parent 說明該變數的作用域為目前範本和目前範本的父範本(呼叫目前範本的範本). global 說明該變數的作用域為所有範本. |
#global | boolean | No | #No | ##說明已載入的變數是否全域可見,等同於scope=parent. 注意: 當指定了scope 屬性時,可以設定該屬性,但模板忽略該屬性值而以scope 屬性為準。 |
config_load 函数用于从配置文件中加载变量,关于 config_load 函数的使用,可参考前面一篇《PHP模板引擎Smarty之配置文件在模板变量中的使用方法示例》。
3、include
属性 | 类型 | 是否必须 | 缺省值 | 描述 |
---|---|---|---|---|
file | string | Yes | n/a | 待包含的模板文件名 |
assign | string | No | n/a | 该属性指定一个变量保存待包含模板的输出 |
[var ...] | [var type] | No | n/a | 传递给待包含模板的本地参数,只在待包含模板中有效 |
include 函数用于在当前模板中包含其它模板, 当前模板中的变量在被包含的模板中可用. 必须指定 file 属性,该属性指明模板资源的位置。如果设置了 assign 属性,该属性对应的变量名用于保存待包含模板的输出,这样待包含模板的输出就不会直接显示了。请看下面的示例:
/tpl/index.tpl
{include file="header.tpl"} {* body of template goes here *} {include file="footer.tpl"}
4、if,elseif,else
Smarty 中的 if 语句和 php 中的 if 语句一样灵活易用,并增加了几个特性以适宜模板引擎. if 必须于 /if 成对出现. 可以使用 else 和 elseif 子句。
可以使用以下条件修饰词:eq、ne、neq、gt、lt、lte、le、gte、ge、is even、is odd、is not even、is not odd、not、mod、p by、even by、odd by、==、!=、>、d2714fbb0e49a95306c2048bc19e4f2b=. 使用这些修饰词时必须和变量或常量用空格格开。
下面对这些修饰符表示的意思进行说明:
条件修饰符 | 作用描述 |
eq | == |
ne | != |
neq | != |
gt | > |
lt | ff7ec474ecc2ec105b900d573d35826d= |
ge | >= |
is even | 是否偶数 |
is odd | 是否奇数 |
is not even | 是否不是偶数 |
is not odd | 是否不是奇数 |
not | != |
mod | 求模 |
p by | 是否能被整除 |
even by | 商是否是偶数 |
odd by | 商是否是奇数 |
&& | 与 |
|| | 或 |
() | 括号改变优先级 |
5、ldelim 和 rdelim
用于输出分隔符,也就是大括号 "{" 和 "}". 模板引擎总是尝试解释大括号内的内容,因此如果需要输出大括号,请使用此方法。请看下面的示例:
/tpl/index.tpl
<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>ldelim 和 rdelim</title> </head> <body> <{ldelim}>funcname<{rdelim}> 是 Smarty 中的一个函数。 <!-- 执行结果: <{funcname}> 是 Smarty 中的一个函数。 --> </body> </html>
6、literal
literal 标签区域内的数据将被当作文本处理,此时模板将忽略其内部的所有字符信息. 该特性用于显示有可能包含大括号等字符信息的 javascript 脚本. 当这些信息处于 {literal}{/literal} 标签中时,模板引擎将不分析它们,而直接显示,其实按照我的所有例子中的标签风格(因为在 init.inc.php 初始化文件中已经重新设置了左定界符和右定界符),而不是 Smarty 的默认风格,基本上不会产生这种情况。关于该函数的使用,请看下面的示例
/tpl/index.tpl
<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>literal</title> </head> <body> <{literal}> <script language=javascript> <!-- window.alert(new Date()); --> </script> <{/literal}> </body> </html>
7、php
php 标签允许在模板中直接嵌入 php 脚本,此标签会把标签内部的内容当成 PHP 脚本进行解析执行。请看下面的示例
/tpl/index.tpl
<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>php</title> </head> <body> <{php}> echo date("Y-m-d H:i:s"); <{/php}> <!-- 执行结果: 2011-10-24 04:35:03 --> </body> </html>
8、strip
Web 开发者多次遇到空格和回车影响HTML输出的情形,为了得到特定的结果,因此你不得不在模板里运行所有的标签. 通常在难以理解或难以处理的模板中遇到此问题。Smarty 在显示前将除区任何位于 {strip}{/strip} 标记中数据的首尾空格和回车. 这样可以保证模板容易理解且不用担心多余的空格导致问题。
好了, Smarty 模板引擎中的内建函数先总结这么多,关于内建函数中两个最重要的函数(foreach,foreachelse、section,sectionelse)的使用,可参考前面一篇《PHP模板引擎Smarty内建函数foreach,foreachelse用法分析》
总结:以上就是本篇文的全部内容,希望能对大家的学习有所帮助。
相关推荐:
以上是PHP模板引擎Smarty內建函數的用法及實例詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章!