PHPlib Template模板类中文文档介绍

PHPlib Template模板类中文文档介绍

// from: http://www.4kiki.net/php_lib_template/

第十章. 模板(Template)

目录

模板类实例变量
模板类实例方法
可调用的实例方法
内部实例方法
模板类应用举例

备注: 如果你认为它像FastTemplates,那你要认真阅读了,其实它不是.

该模板类允许你在一些外部文件中保留HTML代码,这些文件完全不包含PHP代码,只含有用以替换的字段(译注:就是下文中所说的变量的"引用")。这个类就提供了一些可以让你用任意的字符串填入欲替换字段的函数。

 

备注: 该文档的版本不再维护,请参阅template.inc 源文件中的注释部分,以获得最可靠的文档.

模板类实例变量

可调用的实例变量

classname 字符串(String).类序列帮助:类名称.
debug 整型(Integer). 标识:设为1可观察所有变量赋值情况,设为2可观察可调用变量,设为4可观察内部函数调用.
unknowns 为"keep","comment", "remove" (默认)三者之一.决定了在输出环节上如何处理模板中未完成处理的变量名称.如果设为"keep",这些变量名称将原封不动的保留下来.如果设为"comment",那么会在报错的同时,将未完成处理的变量名
称全部转换成HTML的注释.如果设为"remove",未完成处理的变量名称便会被悄然删除(这也是默认的情况).
halt_on_error = "yes" 为"yes"(默认), "report", "no"三者之一. 决定了模板类错误处理方式.如设为"yes"(默认),错误就会被报告,程序执行也随之中断. 如果设为"report",错误同样会被报告,只是程序继续执行,并返回"false".如果设为"no",错误就被屏蔽掉,程序执行结果返回"false"
last_error = "" 最近的一次错误信息保存在这个变量里面.

内部实例变量

file 字符串散列.一个转换表,可以把变量名转换成与之相对应的文件名.
root 字符串 (路径名). 模板文件被加载的主目录.
varkeys 字符串散列.一个转换表,可以把变量名转换成与之相对应的正则表达式.
varvals 字符串散列.一个转换表,可以把变量名转换成它们各自的varkey对应的替代值.