Download the PHP package admin9/laravel-scramble-extensions without Composer

Laravel Scramble Extensions

为 Laravel 业务接口量身定制的 Scramble (OpenAPI 文档生成器) 扩展包。

主要功能：

• 自动将 200 响应包装为统一的业务信封结构 {success, code, message, data, [meta], request_id}
• 支持场景化表单请求 (Scene FormRequest) 的参数提取
• 支持 Filter 查询参数自动提取（筛选字段、排序、分页）

三个功能模块均可通过配置文件独立开启或关闭。

安装

发布配置文件：

可选依赖

根据你使用的功能，按需安装对应的包：

配置

配置文件 config/scramble-extensions.php：

功能说明

1. 业务响应信封包装 (Response)

自动将所有 200 响应包装为统一的业务信封结构。

控制器需要 use 配置中指定的 trait（默认 Mitoop\Http\RespondsWithJson），通过 $this->success()、$this->error()、$this->deny() 返回响应。

生成的 OpenAPI 文档中，标准响应结构为：

分页响应会额外包含 meta 字段：

2. 场景化表单请求提取 (Scene FormRequest)

支持 mitoop/laravel-efficient-form-request，允许同一个 FormRequest 根据控制器方法名定义不同的验证规则。

扩展会自动查找 FormRequest 上的 {actionName}Rules() 方法并提取参数到 OpenAPI 文档。

store 接口文档会包含 name（必填）和 email（必填）参数，update 接口文档只包含 name 参数。

3. Filter 查询参数提取 (Filter)

支持 mitoop/laravel-query-builder，自动从 Filter 类中提取筛选字段、排序选项和分页参数到 OpenAPI 文档。

生成的文档会自动包含以下 query 参数：

• name、email、status — 筛选字段
• sort — 排序字段，可选值 created_at、name，前缀 - 表示降序
• page_size — 每页条数（默认 15，最大 100，可通过配置修改）
• page — 页码

License

MIT