前言
官网地址：SW-X框架-专一高性能便捷开发而生的PHP-SwooleX框架
心愿各大佬举起小手，给小弟一个star：https://github.com/swoolex/swoolex
1、404接口配置
HTTP服务中，当查找不到对应的路由时，会加载/config/route.php配置文件中的404配置。
以下为具体的参数配置项：
<?phpreturn [ // 找不到路由的时候，是否启用自定义的谬误处理程序 '404' => true, // 自定义的谬误处理程序，只须要提供一个类的命名空间地位即可 'error_class' => '\\box\\http_error',];上面咱们关上/box/http_error.php文件，并批改成以下代码：
<?phpnamespace box;use \x\controller\Http;class http_error extends Http{ /** * 入口 * @todo 无 * @author 小黄牛 * @version v1.0.1 + 2020.05.29 * @deprecated 暂不启用 * @global 无 * @return void */ public function __construct() { return \x\Restful::code(\x\Restful::ONROUTE())->callback(); }}因为下面应用\x\Restful组件，抛出了一个ONROUTE状态码，所以对应的Restful配置也要进行批改：
/restful/default/code.php批改成如下代码：
<?phpreturn [ 'ERROR' => 0, // 默认失败状态码 'SUCCESS' => 1, // 默认胜利状态码 'ACTION_ERROR' => 40001, // 权限校验失败 'ONROUTE' => 40004, // 不存在的接口];/restful/default/msg.php批改成如下代码：
<?phpreturn [ // 默认谬误状态码对应的tips 'ERROR' => [ 'default' => '申请失败', // 默认值 ], // 默认胜利状态码对应的tips 'SUCCESS' => [ 'default' => '申请胜利', // 默认值 'test' => '测试msg', ], // 权限校验失败 'ACTION_ERROR' => [ 'default' => '权限校验失败', // 默认值 ], // 不存在的接口 'ONROUTE' => [ 'default' => '该接口不存在', // 默认值 ],];这时候咱们轻易拜访一个不存在的接口，http://IP地址:端口/api/user/info，就能够看到框架抛出了上面的状态码：
{ "code": 40004, "msg": "该接口不存在", "data": []}2、申请类型限度
SW-X中须要限度某个HTTP控制器的申请类型有多种形式，
第1种是应用@Post、@Get、@Ajax注解进行限度。
第2种，则是应用\x\Validate验证器组件，对申请头进行判断过滤。
个别倡议应用第1种形式，因为非常灵活，而第2种个别是用于对某些同组接口须要进行雷同申请头过滤，例如签名判断等业务时应用。
上面，咱们将/app/http/v1_0_1/controller/shop/delete.php控制器改代码如下：
<?phpnamespace app\http\v1_0_1\controller\shop;use x\controller\Http;// 引入Restful组件use x\Restful;class delete extends Http{ /** * 我只容许Post+Ajax的申请 * @Post * @Ajax */ public function index() { // Restful组件抛出接口响应 return Restful::code(Restful::SUCCESS())->data('您的申请通过啦')->callback(); }}同时，因为该注解的错误信息是由/box/lifecycle/route_error.php生命周期文件进行回调解决，所以咱们还须要将该文件改成以下代码：
<?phpnamespace box\lifecycle;class route_error{ /** * 非凡转换3种注解的Msg值 */ private $tips = [ 'Route Method Get' => '只容许Get申请', 'Route Method Post' => '只容许Post申请', 'Route Method Ajax' => '只容许Ajax申请', ]; /** * 承受回调解决 * @todo 无 * @author 小黄牛 * @version v1.1.5 + 2020.07.15 * @deprecated 暂不启用 * @global 无 * @param Swoole $server 服务实例 * @param string $fd 客户端标识 * @param string $status 谬误事件状态码 * @return bool */ public function run($server, $fd, $status) { $tips = 'Annotate：SW-X Status：'.$status.' ERROR ！'; $type = \x\Config::get('server.sw_service_type'); // 只解决HTTP服务申请的抛出 if ($type == 'http') { if (isset($this->tips[$status])) $tips = $this->tips[$status]; return \x\Restful::code(\x\Restful::LIFECYCLE())->setMsg($tips)->callback(); } return true; }}因为下面应用\x\Restful组件，抛出了一个LIFECYCLE状态码，所以对应的Restful配置也要进行批改：
/restful/default/code.php批改成如下代码：
<?phpreturn [ 'ERROR' => 0, // 默认失败状态码 'SUCCESS' => 1, // 默认胜利状态码 'ACTION_ERROR' => 40001, // 权限校验失败 'ONROUTE' => 40004, // 不存在的接口 'LIFECYCLE' => 20001, // 路由生命周期谬误回调状态码[应用自定义MSG]];留神，生命周期文件批改后，热重载有效，须要手动stop后，从新start服务。
实现重启后，咱们再拜访http://IP地址:端口/api/shop/delete接口，就能够看到框架抛出了上面的状态码：
{ "code": 20001, "msg": "只容许Post申请", "data": []}如果要测试申请胜利，能够应用Postman或Jquery等工具，发送Post-Ajax申请即可。
3、Validate校验表单数据
SW-X种举荐应用\x\Validate验证器组件，对申请进行判断过滤。
具体的应用办法，能够参考官网文档：https://www.sw-x.cn/word/v2.5.x/vali_explain.html
上面咱们来创立一个Shop校验器，用于针对商品分组的API申请。
创立验证器文件/box/validate/Shop.php，写入代码如下：
<?phpnamespace box\validate;use x\Validate;class Shop extends Validate{ // 定义字段对应的规定 protected $rule = [ 'id' => 'require|int', 'title' => 'require|min:10|max:20', 'info.des' => 'min:10|max:20', ]; // 自定义谬误值申明 protected $message = [ 'id.require' => '{id}遗记输出啦', 'title.min' => '{title}不能小于{0}', 'title.max' => '{title}不能大于{0}', 'info.des.min' => '{:preset}不能小于{0}', 'info.des.min' => '{info.des}不能大于{0}', ]; // 场景定义 protected $scene = [ // 批改时应用的场景（简写） 'edit' => ['id','info.des'], // 须要校验的字段 // 删除时应用的场景（简写） 'delete' => ['id'], // 须要校验的字段 ];}上面，咱们将/app/http/v1_0_1/controller/shop/delete.php控制器改代码如下：
<?phpnamespace app\http\v1_0_1\controller\shop;use x\controller\Http;// 引入Restful组件use x\Restful;class delete extends Http{ /** * 应用注解绑定校验器 * @Validate(class="\box\validate\Shop", scene="delete") */ public function index() { // Restful组件抛出接口响应 return Restful::code(Restful::SUCCESS())->data('校验通过啦')->callback(); }}同时，因为该注解的错误信息是由/box/lifecycle/validate_error.php生命周期文件进行回调解决，所以咱们还须要将该文件改成以下代码：
<?phpnamespace box\lifecycle;class validate_error{ /** * 承受回调解决 * @todo 无 * @author 小黄牛 * @version v2.5.6 + 2021-09-15 * @deprecated 暂不启用 * @global 无 * @param string $server_type 服务类型 http/websocket/rpc/mqtt * @param bool $batch 是否全副过滤 * @param array $errors 谬误验证后果集 * @return bool */ public function run($server_type, $batch, $errors) { // $batch 是用于执行全副过滤规定,再最初一起返回全副的谬误起因 // 默认生命周期只返回第一个谬误起因 $error = $errors[0]['intact_field'].' => '.$errors[0]['message']; // 只解决HTTP服务申请的抛出 if ($server_type == 'http') { return \x\Restful::code(\x\Restful::VALIDATE())->setMsg($errors[0]['message'])->callback(); } return true; }}因为下面应用\x\Restful组件，抛出了一个VALIDATE状态码，所以对应的Restful配置也要进行批改：
/restful/default/code.php批改成如下代码：
<?phpreturn [ 'ERROR' => 0, // 默认失败状态码 'SUCCESS' => 1, // 默认胜利状态码 'ACTION_ERROR' => 40001, // 权限校验失败 'ONROUTE' => 40004, // 不存在的接口 'LIFECYCLE' => 20001, // 路由生命周期谬误回调状态码[应用自定义MSG] 'VALIDATE' => 20002, // 校验器生命周期谬误回调状态码[应用自定义MSG]];留神，生命周期文件批改后，热重载有效，须要手动stop后，从新start服务。
实现重启后，咱们再拜访http://IP地址:端口/api/shop/delete接口，就能够看到框架抛出了上面的状态码：
{ "code": 20002, "msg": "id遗记输出啦", "data": []}拜访http://IP地址:端口/api/shop/delete?id=1，就能够通过delete的校验场景了。