phalapi-进阶篇3(自动加载和拦截器)

前言

先在这里感谢phalapi框架创始人@dogstar,为我们提供了这样一个优秀的开源框架.

最近工作上的事情比较多,所以文档更新得比较慢,还望大家见谅!接下来为大家带来的是对此框架自动加载机制的一个小的引导,简单地来聊聊它是如何实现此类机制的,并在了解之后要怎样去使用。同时再探讨一下如何使用自动加载来构建自己的公用函数以及拦截器,包括如何使用拦截器等,在这里强调一下,在进阶篇中谈论思想会比较多,大家可以慢慢去消化。涉及的很多地方都是此框架优秀的地方所在,因此,拿出来分享是为了让大家能够更好的了解phalapi框架,并且可以运用到自己的代码中去!

附上:

喵了个咪的博客:w-blog.cn

官网地址:http://www.phalapi.net/

开源中国Git地址:http://git.oschina.net/dogstar/PhalApi/tree/release

1. 自动加载机制

关于自动加载,使用phalapi框架的大家应该已经非常熟悉了。三层结构自动加载请求调用在大家看来基本上感觉不到自动加载机制的存在,其实,它早就被注册到接口文件里了,只是有一套完整的机制来封装这类事务让我们摸不着,我们的接口文件就是在index.php

//装载你的接口
DI()->loader->addDirs(array('Demo', 'Library'));

大家不妨进入到addDirs里面瞧瞧

public function addDirs($dirs) {
    if(!is_array($dirs)) {
        $dirs = array($dirs);
    }
    $this->dirs = array_merge($this->dirs, $dirs);
}

其实,当我们使用到addDirs的时候,框架内部只是把我们定义好的路径存了起来;其实关键的地方已经在初始化PhalApi_Loader的时候被触发了,我们来一起看下PhalApi_Loader的构造函数

public function __construct($basePath, $dirs = array()) {
    $this->setBasePath($basePath);
    if (!empty($dirs)) {
        $this->addDirs($dirs);
    }
    spl_autoload_register(array($this, 'load'));
}

第一句方法的意思是设置根目录,后面一个判断条件和我们使用addDirs是一样的作用,那么问题来了spl_autoload_register做了什么呢?官方给出的解释是这样的:

将函数注册到SPL__autoload函数队列中。如果该队列中的函数尚未激活,则激活它们

参数

欲注册的自动装载函数。如果没有提供任何参数,则自动注册autoload的默认实现函数spl_autoload()

其实说白了就是当实例化类的时候找不到可以用的类的时候,就会请求在spl_autoload_register中定义好的处理方法,在此框架中配置的处理函数也就是PhalApi_Loader/load函数。

关于具体是如何实现匹配,如何找到路径,再如何引入,这里就不详细说明了。当我们每次去new一个类的时候,都会先去寻找有没有匹配的类,当没有匹配到的情况下,我们new的类名就会传递到PhalApi_Loader/load函数中去处理,根据框架规则引入我们需要的文件.

2. 公用函数和拦截器

当我们会使用自动加载机制了之后,我们就可以来构建我们项目的公用函数和拦截器了,为什么要使用公用函数呢?在大部分请求下我们一套框架可能支持多个项目,当然项目与项目之间会有不同的函数等等,但是也有公用的比如debug,发送短信等等一些所有项目都可能去用到的一些功能性函数,或者是一些针对项目的拦截器。

2.1 公共函数

首先在我们的根目录建立一个文件夹叫做General通用的意思,里面分别有两个文件夹Common(受TP的影响)和Intercept两个文件,我们在里面放入我们自己的文件,当然需要按照正确的规则比如Common_Base等

然后我们要使用的时候,先加载这个general文件作为自带加载文件,然后注册自己需要用的类,如下:

//加载项目通用文件
DI()->loader->addDirs('General');
//通用函数基础类
DI()->base = new Common_Base();

2.2 拦截器

对于API来说,拦截器的意义无疑是巨大的,为什么这么说呢,应为API是提供服务器的,我们可以用拦截器做很多的限制,比如限制开放接口,参数转移、json解包、请求解密,token校验等等。

//拦截器
$Intercept           = new Intercept_app_default();
//转换参数
$_REQUEST            = $Intercept->turnparameter($_REQUEST);

作为参考,拦截器接收所有的post和get参数后在内部统一做处理。参数转换、请求解密、token校验等这些都是日常用到的,不详提。这里拿一个有代表性的来说明一下就是json解包,为什么要json解包呢?因为在很多公司使用请求传参的时候,都是封装成一个json请求过来的,框架接收是能接收到,但是无法使用框架自带的参数做完整性校验了。令我非常难受(也有很多朋友也遇到此类问题),所以自己写了一个解包方法:

//递归解包
function test($params, $server){
    if(is_array($params)){
        foreach($params as $k => $v){
            $server[$k] = $v;
            $server = test($v, $server);
        }
    }
    return $server;
}
//模拟一个json数组
$params = array(
    'a' => array(
        'c' => 3,
        'd' => 4
    ),
    'b' => 2,
);
$server = array();
var_dump(test($params, $server));

我们获取到的返回结果是array(4) { ["a"]=> array(2) { ["c"]=> int(3) ["d"]=> int(4) } ["c"]=> int(3) ["d"]=> int(4) ["b"]=> int(2) }也就是把数组中的底层元素全部移到了和a,b同级的目录,并且也保证了a的数组完整性,必须要注意同名的问题。

3. 总结

本小节,主要讲述了一下关于自动加载的机制,以及为什么要使用拦截器的原因和怎么让json通过拦截器也能使用框架的校验机制。今天就先到这里了,希望此教程能够给你们带来帮助。在下一小节中将会对model层和事务进行已经深入的讲述。祝大家天天开心~

注:笔者能力有限,有说的不对的地方,希望大家能够指出,也希望多多交流!

官网QQ交流群:421032344 欢迎大家的加入!

上一章 文档首页 下一章

还有疑问?欢迎到社区提问!    切换到PhalApi 2.x 开发文档。

Fork me on GitHub