#1 jake

在SpeedPHP框架开发中，开发者可以加入和使用自定义的函数库。

函数库通常是放置到一个专门的函数库文件中，然后在应用程序入口文件的全局位置中载入，然后在系统各处使用。


  • 函数库建议放到专门的文件中进行载入，以方便管理。
  • 函数也可以直接放置在全局位置中，这适用于少量的函数引入的情况。
  • 函数需要通过spAddViewFunction来注册到模板中，才可以在Smarty模板中使用该函数。

这里我们自定义了一个函数叫mydate，作用是提供个性化日期显示，并将其注册到模板中使用，以此为例说明如何放置自定义函数库。

例子下载：dev_diy_functions[1].zip


1. 自定义函数在应用程序目录（APP_PATH）的include目录中，文件名是functions.php，我们在入口文件的全局位置中载入。
require(SP_PATH."/SpeedPHP.php");
// 这里是入口文件全局位置
import(APP_PATH.'/include/functions.php');

spRun();
2. 载入后，直接可以使用，本例中是在/index.php?c=main&a=show中直接使用mydate函数
function show(){
        header("Content-type: text/html; charset=utf-8"); // 直接输出UTF8
        echo mydate(strtotime("-1 day")); // 直接显示mydate函数的结果
        echo "
模板显示
";
}
3. 在functions.php中，我们使用spAddViewFunction来把mydate注册到模板中，由于模板函数的格式和普通函数有些不同，所以加入一个tpl_mydate函数来对mydate进行一下封装。
// mydate函数
function mydate($time = null){
        if( null == $time )$time = time(); // 默认是当前时间
        if( $time > (time() - 3600) ){
                return "刚才";
        }elseif( $time > (time() - 3600 * 24) ){
                return "今天";
        }elseif( $time > (time() -  3600 * 24 * 2) ){
                return "昨天";
        }elseif( $time > (time() -  3600 * 24 * 3) ){
                return "前天";
        }else{
                return date("Y-m-d H:s", $time);
        }
}
// 将mydate注册到模板中使用，所以需要加入tpl_mydate函数进行一次封装
function tpl_mydate($params){
        return mydate($params['time']);
}
// 使用spAddViewFunction来注册，模板中使用thedate来进行调用
spAddViewFunction('thedate','tpl_mydate');
4. 这样，在模板中也可以使用该函数了，调用的方法如下，演示在/index.php?c=main&a=index中。


 
自定义函数演示


显示第一个时间：<{thedate time=$first_time}>

显示第二个时间：<{thedate time=$second_time}>

显示第三个时间：<{thedate time=$third_time}>

直接显示


注意，本例也包括了在函数库中，使用spAddViewFunction来对函数进行注册，以便让函数可以在Smarty模板中使用。
建议将spAddViewFunction的注册放置在函数定义代码附近，这样有利于寻找模板函数定义。

2012-08-05 11:48:02