SpeedPHP/自定义函数库

来自站长百科
跳转至: 导航、​ 搜索

SpeedPHP | 快速入门 | 访问交互 | 数据操作 | 框架概述 | 模板引擎 | 优化加速 | 开发指南 | 数据模型 | API参考

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

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

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

自定义函数库[ ]

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

例子下载:http://speedphp.com/cms/uploads/dev_diy_functions.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 "<p><a href="".spUrl('main','index')."">模板显示</a></p>";
}

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

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
<title>自定义函数演示</title>
</head>
<body>
<p>显示第一个时间:<{thedate time=$first_time}></p>
<p>显示第二个时间:<{thedate time=$second_time}></p>
<p>显示第三个时间:<{thedate time=$third_time}></p>
<p><a href="<{spUrl c=main a=show}>">直接显示</a></p>
</body>
</html>

注意:本例也包括了在函数库中,使用spAddViewFunction来对函数进行注册,以便让函数可以在Smarty模板中使用。

建议将spAddViewFunction的注册放置在函数定义代码附近,这样有利于寻找模板函数定义。

参考来源[ ]

http://speedphp.com/manual.html

SpeedPHP使用手册导航

快速入门

开始使用SpeedPHP | 制作留言本 | 简便的数据表操作 | 用Smarty来显示页面

访问交互

入口文件 | 控制器架构 | 网址生成与PATH_INFO | 获取提交数据 | URLRewrite伪静态 | 自定义伪静态URL | 几种跳转 | 多语言实现 | 权限控制 | session、cookie | Ajax应用

数据操作

编写数据模型类 | 常规操作CRUD | 安全过滤 | 简化操作spDB | 数据变量存储 | 缓存配置

框架概述

单入口应用程序 | 架构设计 | 第三方类库及扩展功能 | UTF8编码与GBK版本 | SAE云计算版

模板引擎

模板引擎配置 | 使用Smarty | Smarty开发教程 | 自动显示模板| speedy教程 | 为什么使用模板其常见问题 | 模板包含文件 | 注册函数 | 全局变量赋值 | CSS和JS的路径

优化加速

生成静态HTML概述 | 生成HTML的使用 | 分页 | 高效函数缓存器| 模板引擎缓存

开发指南

核心函数 | 格式输出变量调试dump | 载入包含文件import | 类实例化函数spClass | 开发流程 | 目录结构、路径设置 | 大规模系统部署 | 用户自定义及全局操作 | 自定义函数库 | 自定义类库 | 自定义404页面 | 程序调试dump变量调试安全建议及命名建议

数据模型

高级数据库操作 | 数据表一对一关联 | 数据表一对多关联 | 数据表多对多关联 | 一表关联多表 | 关联结果的条件限制 | 关联结果在Smarty模板中显示 | 多数据库、数据表 | 多种类型数据库的配置 | 重写CRUD操作| 业务数据封装 | 数据函数复合调用

API参考

spModel数据库操作类 | spPager分页类 | spVerifier数据验证类 | spCache函数数据缓存类 | spLinker数据表关联实现类 | spView视图类 | spHtml静态HTML生成类 | spController控制器类 | spArgs环境参数类 | 配置 | 数据库驱动类 | 模板驱动类 | import载入文件