php - 查看 Swagger API 文档
问题描述
我正在尝试使用swagger-php和l5-swagger为 laravel 5.7 应用程序生成 swagger(openapi) api 文档
这是我的第一次尝试,这是我按照文档进行的操作
作曲家需要 zircote/swagger-php
作曲家需要darkaonline/l5-swagger
添加
L5Swagger\L5SwaggerServiceProvider::class,
到 config/app.php 文件向 BookController 添加注释
运行命令
php artisan l5-swagger:generate
我的 BookController 看起来像这样带有注释
/**
* @OA\Info(
* version="1.0.0",
* title="Laravel Test OpenApi",
* description="L5 Swagger OpenApi description",
* @OA\Contact(
* email="menadio1@gmail.com"
* ),
* @OA\License(
* name="Apache 2.0",
* url="http://www.apache.org/licenses/LICENSE-2.0.html"
* )
* )
*/
/**
* @OA\Server(
* url=L5_SWAGGER_CONST_HOST,
* description="L5 Swagger OpenApi dynamic host server"
* )
*
* @OA\Server(
* url="https://projects.dev/api/v1",
* description="L5 Swagger OpenApi Server"
* )
*/
class BookController extends Controller
{
/**
* @OA\Get(
* path="/books",
* operationId="getBooksList",
* tags={"Books"},
* summary="Get list of books",
* description="Returns list of books",
* @OA\Response(
* response=200,
* description="successful operation"
* ),
* @OA\Response(response=400, description="Bad request"),
* )
*
* Returns list of books
*/
public function index()
{
return BookResource::collection(Book::all());
}
}
现在如何查看 api 文档?我完全不知道要使用的网址,希望能得到一些帮助。
解决方案
解决。加载招摇 UI 的正确 url 是http://localhost:8000/api/documentation
我希望它可以为其他人节省一些高质量的开发时间。
推荐阅读
- java - 使用 AppCompatCheckedTextView 在 AlertDialog 中设置可绘制对象
- android - 如何在我的 opengl 场景中添加灯光以显示阴影
- c++ - 寻找 Xcode 编译监视器
- javascript - php 或 Node js 不支持 Axios
- azure - 无法将 Azure VM 迁移到托管磁盘
- filter - Java8 Stream.filter 不适用于延迟加载数据
- java - 对 Java 中的文件执行签名和验证操作时出错
- kotlin - kotlin - 当覆盖中具有相同的方法名称时如何引用委托?
- c# - 使用 linq 更新对象的属性,但更新后的方法计算不正确
- node.js - readFileSync 返回未定义