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

shalvah ae6b2f8a9a Fix tests hace 5 años
config f7407a5105 Fix lint, little fixes hace 5 años
docs 6b5d72b3fd Update migrating.md hace 5 años
resources b252f8bf7c Change auth badge to lowercase, fix lint hace 5 años
routes 277f3d1080 Rename project to Scribe hace 5 años
src ae6b2f8a9a Fix tests hace 5 años
tests ae6b2f8a9a Fix tests hace 5 años
.editorconfig 24d3f6aa22 Add some dotfiles hace 9 años
.gitattributes 6e60d14ea2 Make bodyParam parsing more rbust hace 6 años
.gitignore 277f3d1080 Rename project to Scribe hace 5 años
.styleci.yml 385fbc7ba0 Fix style hace 5 años
.travis.yml d6100fcf5f Switch to clara for logging hace 5 años
CHANGELOG.md 221018765b Fix tests hace 5 años
CONTRIBUTING.md 4c87b21d29 Update CONTRIBUTING.md hace 6 años
LICENSE.md 0e25996b83 Initial commit hace 9 años
README.md 2b9f1f3b04 Update docs hace 5 años
body_params_1.png b7aad444e3 Update docs on urlParams hace 5 años
body_params_2.png b7aad444e3 Update docs on urlParams hace 5 años
composer.dingo.json ae6b2f8a9a Fix tests hace 5 años
composer.json ae6b2f8a9a Fix tests hace 5 años
phpstan.neon f7407a5105 Fix lint, little fixes hace 5 años
phpunit.xml b804f02e7c Add support for multiple scenario descriptions in @response tag hace 5 años
todo.md 38f422773c Update docs hace 5 años

README.md

Scribe ✍

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

Latest Stable VersionTotal Downloads Build Status Total Downloads

Installation

PHP 7.2 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.