Apisupport

一、安装

功能：

• 图片验证码
• 阿里短信验证码
• 路由守卫中间件
• 用户登录
• 文件上传与获取

二、配置

2.1 异常处理

在文件 app\Exceptions\Handler.php 中添加以下方法：

2.2 创建迁移

运行命令后，将会生成7个表：

1. oauth_access_tokens

2. oauth_auth_codes

3. oauth_clients

4. oauth_personal_access_clients

5. oauth_refresh_tokens

6. files

7. user_files

2.3 执行 Aritsan 命令

运行此命令后，生成：

• 安全访问令牌加密秘钥；

  \storage\oauth-private.key

  \storage\oauth-public.key

• 访问令牌的 个人访问客户端(id:1) 和 两个密码授权客户端(id:2，id3)

2.4. 添加 Trait

添加 Laravel\PassportHasApiTokens trait 到 App\Models\User 模型中，此 trait 提供一些帮助方法用于检查已认证用户的令牌和权限范围。

2.5 配置文件

在配置文件config/auth.php 中，将 api 的授权看守器 guards 的 driver 设置为 passport。

2.6 .自定义用户名字段

当使用密码授权方式验证时，Passport 默认使用你的授权模型的 email 属性作为 “用户名”。当然，你也可以通过在你的模型中定义 findForPassport 方法来定义验证行为：

2.7 自定义密码验证

当使用密码授权方式时，Passpot 默认使用模型的 password 属性验证密码。如果你的模型没有 password 属性，或者你想自定义密码验证逻辑，你可以在你的模型中自定义方法 validateForPassportPasswordGrant:

2.8 添加环境变量

三、使用

3.1 返回状态码

对应的枚举类型

Idopin\ApiSupport\Enums\ApiCode

3.2 响应 Trait

ApiResponseTrait , 它主要提供了 response 方法 和 responseEqual 方法。

Idopin\ApiSupport\Traits\ApiResponseTrait

3.3 控制器基类

Idopin\ApiSupport\Controller

控制器基类引用了 响应 Trait，可直接通过 $this->response(...) 调用。

3.4 辅助函数

3.5 表单验证基类

Idopin\ApiSupport\Requests\FormRequest

表单验证基类引用了 响应 Trait，可直接通过 $this->response(...) 调用。

3.6 资源基类

Idopin\ApiSupport\Resources\JsonResource

响应内容包裹了在 result 里。

并带有以下三个字段：

• http_status
• code
• message

3.7 异常 Trait

Idopin\ApiSupport\Traits\trait ApiExceptionTrait

3.8 验证码中间件

3.9 路由

3.9.1 用户认证

3.9.2 文件上传

3.9.3 图片与短信验证码