Aug 19

PHPlib Template 中文文档

admin , 12:49 , 编程 » 编程(PHP) , 评论(0) , 引用(0) , 阅读(2577) , Via 本站原创 | |
怎么手机十秒时时监控          拍拍购物综合频道 正品1折起 惊喜多多      拍拍女装特卖频道,汇集了最新的女装时尚新款 正品1折起,爱美的我还在等什么
     手机访问 就能天天 特价     电脑访问 爱淘宝go

可调用的实例变量
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对应的替代值.

可调用实例方法
Template($root = “.”, $unknowns = “remove”)
构造函数.可以有两个可选的参数.第一歌参数设定模板所在目录,第二个参数设定未知变量的处理方式.

set_root($root)
该函数检查$root是否为一个有效的目录,然后把这个模板存放所在目录设为瞩目路.

set_unknowns($unknowns = “remove”)
该 函数设定未处理的变量名称的处理方式.必须是”remove”,”comment”或”keep”三者中的一个. 如果设为”keep”,这些变量名称将原封不动的保留下来.如果设为”comment”,那么会在报错的同时,将未完成处理的变量名称全部转换成HTML 的注释.如果设为”remove”,未完成处理的变量名称便会被悄悄的删除(这是默认的情况).

set_file($varname, $filename = “”)
该函数为一个函数的初值定义一个文件名,可以用一个$varname/$filename对或者一系列的$varname/$filename对来调用它.这些文件只有在需要时才会被加载.

set_block($parent, $varname, $name = “”)
变量$parent可包含一个以$varname命名的变量块.该函数会从$parent中把这个块删除,然后用一个名称为$name的变量代替它.如果$name被忽略了,那么它将被假定为和$varname一样

set_var($varname, $value = “”)
该函数设定一个变量的初值.可以用一个$varname/$value对或者一系列的$varname/$value对来调用它.

subst($varname)
该函数返回一个名为$varname的变量的值,所有以定义变量的值都已经填入.结果字符串并不是最终结果,而是未完全处理变量的处理还没有应用前的结果.

psubst($varname)
这个是print $this->subst($varname)的简写形式.

parse($target, $varname, $append = false)
该函数替代以$varname为名中的所有已定义变量的值,并存储或附加在以$target为变量名的结果中.
如果$varname为变量名数组,$append就会被屏蔽.以$varname为名的变量被连续的替代,每一个替代步骤的结果都存在$target里.最终的替代结果
可在以$target为名的变量里获得,可以视为下一个$varname的一个中间处理环节.

pparse($target, $varname, $append = false)
这个是print $this->parse(…). 的简写形式

get_vars()
返回所有以定义值的序列,每个值都以其名字为键.

query_id()
返回以$varname命名的变量的值.如果$varname对应着一个文件,而且文件尚未加载,就会报告变量为空.当用变量名称数组调用时,会返回一个值的序列,以它们的名字为键.

get_undefined($varname)
该函数以$varname,名称未键的方式,返回一系列未处理变量名称(即一个含$a[$name]=$name的序列).

finish($str)
该函数将返回$str的最终版本,即针对未完全处理的处理方式将应用到$str上来.

p($varname)
该函数将输出以$varname命名的变量的最后版本的值.

get($varname)
该函数将得到以$varname命名的变量的最后版本的值.

haltmsg($msg)
该函数可以在你的模板子类中被覆写.它可以输出用来调用的信息.

内部实例方法
filename($filename)
当用一个相对路径调用时,函数返回一个路径名,附带从$this->root中提取的合适的目录名.如果是绝对路径,则不加变化即被使用.
结果文件名必须是存在的,否则就会长生一个错误.

varname($varname)
该函数根据所给的变量名称构造一个变量名称表达式(译注:即 var -> {var}).

loadfile($varname)
如果一个变量未定义或者为空,并且对应一个文件,对应着的这个文件就会被加载,文件内容将被赋为该变量的值.

halt($msg)
无论何时发生了一个错误,这个函数都将被唤起,并根据 $this->halt_on_error定义的方式处理这个错误.

你还可以参阅英文文档: http://www.sanisoft.com/phplib/manual/index.php

From:http://www.99xunle.com/archives/712