weburnit / swaggeravel
此包允许您:使用 Swagger PHP 生成 RESTful API 文档。
1.0
2017-07-12 12:07 UTC
Requires
- php: >=5.3.0
- illuminate/console: 5.*
- illuminate/routing: 5.*
- illuminate/support: 5.*
- zircote/swagger-php: 2.*@dev
Requires (Dev)
- laravel/framework: 5.4.*
- laravel/lumen-framework: 5.*
- phpunit/phpunit: 5.*
This package is auto-updated.
Last update: 2024-08-29 04:31:24 UTC
README
此包是 Swagger-php 的包装,使其易于与 Lumen/Larvarel 集成。
用法
安装
通过 Composer
在您的 composer.json 中添加新包的信息
"repositories": [ { "type": "vcs", "url": "git@gitlab.lzd.co:operations/laraswagger.git", "name": "lazada/database-minifier" } ], "require": { "lazada/laraswagger": ">=1.0.0" }
Composer 安装完成后,注册服务提供者
- Lumen 应用程序
$app->register(Swagger\LaraSwagger\Providers\LumeSwaggerServiceProvider::class);
- Laravel 应用程序:目前不支持。
现在您可以与 LaraSwagger 一同摇滚了
-
运行
php artisan swagger:generate file_name [base_host]:以生成 Swagger API 文档。 -
转到
/swagger/api-docs(默认路由配置)以查看 JSON 格式的 Swagger API 文档
默认配置
<?php return [ 'routes' => [ 'prefix' => 'swagger' ], 'api' => [ 'directories' => [base_path('app')], 'excludes' => [], 'host' => null ] ];
自定义配置
为了更改默认配置,您可以将 config/lara-swagger.php 中的配置模板复制到您的应用程序的 config 目录中,并根据您的需要进行修改。有关更多信息,请参阅 Lumen 文档中的 配置文件 部分。
测试
./vendor/phpunit/phpunit/phpunit
在 ./build 中查看测试结果