Scribe可以帮助您自动生成文档,但是如果您真的想制作友好,可维护和可测试的API文档,则还需要了解更多信息。所以我为你做了一门课程。🤗

Zolotov Alexander 867f63b83c tests fix před 6 roky
config d2901e51a6 Re-add faker seed + tests před 6 roky
docs b9646362d7 Update docs to reflect support for route URLs in include/exclude před 6 roky
resources 793f15ace8 Fix tests před 6 roky
src 66d8fa8c8c tests fix před 6 roky
tests 867f63b83c tests fix před 6 roky
.editorconfig 24d3f6aa22 Add some dotfiles před 9 roky
.gitattributes 6e60d14ea2 Make bodyParam parsing more rbust před 6 roky
.gitignore 8ebae10774 Add Sphinx doc před 6 roky
.styleci.yml f0dc118c6b Fix StyleCI 7.0 error; fix route url bindings před 6 roky
.travis.yml 428c0f27ce Fix Travis build config před 6 roky
CHANGELOG.md ca26f0053c Update changelog před 6 roky
CONTRIBUTING.md 4c87b21d29 Update CONTRIBUTING.md před 6 roky
LICENSE.md 0e25996b83 Initial commit před 9 roky
README.md c1c2349060 Update README.md před 6 roky
TODO.md d2901e51a6 Re-add faker seed + tests před 6 roky
body_params.png b8ad92b9e5 Add authenticated annotation and badge support (closes #345) před 6 roky
composer.json cccfa3b20e Add support for Laravel 5.8 před 6 roky
phpunit.xml 8358c93058 Update test config to continue on failure před 6 roky

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

Latest Stable VersionTotal Downloads License codecov.io Scrutinizer Code Quality Build Status StyleCI

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.php to your project as config/apidoc.php. Then add to your bootstrap/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.