小说网 找小说 无限小说 烟雨红尘 幻想小说 酷文学 深夜书屋

QuickSkin简明教程

Quickskin其实很简单,基本上看它的example就能看懂。我写这篇东西的目的,只是想给自己的学习留下一个小小的脚印。

属性:

bool $reuse_code

默认值: false

是否将编译好的模板储存起来以便以后使用。如果被设置成false,那么QuickSkin在每次被使用的时候编译模板

string $template_dir

默认值: _skins/

模板读取目录。需要注意的是路径结尾的”/”是必需的!

string $extensions_dir

默认值: quickskin_extensions/

扩展类存放的路径。扩展类是可选的。如果不使用扩展类,那么没有必要修改这个设置。结尾的”/”是必须的

string $temp_dir

默认值: _skins_tmp/

编译之后的模板存放的目录。必须要保证PHP有写入该目录的权限。结尾的”/”是必须的

string $cache_dir

默认值: cache/

输出的缓存文件存放闻之。必须要保证PHP有写入该目录的权限。结尾的”/”是必须的

int $cache_lifetime

默认的输入缓存有效时间,单位是秒。

基本方法

1.void set()

用来设置QuickSkin一些属性,具体属性为第一部分的那些属性

2.void assign()

这个是QuickSkin中赋值的重要操作。主要用法有以下几种

  • $tpl->assign(’name’,$asdf); 这个操作将$asdf这个值赋给模板变量name,在模板中出现{name}的时候,以$asdf替换
  • $tpl->assign($array=array());这里$array是一个一维数组。这里没有模板变量名。其实这是一种比较省事的赋值办法。这里的赋值结果是模板变量名位数组的index,值就为index对应的content的内容。比如$array(“name”=>$name,”gender”=>$gender) 那么上面赋值就相当于$tpl->assign(“name”,$name);
    $tpl->assign(“gender”,$gender);
  • $tpl->assign(“first”,$array1=array());这个地方和上一个有些类似。但是first并非模板变量,而是命名空间。这种情况一般出现在两个数组index相同的情况下,为了区分。比如页面要显示两个人的资料,都有姓名,性别等内容。那么为了区分开,给每个数组一个命名空间,比如first和second。以上一例的数组为例,比如第一个人的姓名在模板中应该表示为{first.name},第二个就为{second.name}.主要的作用就是区分。
  • $tpl->assign(“list”,$list=array(array()));这里$list为一个二维数组,并且第一维的index为数字形式,比如$list[1].$list[2]这样子,二维字段保持一致。这种赋值方法是用在下面控制中,作为循环输出的(具体见控制结构

其实assign的用法不止这些,还有一些其他的,但是主要用法就这么四种,我在使用中也就用到这么四种。别的要么格式太怪,要么就是根本就不适用,所以没有写出,有兴趣可以看看QuickSkin官网的Example

PS:assign的用法可以混用的,具体还是要看需求而定。不过我在使用中都是把所有变量定义在一个多维数组中。只需要assign一次就可以完成。比如
$data['title']=“asdf”;
$data['list']=array(array(“name”=>”Lorry”,”gender”=>”male”),array(“name”=>”duckdull”,”gender”=>”female”);
$tpl->assign($data);

这样子一次性就完成了赋值,index就为模板变量名。比较好用

3.void addtpl()

将一个子模板加到主模版中。

个人觉得这个比较有用,一定程度上可以避免在模板中使用这种格式,使得所有页面问题都交给模板,模板不需要考虑逻辑问题。

举个简单的例子。VIP用户和非VIP用户的用户中心面板。除了侧边栏,其余的全部都相同。将侧边栏做成子模板,则可以在程序中判断加载拿一个子模板,达到VIP和非VIP侧边栏不同的效果。

4.void append()

追加模板变量的内容。模板变量可以为数组也可以为字符串。

举例$tpl->assign(“list”,array(“name”=>”Lorry”));

$tpl->append(“list”,array(“name”=>”duckdull”));

那么这个时候,上面两句话就相当于$tpl->assign(“list”,array(array(“name”=>”Lorry”),array(“name”=>”duckdull”)));

即,从一维数组append成二维数组

append也可以对字符串的变量进行操作,比如

$tpl->assign(“TITLE”,”Hello “);
$tpl->append(“TITLE”,”World”);
$tpl->append(“TITLE”,”!”);

上面就相当于$tpl->assign(“TITLE”,”HELLO World!”);

5.void use_cache()

设置quickskin使用缓存。当客户端在设置的缓存时间内进行页面请求时,直接读取缓存页面,而不是再次编译。需要设置cache_dir和cache_lifetime两个属性。

6.string result()

将模板生成的结果赋值给变量。

7.void output()

将模板生成结果输出到浏览器。

8.void debug()

我用了一下,没法使用,显示class.quickskinparse.php找不到。但是从changelog来看,应该是将class.quickskin.php和class.quickskinparse.php合并。所以个人怀疑这个所谓的项目改名就是将原先SmartTemplate改成了QuickSkin,其余的都保持没变。否则实在是不能解释为何出现class.quickskinparse.php丢失的情况。这个就是根据SmartTemplate的debug来写的的。Debug作用是将所有模板变量输出并且将生成的代码也输出。

控制结构(这个部分是写在模板中的)

打算分为三个部分说,有些单独说觉得很怪

1.IF模块

所有程序语言中都有if这个东西,条件判断的最基本的东西。QuickSkin中也有。语法是这样子


类似于HTML中的注释。这里需要注意的是,首先,IF,ELSE, ENDIF全部需要大写,而且要和前后的”-“有一个空格!这个是必须,否则就被当成注释了!

IF可以对模板变量有如下两个判断1.是否存在;2.是否等于(或者不等于某一个值)。分别举例如下判断id这个模板变量是否存在,也就是是否执行过$tpl->assign(“id”,$anything); 进行赋值过。而则是对name这个模板变量的值进行判断,看其是否等于Lorry。再比如就成了判断模板变量是不是不等于Lorry。PS:需要增加判断条件。如果一开始你用的是,那么就要写成注意,id要和后面的”-“有一个空格!!就没有什么好说的,和PHP、C之类的完全保持一致。

2.BEGIN…END模块

另一个控制模块登场!这个模块作用可是非常强大哦!!可以将一个二维数组循环输出。用上面说到的一个数组打个比方吧。

$tpl->assign(“list”,array(array(“name”=>”Lorry”,”gender”=>”male”),array(“name”=>”duckdull”,”gender”=>”female”)));

我们首先定义了一个模板变量,值为一个二维数组

然后再模板中我们怎么将他们书出来呢?

{name} {gender}

看看发生了什么?输出结果是:

Lorry male duckdull female

怎么样?我们只是定义了一个二维数组,用模板把它们完全打印出来了哦!是不是代码比较简洁呢?以前还需要写foreach,现在,不用了,代码简洁,维护起来也很方便哦!!

PS:BEGIN和END也要和前后的”-”有一个空格,并且END后面要加上BEGIN后面一样的模板变量哦!!

2.INCLUDE模块

INCLUDE模块的作用是将一个文件INCLUDE到当前的模板中,和PHP的include的作用基本相似。我总是觉得这个模块的功能完全可以由addtpl()代替了。不过直接INCLUDE代码效率也许会比addtpl要高,毕竟模板编译是需要时间的。个人倾向于addtpl。反正我觉得这就是SmartTemplate到QuickSkin的过度模块。个人认为而已,轻拍。

PS:INCLUDE也要和前后的”-”|有一个空格!

<!-- BEGIN agent_list -->

   <!-- END agent_list -->

<!-- INCLUDE top.html -->

 <!-- IF nullResult --><div style="width:100%; text-align:left; font-size:12px;">{nullResult}</div><!-- ENDIF nullResult -->

posted on 2008-05-15 13:32  王峰炬  阅读(158)  评论(0编辑  收藏  举报

导航