[分享]STE---轻型PHP模板引擎下载

本文提供的附件下载是：

http://syu.iteye.com/topics/download/4a0e681f-6fda-358f-ae51-401a8f968eae

http://syu.iteye.com/blog/372544

特别注明：

STE是基于SmartTemplate的修改版本,其在SmartTemplate的设计上做了大量修改,以及使用PHP5的语法进行了重写. Smarttemplate是一套较轻型的PHP模板处理引擎，相对于流行的Smarty,它更加小巧灵活，但功能却仍然强大。重要的是它的设计思想不像其它模板处理引擎那样追求大而全。而在于尽量减少页面内的逻辑流程，将模板与最终视图之间的差异性降到最低。这也是我这么多年来业直使用Smarttemplate而不是smarty的原因。（两者之间的差异比较，请访问我的另一篇博客 http://blog.csdn.net/syu/archive/2008/12/12/3502884.aspx）

修改的必要性：

SmartTemplate很久没有更新了，第一次使用它是大概在2002年左右，直到2008年它还是当初那个样子 :-( 而在这些日子里，除去PHP本身发生了很大的变化，我在很多次使用中也认为它的功能不足以满足我的需求。因此决定在某一个晚上花费一点休息时间将它进行重构。

修改的部份：

1. IF 条件进行了改写，现在你可以在IF里使用多种判断条件，比如 and 或者 or,尽管这在其它模板引擎里早已实现。但原来的Smarttemplate仅仅支持 等于 或 空值判断。

2. BEGIN 循环处理进行了改写，在BEGIN里除了注册的变量单位外，还可以完全使用 {_KEY},{_VALUE},{_ROWCNT},{_ROWBIT}这样的内部变量。

3. 增加了$_SESSION,$_SERVER,$_GLOBALS的PHP超级全局变量访问形式，可以不用注册而直接在页面中使用类似{SESSION.username}的方式访问一些频繁使用的超全局变量。

4.增加了INCLUDE语法的模板嵌套。这样一些多个页面中使用的相同部份，比如头部和尾部，就可以被直接嵌套。而不用在每个页面中写入相同的代码。

5.改写了smarttemplate的扩展处理模式，可以在页面中使用任何已注册的函数，或者自动装载为smarttemplate准备的扩展插件。在页面中可以直接用{date:'Y-m-h'}的形式显示当前时间，相当于<?php echo date('Y-m-h');?>

6.改写了编译机制和缓存机制。

7.使用PHP5.3语法以及OOP进行重写。

8.去掉了debuger部份，并将原来的两个文件合并成为一个，减少了一次include.

9.优化了不少结构和算法，增加了加载配置方法，改写了原有的读取$_CONF数组配置的方式，减少了冲突的可能。

10.实在想不起来了。

使用说明：

一，生成实例对象、指定模板页面、加载配置、输出页面

<?php

include('ste.class.php');

$tpl = new ste( ) ; //只实例化对象。稍后指定模板页面

//$tpl = new ste('tpl.html'); 实例化的同时，指定模板页面

$tpl -> LoadConfig(array('compiled_dir'=>'./tpl_compiled/','template_dir' =>'./tpl/')); //加载配置

$tpl -> output();

/*

其中配置项包括：

template_dir -------------- 模板文件的默认存放目录。

compiled_dir-------------- 编译后模板文件的存放目录

ext_dir -------------- STE扩展插件目录

cache_dir -------------- 缓存文件生成后的存放目录

cache_lifetime-------------- 缓存文件的生命周期，秒为单位

*/

？>

二，变量注册，追加以及页面中的表现形式

<?php

.........

/*

$hi= 'hello!',单变量注册，在模板中可以用 {hi}来显示

*/

$tpl -> assign('hi',$hi);

/*

$arrayData=array('a'=>1,'b'=>2) ,数组变量集体注册，页面中可用{a},{b}来显示元素

*/

$tpl -> assign($arrayData);

/*

$data = array(0=>array('id'=>1,'name'=>'a'),1=>array('id'=>2,'name' =>'b'));

注册循环数组，页面中可用BEGIN语法循环输出

*/

$tpl -> assign('data',$data);

/*

$data 可以等于数组，也可以是单变量。append方法将数据追加到原有注册标签中。

如果原有注册标签是单变量，新值将以（.）形式追加。如果原有标签是数组，将以([])形式追加

*/

$tpl -> append('data',$data);

三，逻辑控制和循环

在页面中进行逻辑控制。使用 <!-- IF ELSE ELSEIF ENDIF -->方式。

<!-- IF {a}>100 -->

显示一段HTML代码

<!-- ELSEIF {a}>20 -->

显示另一段HTML代码

<!-- ELSE -->

显示其它的HTML代码

<!-- ENDIF -->

在页面中使用循环输出，使用<!-- BEGIN 注册变量名 --> <!-- END 注册变量名 -->方式 .

//一维数组循环：$tpl->assign('test',array(1,2,3,4,5));

<!-- BEGIN test -->

{_VALUE}

<!-- END test -->

//带键值的一维数组循环：$tpl->assign('test',array('a'=>1,'b'=>2,'c'=>3));

<!-- BEGIN test -->

{_KEY}的值是：{_VALUE}

<!-- END test -->

/* 二维数组循环（比如从数据库中取出的数据）：

$tpl -> assign('test',array(0=>array('id'=>1,'name'=>'a'),1=>array('id'=>2,'name' =>'b')));

*/

<!-- BEGIN test -->

{id}对应的name值是：{name}

<!-- END test -->

循环体中内置的还有：

{_ROWCNT} ----- 从1开始计数的自增变量。可用于在列表中显示顺序。

{_ROWBIT}----- 从0到1的替换值。第一行是0，第二行是1，第三行是0，以此类推。用于两列间不同css样式的值

四，页面模板嵌套

STE中可以自由嵌套模板。使用方法为 <!-- INCLUDE 模板名 -->

比如一个网站模板，我们可以把公用的头，尾部份分离出来供许多其它页面模板调用。

<!-- INCLUDE head.html -->

.................其它模板代码

<!-- INCLUDE foot.html -->

值得注意的是，引用了嵌套页面的主模板，在被嵌套的页面代码发生了改变时，需要手工清理一下编译缓存，重新编译方能生效。这样做是为了加快速度。STE的缓存机制虽然能够在模板发生改变时自动重新编译，但凡是引入了嵌套的模板，为了避免每次使用都重新读入嵌套页面，会在编译时将嵌入页面的所有代码读入，与自身成为一体。

五，页面中使用函数以及STE插件

在页面中，你可以通过{函数名：参数1，参数2...}的形式任意引用PHP内置的、或者你自身定义的函数。并且能够自由管理参数（原有的smarttemplate只允许使用最多两个参数）。比如，需要在页面中显示一个当前时间时，可以使用

{date:'Y-m-d'}这样的方式。

在参数表中，允许使用的参数包括

1 字符串 使用单引号或者双引号连接，但不接受诸如 (.)这样的操作符

2 数学 直接的数学字符，比如 123

3 注册的变量名 比如$tpl ->assign('var',123);后，在页面中可以使用 {userfunc:var}的形式。

当引用的函数名不存在时，会自动的加载STE插件目录下的文件（根据配置中ext_dir目录读取）。比如当引用 {usericon:uid}时。如果usericon函数没有被定义。STE将自动找寻ext_dir目录中 ste_ext_usericon.class.php文件，并将其读入，在这个文件中，应该有关于usericon函数的定义。

当不需要将一个函数的结果输出时（例如函数体内部本身就带有输出。而函数返回的仅仅是一个True或False）时，可以在函数名前面加上 (^)符以关闭输出，比如 {^usericon:uid}

这里有一点例外的说明是:我不是很赞成在页面中放置太多的函数体以及逻辑判断语句。我一直认同的观点是：

应该尽量减少模板与最终呈现页面之间的差异，模板中引入的尽量保证是变量而不是流程。大量的流程处理请交给程序来执行。这样才能最大化的符合MVC的三层分离思想。在一个模板中大量使用逻辑，或者大量使用函数的话，请问与直接在模板中直接写<?php 又有什么区别呢？再强大的PHP模板引擎也强不过php 本身。