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 -->