Scribe可以帮助您自动生成文档，但是如果您真的想制作友好，可维护和可测试的API文档，则还需要了解更多信息。所以我为你做了一门课程。🤗
Zolotov Alexander
867f63b83c
tests fix
|
%!s(int64=6) %!d(string=hai) anos | |
|---|---|---|
| config | %!s(int64=6) %!d(string=hai) anos | |
| docs | %!s(int64=6) %!d(string=hai) anos | |
| resources | %!s(int64=6) %!d(string=hai) anos | |
| src | %!s(int64=6) %!d(string=hai) anos | |
| tests | %!s(int64=6) %!d(string=hai) anos | |
| .editorconfig | %!s(int64=9) %!d(string=hai) anos | |
| .gitattributes | %!s(int64=6) %!d(string=hai) anos | |
| .gitignore | %!s(int64=6) %!d(string=hai) anos | |
| .styleci.yml | %!s(int64=6) %!d(string=hai) anos | |
| .travis.yml | %!s(int64=6) %!d(string=hai) anos | |
| CHANGELOG.md | %!s(int64=6) %!d(string=hai) anos | |
| CONTRIBUTING.md | %!s(int64=6) %!d(string=hai) anos | |
| LICENSE.md | %!s(int64=9) %!d(string=hai) anos | |
| README.md | %!s(int64=6) %!d(string=hai) anos | |
| TODO.md | %!s(int64=6) %!d(string=hai) anos | |
| body_params.png | %!s(int64=6) %!d(string=hai) anos | |
| composer.json | %!s(int64=6) %!d(string=hai) anos | |
| phpunit.xml | %!s(int64=6) %!d(string=hai) anos |
README.md
Laravel API Documentation Generator
Automatically generate your API documentation from your existing Laravel/Lumen/Dingo routes. Here's what the output looks like.
php artisan apidoc:generate
Installation
PHP 7 and Laravel 5.5 or higher are required.
composer require mpociot/laravel-apidoc-generator
Laravel
Publish the config file by running:
php artisan vendor:publish --provider="Mpociot\ApiDoc\ApiDocGeneratorServiceProvider" --tag=apidoc-config
This will create an apidoc.php file in your config folder.
Lumen
- Register the service provider in your
bootstrap/app.php:
$app->register(\Mpociot\ApiDoc\ApiDocGeneratorServiceProvider::class);
- Copy the config file from
vendor/mpociot/laravel-apidoc-generator/config/apidoc.phpto your project asconfig/apidoc.php. Then add to yourbootstrap/app.php:
$app->configure('apidoc');
Documentation
Check out the documentation at ReadTheDocs.
License
The Laravel API Documentation Generator is free software licensed under the MIT license.