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

Shalvah f3e2c47441 Update TestModel.php %!s(int64=5) %!d(string=hai) anos
config bb3d511133 Fix synax for 7.2 support %!s(int64=5) %!d(string=hai) anos
docs 6b5d72b3fd Update migrating.md %!s(int64=5) %!d(string=hai) anos
resources b252f8bf7c Change auth badge to lowercase, fix lint %!s(int64=5) %!d(string=hai) anos
routes 277f3d1080 Rename project to Scribe %!s(int64=5) %!d(string=hai) anos
src dcf8c06828 fixed linter errors %!s(int64=5) %!d(string=hai) anos
tests f3e2c47441 Update TestModel.php %!s(int64=5) %!d(string=hai) anos
.editorconfig 24d3f6aa22 Add some dotfiles %!s(int64=9) %!d(string=hai) anos
.gitattributes 6e60d14ea2 Make bodyParam parsing more rbust %!s(int64=6) %!d(string=hai) anos
.gitignore 277f3d1080 Rename project to Scribe %!s(int64=5) %!d(string=hai) anos
.styleci.yml 385fbc7ba0 Fix style %!s(int64=5) %!d(string=hai) anos
.travis.yml d6100fcf5f Switch to clara for logging %!s(int64=5) %!d(string=hai) anos
CHANGELOG.md 221018765b Fix tests %!s(int64=5) %!d(string=hai) anos
CONTRIBUTING.md 4c87b21d29 Update CONTRIBUTING.md %!s(int64=6) %!d(string=hai) anos
LICENSE.md 0e25996b83 Initial commit %!s(int64=9) %!d(string=hai) anos
README.md 967e528531 Update README.md %!s(int64=5) %!d(string=hai) anos
body_params_1.png b7aad444e3 Update docs on urlParams %!s(int64=5) %!d(string=hai) anos
body_params_2.png b7aad444e3 Update docs on urlParams %!s(int64=5) %!d(string=hai) anos
composer.dingo.json 286c39bf16 Fix tests %!s(int64=5) %!d(string=hai) anos
composer.json 3e99d5b74f Update deps %!s(int64=5) %!d(string=hai) anos
phpstan.neon f7407a5105 Fix lint, little fixes %!s(int64=5) %!d(string=hai) anos
phpunit.xml b804f02e7c Add support for multiple scenario descriptions in @response tag %!s(int64=5) %!d(string=hai) anos
todo.md 38f422773c Update docs %!s(int64=5) %!d(string=hai) anos

README.md

Scribe ✍

Generate API documentation for humans from your Laravel codebase. Here's what the output looks like.

Latest Stable Version Total Downloads Build Status

Installation

PHP 7.2.5 and Laravel/Lumen 5.8 or higher are required.

composer require --dev knuckleswtf/scribe

Laravel

Publish the config file by running:

php artisan vendor:publish --provider="Knuckles\Scribe\ScribeServiceProvider" --tag=scribe-config

This will create a scribe.php file in your config folder.

Lumen

  • When using Lumen, you will need to run composer require knuckleswtf/scribe instead.
  • Register the service provider in your bootstrap/app.php:
$app->register(\Knuckles\Scribe\ScribeServiceProvider::class);
  • Copy the config file from vendor/knuckleswtf/scribe/config/scribe.php to your project as config/scribe.php. Then add to your bootstrap/app.php:
$app->configure('scribe');

Documentation

Check out the documentation at ReadTheDocs. Don't forget to check out the migration guide if you're coming from mpociot/laravel-apidoc-generator.