Download the PHP package luttamustache/op-laravel-swagger without Composer
On this page you can find all versions of the php package luttamustache/op-laravel-swagger. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download luttamustache/op-laravel-swagger
More information about luttamustache/op-laravel-swagger
Files in luttamustache/op-laravel-swagger
Package op-laravel-swagger
Short Description Provided middleware for generating of swagger-documentation file by run testing of RESTful API.
License MIT
Informations about the package op-laravel-swagger
Laravel OP AutoDoc plugin
This plugin is fork made from RonasIT/laravel-swagger to support old versions of PHP (<=7.2).
Instalation
Composer
composer require luttamustache/op-laravel-swagger
Laravel
- Add LuttaMustache\Support\AutoDoc\AutoDocServiceProvider::class to providers in config/app.php
- Add \RonasIT\Support\DataCollectors\LocalDataCollectorServiceProvider::class to providers in config/app.php
php artisan vendor:publish
Plugin
- Add middleware \LuttaMustache\Support\AutoDoc\Http\Middleware\AutoDocMiddleware::class to Http/Kernel.php.
- Set \LuttaMustache\Support\AutoDoc\Tests\AutoDocTestCase as parent of your TestCase in tests/TestCase.php
- In config/auto-doc.php you can specify enabling of plugin, info of your project, some defaults descriptions and route for rendering of documentation.
- In .env file you should add following lines
LOCAL_DATA_COLLECTOR_PROD_PATH=/example-folder/documentation.json LOCAL_DATA_COLLECTOR_TEMP_PATH=/tmp/documentation.json
Usages
~~For correct working of plugin you have to dispose all the validation rules in the rules() method of class YourRequest, which must be connected to the controller via DependencyInjection. In annotation of custom request you can specify summary and description of this request. Plugin will take validation rules from your request and use it as description of input parameter.~~
The plugin will automatically generate Swagger 2.0 documentation after you run phpunit.
Every phpunit execution rewrites the documentation file fully. That means, if you want to maintain documentation full, you need to run phpunit on every test you have.
Example
- @summary - short description of request
- @description - Implementation Notes
-
@_204 - Custom description of code of response. You can specify any code as you want.
If you do not create a class Request, the summary, Implementation Notes and parameters will be empty. Plugin will collect codes and examples of responses only.
If you do not create annotations to request summary will generate automatically from Name of Request. For example request UpdateUserDataRequest will have summary Update user data request.
If you do not create annotations for descriptions of codes it will be generated automatically the following priorities:
- Annotations of request
- Default description from auto-doc.defaults.code-descriptions.{$code}
- Descriptions from Symfony\Component\HttpFoundation\Response::$statusTexts
Note about configs:
- auto-doc.route - it's a route where will be located generated documentation
- auto-doc.basePath - it's a route where located root of your api
Also you can specify way to collect documentation by creating your custom data collector class.
All versions of op-laravel-swagger with dependencies
laravel/framework Version 8.*
minime/annotations Version dev-master
nikic/php-parser Version 4.10.4