前言
官网地址:SW- X 框架 - 专一高性能便捷开发而生的 PHP-SwooleX 框架
心愿各大佬举起小手,给小弟一个 star:https://github.com/swoolex/swoolex
1、什么是中间件
中间件属于 AOP 切面编程的衍生,SW- X 中的中间件能够通过绑定路由地址,实现控制器无切入的关联绑定。
在中间件中,能够进行申请拦挡(前置操作)、或者申请缓存销毁(后置操作)等业务。
2、通过路由绑定中间件
接回上章案例,咱们当初要对 /api/*
前缀的所有接口,对立绑定一个名为 Auth
的中间件。
须要先再 /config/middleware.php
中间件配置文件中注册绑定规定:
<?php
return [
// 匹配中间件,路由前半段是 /api/ 结尾的都会绑定到
'/api/*' => [\box\middleware\Auth::class,],
];
所有中间件不强制继承 \x\Middleware
基类,但个别倡议继承,\x\Middleware
类提供了一个 error()
办法,当开发者想中断利用持续向下执行时,能够调用该办法,抛出自定义的提醒内容到客户端,该办法兼容了框架中 4 种不同的服务。
中间件倡议(但不强制)对立寄存在 /box/middleware
目录下,便于项目管理。
接下来,咱们在 /box/middleware/
目录下,创立一个 Auth.php
类,并写入代码:
<?php
/**
* +----------------------------------------------------------------------
* 权限中间件
* +----------------------------------------------------------------------
* 官网:https://www.sw-x.cn
* +----------------------------------------------------------------------
* 作者:小黄牛 <1731223728@qq.com>
* +----------------------------------------------------------------------
* 开源协定:http://www.apache.org/licenses/LICENSE-2.0
* +----------------------------------------------------------------------
*/
namespace box\middleware;
use x\Middleware;
use x\Restful;
class Auth extends Middleware{
// 须要跳过的路由
private $_skip = ['shop/delete',];
// 须要跳过的前置路由
private $_group_skip = ['login/',];
/**
* 前置操作
* @todo 无
* @author 小黄牛
* @version v2.5.0 + 2021.07.20
* @deprecated 暂不启用
* @global 无
* @return void
*/
public function handle() {
// 取得以后路由地址
$route = \x\Config::get('route');
$url = str_replace($route['suffix'], '', ltrim(\x\Request::url(), $route['cutting']));
$url = substr_replace($url, '', 0, (strpos($url, $route['cutting'])+1));
// 跳过校验
if (in_array($url, $this->_skip)) {return true;}
// 跳过校验
foreach ($this->_group_skip as $v) {if (stripos($url, $v) === 0) {return true;}
}
// 通过上下文,取得申请实例
$Request = \x\context\Request::get();
$get = $Request->get;// get 表单
$post = $Request->post;// post 表单
$header = $Request->header;// post 表单
// 没有拜访权限
if (!isset($get['test'])) {Restful::code(Restful::ACTION_ERROR())->callback();
// 返回 false 示意中断执行
return false;
}
// 返回 true 示意持续向下执行
return true;
}
}
同时,因为下面咱们应用了一个 ACTION_ERROR
状态码,所以要在 Restful
状态码文件中退出响应的配置。
/restful/default/code.php
批改成如下代码:
<?php
return [
'ERROR' => 0, // 默认失败状态码
'SUCCESS' => 1, // 默认胜利状态码
'ACTION_ERROR' => 40001, // 默认胜利状态码
];
/restful/default/msg.php
批改成如下代码:
<?php
return [
// 默认谬误状态码对应的 tips
'ERROR' => ['default' => '申请失败', // 默认值],
// 默认胜利状态码对应的 tips
'SUCCESS' => [
'default' => '申请胜利', // 默认值
'test' => '测试 msg',
],
// 权限校验失败
'ACTION_ERROR' => ['default' => '权限校验失败', // 默认值],
];
这时候咱们拜访 http://IP 地址: 端口 /api/shop/select
接口,就会看到框架抛出了上面的状态码:
{
"code": 40001,
"msg": "权限校验失败",
"data": []}
如果拜访 http://IP 地址: 端口 /api/shop/select?test=
就是通过的。
同时,咱们还能够创立 /app/http/v1_0_1/controller/shop/delete.php
和/app/http/v1_0_1/controller/login/send.php
接口,来查看中间件判断是否可能失常跳过。
/app/http/v1_0_1/controller/shop/delete.php
代码如下:
<?php
namespace app\http\v1_0_1\controller\shop;
use x\controller\Http;
// 引入 Restful 组件
use x\Restful;
class delete extends Http
{public function index() {
// Restful 组件抛出接口响应
return Restful::code(Restful::SUCCESS())->data(['title' => '我是 api/shop/delete,跳过了中间件校验',])->callback();}
}
/app/http/v1_0_1/controller/login/send.php
代码如下:
<?php
namespace app\http\v1_0_1\controller\login;
use x\controller\Http;
// 引入 Restful 组件
use x\Restful;
class send extends Http
{public function index() {
// Restful 组件抛出接口响应
return Restful::code(Restful::SUCCESS())->data(['title' => '我是 api/login/send,跳过了中间件校验',])->callback();}
}
创立实现后,就能够通过下列地址查看测试成果了:
http://IP 地址: 端口 /api/shop/delete
http://IP 地址: 端口 /api/login/send