PHP模板引擎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

属性 类型 是否必须 缺省值 描述
name   string   no   default   数据采集区域名称  
assign   string   No   n/a   数据采集区域在哪分配给变量name[待考]  

/tpl/index.tpl

<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>Capture</title> </head> <body> <!-- 定义capture --> <{capture}> 这里是 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、div by、even by、odd by、==、!=、>、<、<=、>=. 使用这些修饰词时必须和变量或常量用空格格开。

下面对这些修饰符表示的意思进行说明:

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/c36cf6b510e57c613137b01868e3df98.html