通过 
搜索
搜索onavascuez / swaggervel
将 Swagger 集成到 Laravel 的绝佳方式
v3.0.0
2021-11-08 21:56 UTC
Requires
- php: >=5.6.0
- swagger-api/swagger-ui: ^3.1
- zircote/swagger-php: ^2.0
README
本软件包将 Swagger-php 和 swagger-ui 集成到一个 Laravel 友好的软件包中。当你在调试模式下运行应用程序时，Swaggervel 将扫描您的应用程序文件夹（或任何在包配置中设置为 "app-dir" 变量的文件夹），生成 swagger json 文件，并将它们存放到 doc-dir 文件夹中（默认为 /docs）。然后由 swagger-ui 在 api-docs 目录下提供文件。
安装
- 在您的 Laravel 根目录下执行
composer require onavascuez/swaggervel --dev - 将
Onavascuez\Swaggervel\SwaggervelServiceProvider::class添加到app/config/app.php文件中的提供者数组中，在路由提供者之上，以避免任何全局路由 - 运行
php artisan vendor:publish --tag=public将 swagger-ui 推送到您的公共文件夹（可以在 public/vendor/swaggervel 中找到）。 - 可选地运行
php artisan vendor:publish --tag=config将 swaggervel 默认配置推送到应用程序的配置目录。 - 可选地运行
php artisan vendor:publish --tag=views将 swaggervel 索引视图文件推送到resources/views/vendor/swaggervel。
示例（当使用默认配置时）
- www.example.com/docs <- 您可能在那里找到自动生成的 Swagger .json 文件
- www.example.com/api/docs <- 访问您的 Swagger UI
选项
所有选项都在 swaggervel.php 配置文件中有良好的注释。
如何使用 Swagger-php
实际的 Swagger 规范超出了本软件包的范围。Swaggervel 做的是以 Laravel 友好的方式打包 swagger-php 和 swagger-ui，并尝试使其易于提供。有关如何使用 swagger-php 的信息，请查看这里。有关 swagger-php 的良好示例，请查看这里。
其他注意事项
由于不再维护，本软件包是 appointer/swaggervel 的分支。
待办事项
- 处理 /doc 调用的处理仍然非常不一致，因为您不能更改文件名（api-docs.json），但是可以更改使用 /doc 路由时访问的文件。