phplib类中文详解


<?php
/*
* PHPlib模板7.4中文版(不足之处还请各位指正)
* (C) Copyright 1999-2000 NetUSE GmbH
* Kristian Koehntopp
* 彭赞群注释于2004年6月,QQ:9537075 TEL:13787877670
* Email:mylovepzq@163.com
*/
  
/*这里是定义类Template*/
class Template
{
/* 如果设置了,则输出参数 */
var $classname = "Template";
var $debug = false; //是否调试
var $root = ".";//root为模板文件的存放目录
var $file = array(); //包含了所有的模板文件名和模板名的数组
var $varkeys = array(); //存放文本元素的键名
var $varvals = array(); //存放文本元素的值
var $unknowns = "remove";
/* "remove" => 删除未定义的变量 "comment" => 将未定义的变量变成注释 "keep" => 保留未定义的变量 */
var $halt_on_error = "yes";
/* "yes" => 退出 "report" => 报告错误,继续运行* "no" => 忽略错误*/
var $last_error = "";
/* 上一次的错误保存在这里 */
/* public: 构造函数
* root: 模板目录
* unknowns: 如何处理未知的变量(译者:变量定义为{ name })
*/
  
/*这里是定义函数Template*/
function Template($root = ".", $unknowns = "remove")
{
if ($this->debug & 4)
{
echo "<p><b>模板:</b> root = $root, unknowns = $unknowns</p>n";
}
$this->set_root($root);//默认将文件目录设置为相同的目录
$this->set_unknowns($unknowns);//unknowns默认设置为"remove"
}
  
/*这里是函数set_root*/
function set_root($root)
{
if ($this->debug & 4)
{
echo "<p><b>设置根目录:</b> root = $root</p>n";
}
if (!is_dir($root))
{
$this->halt("设置根目录: $root 不是一个无效的目录.");
return false;
}
$this->root = $root;
return true;
}
  
//这里是函数set_unknowns,即对未知变量的处理
function set_unknowns($unknowns = "remove")
{
if ($this->debug & 4)
{
echo "<p><b>未知的:</b> 未知 = $unknowns</p>n";
}
$this->unknowns = $unknowns;
}
  
/*这里是函数set_file.......................................................*/
//该方法在数组file中根据$varname提供的键名加入值
function set_file($varname, $filename = "")
{
if (!is_array($varname))//如果varname是数组
{
if ($this->debug & 4)
{
echo "<p><b>设置文件:</b> (with scalar) varname = $varname, filename = $filename</p>n";
}
if ($filename == "")//如果文件名为空,输出错误
{
$this->halt("设置文件:变量名 $varname 文件名是空的.");
return false;
}
$this->file[$varname] = $this->filename($filename);
}
else
{
reset($varname);//将varname的键名作为file数组的键名
//将键名对应的值作为file数组的值
while(list($v, $f) = each($varname))
{
if ($this->debug & 4)
{
echo "<p><b>set_file:</b> (with array) varname = $v, filename = $f</p>n";
}
if ($f == "")
{
$this->halt("set_file: For varname $v filename is empty.");
return false;
}
$this->file[$v] = $this->filename($f);
}
}
return true;
}
  
//该方法取出某个父模板文件中的一个子模板
//将其作为块来加载
//并用另外一个模板变量取代之
/* public: set_file(array $filelist)
* comment: 设置多个模板文件
* filelist: (句柄,文件名)数组
* public: set_file(string $handle, string $filename)
* comment: 设置一个模板文件
* handle: 文件的句柄
* filename: 模板文件名
*/
function set_block($parent, $varname, $name = "") {
if ($this->debug & 4) {
echo "<p><b>set_block:</b> parent = $parent, varname = $varname, name = $name</p>n";
}
if (!$this->loadfile($parent)) {
$this->halt("set_block: unable to load $parent.");
return false;
}
if ($name == "") {
$name = $varname;//如果没有指定模板变量的值就用子模板名作为模板变量名
}
  
$str = $this->get_var($parent);
$reg = "/[ t]*<!--s+BEGIN $varnames+-->s*?n?(s*.*?n?)s*<!--s+END $varnames+-->s*?n?/sm";
preg_match_all($reg, $str, $m);
$str = preg_replace($reg, "{ " . "$name }", $str);
$this->set_var($varname, $m[1][0]);
$this->set_var($parent, $str);
return true;
}
  
//该方法向Varname和varkeys数组中添加新的键一值对
/* public: set_var(array $values)
* values: (变量名,值)数组
* public: set_var(string $varname, string $value)
* varname: 将被定义的变量名
* value: 变量的值
*/
function set_var($varname, $value = "", $append = false) {
if (!is_array($varname))//如果不是阵列
{
if (!empty($varname)) //如果是空的
{
if ($this->debug & 1) {
printf("<b>set_var:</b> (with scalar) <b>%s</b> = '%s'<br>n", $varname, htmlentities($value));
}
$this->varkeys[$varname] = "/".$this->varname($varname)."/";
if ($append && isset($this->varvals[$varname])) {
$this->varvals[$varname] .= $value;
} else {
$this->varvals[$varname] = $value;
}
}
} else {
reset($varname);
while(list($k, $v) = each($varname)) {
if (!empty($k)) {
if ($this->debug & 1) {
printf("<b>set_var:</b> (with array) <b>%s</b> = '%s'<br>n", $k, htmlentities($v));
}
$this->varkeys[$k] = "/".$this->varname($k)."/";
if ($append && isset($this->varvals[$k])) {
$this->varvals[$k] .= $v;
} else {
$this->varvals[$k] = $v;
}
}
}
}
}
  
//定义函数clear_var
function clear_var($varname) {
if (!is_array($varname))//如果varname不是阵列
{
if (!empty($varname)) //如果是空的
{
if ($this->debug & 1) {
printf("<b>clear_var:</b> (with scalar) <b>%s</b><br>n", $varname);
}
$this->set_var($varname, "");
}
} else {
reset($varname);
while(list($k, $v) = each($varname)) {
if (!empty($v)) {
if ($this->debug & 1) {
printf("<b>clear_var:</b> (with array) <b>%s</b><br>n", $v);
}
$this->set_var($v, "");
}
}
}
}
  
/*这里是函数unset_var,删除变量的定义*/
function unset_var($varname) {
if (!is_array($varname)) {
if (!empty($varname)) {
if ($this->debug & 1) {
printf("<b>unset_var:</b> (with scalar) <b>%s</b><br>n", $varname);
}
unset($this->varkeys[$varname]);
unset($this->varvals[$varname]);
}
} else {
reset($varname);
while(list($k, $v) = each($varname)) {
if (!empty($v)) {
if ($this->debug & 1) {
printf("<b>unset_var:</b> (with array) <b>%s</b><br>n", $v);
}
unset($this->varkeys[$v]);
unset($this->varvals[$v]);
}
}
}
}
  
//将模板文件中的变化内容替换成确定内容的操作,实现数据和显示的分离
function subst($varname) {
$varvals_quoted = array();
if ($this->debug & 4) {
echo "<p><b>subst:</b> varname = $varname</p>n";
}
if (!$this->loadfile($varname)) //装载模板文件,如果出错就停止
{
$this->halt("subst: unable to load $varname.");
return false;
}
  
reset($this->varvals);
while(list($k, $v) = each($this->varvals)) {
$varvals_quoted[$k] = preg_replace(array('//', '/$/'), array('', '
« 
» 
快速导航

Copyright © 2016 phpStudy | 豫ICP备2021030365号-3