如何在Laravel/Lumen中无注解生成API文档？求可用自动工具

云上老周

2026-8-12

Laravel/Lumen 自动生成API文档的替代工具

以下是几个成熟的、能自动生成Laravel/Lumen API文档的工具：

Scribe
适配Laravel和Lumen，自动解析路由、控制器逻辑，同时支持通过注释补充API细节。安装命令：
```
composer require knuckleswtf/scribe --dev
```
生成文档执行：
```
php artisan scribe:generate
```
Lumen环境需额外配置服务提供者。它能生成美观的交互式HTML文档，还支持导出Postman、OpenAPI等格式。
Laravel API Documentation Generator
老牌工具，核心基于代码注释解析。安装命令：
```
composer require mpociot/laravel-apidoc-generator --dev
```
生成文档执行：
```
php artisan api:generate
```
支持自定义注释标签来补充请求参数、响应示例等信息，Laravel直接可用，Lumen需手动注册服务提供者。
laravel-openapi（搭配OpenAPI规范）
适合需要标准化OpenAPI文档的场景，通过注解定义API的请求结构、响应模型。安装命令：
```
composer require vyuldashev/laravel-openapi --dev
```
配置注解后可生成符合OpenAPI规范的JSON/YAML文件，再借助OpenAPI工具转成可视化HTML文档。
L5-Swagger
基于Swagger/OpenAPI生态，提供可视化的API测试界面。安装命令：
```
composer require darkaonline/l5-swagger --dev
```
生成文档执行：
```
php artisan l5-swagger:generate
```
Laravel环境适配完善，Lumen需要手动配置服务提供者和路由。