README

此分支使用Swagger-spec 2.0和Swagger-php 2.0。此分支还将Swagger-ui更新到版本2.1.1。

OAuth2

Swagger-ui已被修改，允许直接在ui中插入OAuth 2参数（client_id、client_secret、realm和appName）。您也可以在URL中传递这些值，如下所示：http://api.appcursos.com/api-docs?client_id=my-client-id&client_secret=my-client-secret&realm=my-realm&appName=my-app-name

要为Laravel 4.2使用Swaggervel，请使用1.0分支（https://github.com/slampenny/Swaggervel/tree/1.0）

Swaggervel

Swagger for Laravel

此包将Swagger-php和swagger-ui整合到一个Laravel友好的包中。

当您以调试模式运行应用程序时，Swaggervel将扫描您的应用程序文件夹（或在配置包中的"app-dir"变量下设置的任何文件夹），生成swagger json文件，并将它们存放到doc-dir文件夹中（默认为/docs）。然后，swagger-ui在api-docs目录下提供这些文件。

安装

• 将Jlapp\Swaggervel\SwaggervelServiceProvider添加到您的app/config/app.php文件中的提供者数组中，在路由提供者之上，以避免任何捕获所有路由
• 运行php artisan vendor:publish将swagger-ui推送到您的公开文件夹。

示例

• www.example.com/docs <- Swagger JSON文件可见
• www.example.com/api-docs <- Swagger ui可见。

选项

在配置文件中取消注释"viewHeaders"选项，以向您的视图添加标题。

如何使用Swagger-php

实际的Swagger规范超出了此包的范围。Swaggervel所做的只是以Laravel友好的方式打包swagger-php和swagger-ui，并试图使其易于提供。有关如何使用swagger-php的信息，请查看这里。有关swagger-php的精彩示例，请查看这里。

对于Laravel 5，请使用2.0分支！

对于Laravel 4，请使用1.0分支！

Swaggervel

Swagger for Laravel

此包将Swagger-php和swagger-ui整合到一个Laravel友好的包中。

当您以调试模式运行应用程序时，Swaggervel将扫描您的应用程序文件夹（或在配置包中的"app-dir"变量下设置的任何文件夹），生成swagger json文件，并将它们存放到doc-dir文件夹中（默认为/docs）。然后，swagger-ui在api-docs目录下提供这些文件。

安装

• 将Jlapp\Swaggervel\SwaggervelServiceProvider添加到您的app/config/app.php文件中的提供者数组中，在路由提供者之上（以避免捕获所有路由）
• 运行php artisan vendor:publish将配置文件推送到您的应用程序文件夹。

示例

• www.example.com/docs <- Swagger JSON文件可见
• www.example.com/api-docs <- Swagger ui可见。

选项

在配置文件中取消注释"viewHeaders"选项，以向您的视图添加标题。

如何使用Swagger-php

实际的Swagger规范超出了此包的范围。Swaggervel所做的只是以Laravel友好的方式打包swagger-php和swagger-ui，并试图使其易于提供。有关如何使用swagger-php的信息，请查看这里。有关swagger-php的精彩示例，请查看这里。