Smarty

Smarty类主要的属性

分类	属性	说明	默认值
路径	template_dir	模板文件的保存目录	./templates
	compile_dir	编译完成的模板的保存目录	./templates_c
	config_dir	设定文件的保存目录	./configs
	cache_dir	缓冲的保存目录	./cache
	secure_dir	安全目录的数组（只有在$security=TRUE时有效）	-
	trusted_dir	信赖目录的数组（只有在$security=TRUE时有效）	-
	plugins_dir	插件的保存目录	./plugins
缓冲	caching	缓冲功能是否有效	0
	cache_lifetime	缓冲数据的有效期限（秒单位）	360
	cache_handler_func	处理缓冲的句柄函数	-
	cache_modified_check	是否检测If-Modified-Since头	FALSE
设置文件	config_overwriter	如果有同一设定是否覆盖	TRUE
	config_booleanize	设置文件的On/Off,yes/no是否向TRUE/FALSE变换	TRUE
	config_read_hidden	是否许可读入隐藏块	FALSE

续表

分类	属性	说明	默认值
	config_fix_newlines	设定文件的改行是否变换为"\n"	TRUE
编译	compile_check	模板变更时是否进行编译处理	TRUE
	force_compile	在得到请求时，是否进行强制编译	FALSE
调试	debugging	显示调试前台	FALSE
	debug_tpl	调试前台显示用的模板文件	debug.tpl
	debugging_ctrl	调试前台有效/无效是否通过在Query信息控制	NONE
安全	security	安全模式是否有效	FALSE
	security_settings	安全模式的设定	参考后面
	use_sub_dirs	是否可用子目录	FALSE
功能扩张	autoload_filters	适用的适配器	—
	compile_file	编译模板的类（文件名）	Smarty_Compile.class.php
	compile_class	编译模板的类	Smarty_Compile
	config_class	读入设置文件的类	Config_File
	default_modifiers	默认适用的后缀	-
	default_resource_type	默认使用的资源	file
其他	left_delimiter	模板的左大括号	{
	right_delimiter	模板的右大括号	}
	compile_id	识别编译完全的模板用的ID	-
	default_template_handler_func	模板文件的读入失败时的处理函数	-
	error_reporting	错误通知水平（与php.ini的error_reporting参数相当）	-
	php_handling	模板中含有的PHP脚本的处理方法	SMARTY_PHP_PASSTHRU
		设定值	说明
		SMARTY_PHP_PASSTHRU	不执行脚本直接输出（默认）
		SMARTY_PHP_QUOTE	将脚本以HTML标签的形式显示
		SMARTY_PHP_REMOVE	在模板中除去脚本块
		SMARTY_PHP_ALLOW	许可执行脚本
	request_vars_order	注册请求变量的顺序	EGPCS
	request_use_auto_globals	模板中是否使用$HTTP_*_VARS[],$_*[]二者之一	TRUE（使用$_[]）

Security_settings属性中可指定的联想数组的关键字如下。
安全模式的详细设置

关键字名	说明	默认值
PHP_HANDLING	是否检查php_handling属性的值	FALSE
IF_FUNCS	{if}函数中可使用的PHP函数名（数组）	array('array','list','isset','empty','count', 'sizeof','in_array','is_array','true','FALSE','null')
INCLUDE_ANY	模板包含时是否检查security_dir属性	FALSE
PHP_TAGS	是否许可使用{php}函数	FALSE
MODIFIER_FUNCS	作为运算符可使用的PHP函数	array('count')
ALLOW_CONSTANTS	是否允许参照常量	FALSE

模块的基本语法
Smarty的模块文件由如下的元素组成。

No.	元素名	语法
说明
1	变量	{$变量名}
模板上动态修改的值。由从PHP脚本明确传过来的模板变量与在Smarty中自动生成的 预约变量组成
2	调节器	{$变量名|运算符[:"参数"[….]]}
加工变量或函数的返回值用的简易命令。可使用[|]连接多个调节器
3	函数	{函数名 属性="属性值"…}～{/函数名}
条件命令或重复处理等控制模板运行的命令
4	运算符	-
代数运算符（+,-,*,/,%）或比较运算符（==,!=,!,<,>,>=,<=）
5	注释	{*～*}
不能成为模板引擎的解析对象的注释信息
HTML模板
No.1～5中不包含的固定的HTML部分

函数名	{$var}
定义和用法	参照模板变量。
语法	1.{$var} 普通值 2.{$var[index]} 通常的数组 3.{$var.key} 联想数组 4.{var->prop|method()} 对象
参数描述	var，变量名 index，顺序号码 key，关键字 prop，属性名 method，方法名

