hahadu / laravel-apidoc-generator
Generate beautiful API documentation from your Laravel application
v0.3.1
2023-03-20 07:10 UTC
Requires
- php: >=7.2.0
- ext-json: *
- fakerphp/faker: ^1.9
- hahadu/documentarian: ^0.2
- hahadu/postman-api: ^0.1
- hahadu/reflector: ^1.0
- league/flysystem: ^1.0
- nunomaduro/collision: ^5.0
- ramsey/uuid: ^3.8|^4.0
- symfony/var-exporter: ^4.0|^5.0
Requires (Dev)
- dms/phpunit-arraysubset-asserts: ^0.3
- laravel/lumen-framework: ^5.7|^6.0|^7.0|^8.0|^9.0
- league/fractal: ^0.19.0
- orchestra/testbench: ^3.7|^4.0|^5.0
- phpstan/phpstan: ^0.11.15
- phpunit/phpunit: ^8.0
Suggests
- league/fractal: Required for transformers support
README
Automatically generate your API documentation from your existing Laravel/Lumen/Dingo routes.
Installation
PHP 7.2 and Laravel/Lumen 8.1 or higher are required.
If your application does not meet these requirements, you can check out the 3.x branch for older releases.
composer require hahadu/laravel-apidoc-generator
and
composer dump or composer update
Laravel
Publish the config file by running:
php artisan vendor:publish --provider="Hahadu\ApiDoc\ApiDocGeneratorServiceProvider" --tag=apidoc-config
This will create an apidoc.php
file in your config
folder.
Lumen
- When using Lumen, you will need to run
composer require mpociot/laravel-apidoc-generator
instead. - Register the service provider in your
bootstrap/app.php
:
$app->register(\Hahadu\ApiDoc\ApiDocGeneratorServiceProvider::class);
- Copy the config file from
vendor/mpociot/laravel-apidoc-generator/config/apidoc.php
to your project asconfig/apidoc.php
. Then add to yourbootstrap/app.php
:
$app->configure('apidoc');
Documentation
php artisan apidoc:generate
Check out the documentation at the Beyond Code homepage.
License
The Laravel API Documentation Generator is free software licensed under the MIT license.