函数名	{$smarty}
定义和用法	参照预约变量。
语法	{$smarty.key…}
参数描述	key，关键字
提示和注释
预约变量{$smarty}是Smarty在运行模板是自动设置值的变量。与模板变量不同，不用为确保预约变量在服务器脚本方编码。 预约变量{$smarty}中可参照的信息 分类 语法 内容 使用例 请求 {$smarty.get.param} Query信息($_GET) {$smarty.get.category}   {$smarty.post.param} POST信息($_POST) {$smarty.post.email}   {$smarty.cookies.param} Cookie信息($_COOKIE) {$smarty.cookies.name}   {$smarty.session.param} Session变量($_SESSION) {$smarty.session.depart}   {$smarty.server.param} 服务器变量($_SERVER) {$smarty.server.HTTP_ACCEPT_LANGUAGE}   {$smarty.env.param} 环境变量($_ENV) {$smarty.env.PATH}   {$smarty.request.param} 请求变量($_REQUEST) {$smarty.request.name} 变量/常量 {$smarty.config.param} 设置文件的参数     {$smarty.capTURE.param} 在{capTURE}函数中捕获的信息     {$smarty.const.param} 常量 {$smarty.const.param} 循环 {$smarty.section.loop.var} {$section}循环相关的信息     {$smarty.foreach.loop.var} {$foreach}循环相关的信息   变换(escape) {$smarty.ldelim} 模板的左括号 {$smarty.ldelim}   {$smarty.rdelim} 模板的右括号 {$smarty.rdelim} 信息 {$smarty.now} 现在的时刻（从1970/1/1开始的秒数）   {$smarty.template} 执行中的模板名 {$smarty.template}   {$smarty.version} Smarty的版本 {$smarty.version}
例子	客户端的种类：{$smarty.server.HTTP_USER_AGENT}

函数名	{*～*}
定义和用法	定义注释。
语法	{*comment*}
参数描述	comment，注释

函数	描述
assign	在模板变量中设置值。
get_template_vars	取得模块变量值。
clear_assign	清除指定模板变量的值。
clear_all_assign	清除所有模板变量的值。
display	执行模板文件。
fetch	执行模板文件（作为结果字符串返回）。
clear_cache	清空指定缓冲。
clear_all_cache	清空所有缓冲。
config_load	导入设置文件。
get_config_vars	取得设置文件的参数值。
clear_config	清除设置文件的参数值。

调节符拥有对模板中的变量进行加工/转换的功能。调节符的语法为{变量名|调节符[参数[…]]}。

函数	描述
capitalize	将第一个字符变为大写。
lower	转换为小写字母。
upper	转换为大写字母。
replace	替换字符串中的特定部分。
regex_replace	替换字符串中的特定部分(正则表达式)。
escape	对字符串进行特殊字符转换处理。
nl2br	将改行符转化为 标签。
date_format	进行日期数据的格式变换。
string_format	定义字符串的显示格式。
default	设置变量为NULL时显示的默认值。
strip	将输出字符串中的连续空白或改行符转换为单个空格或其他字符。
truncate	将字符串最后舍去指定字节数。
strip_tags	除去字符串中含有的标签。
indent	在段落的开始加入缩进。

模板函数就是在模板文件（.tpl）中能被调用的函数。这些函数能实现简单的条件判断，循环等功能。模板函数的语法就像标签一样，{函数名 属性=”属性值”…}{/函数名}。

函数	描述
if	条件判断函数，为TRUE时，其下的模板内容将显示，可与{elseif}块构建多重条件判断。
foreach	从指定的数组中循环顺序取出数值/关键字，分别设置在item/key中。
section	从指定的数组中取出数值,并进行循环处理。
assign	设置模板变量。
fetch	导入外部文件。
capTURE	将输出内容设置到模板变量中。
cycle	用于轮转输出一组值。
include	包含进外部模板。
config_load	使设置文件有效化。
counter	创建计数器。
ldelim	将左括号进行escape后输出。
rdelim	将右括号进行escape后输出。
literal	对模板的预言字符进行escape后输出。
strip	除去输出字符串开头/结尾中含有的空白字符串。
maitlto	变换邮件的连接为难懂的文字。
html_checkboxes	创建复选框。
html_options	创建选择框。
html_select_date	创建日期输入用的选择框。
html_select_time	创建时刻输入用的选择框。
html_image	创建图片（标签）。
popup_init	初始化弹出框。
popup	显示弹出框。
debug	启动调试窗口。