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

Shalvah 55c09c306e Merge pull request #57 from knuckleswtf/complete-notransaction-handling 5 năm trước cách đây
.github 16e689019c Update bug_report.md 5 năm trước cách đây
config fc7161a08e Update docs for continue_without_database_transactions 5 năm trước cách đây
docs fc7161a08e Update docs for continue_without_database_transactions 5 năm trước cách đây
resources d442641b4b Fix bug with fetching pagination type for API Resources 5 năm trước cách đây
routes 0d3df3ac45 Refactor Laravel type to use /docs for routing by default, rather than /doc. 5 năm trước cách đây
src fc7161a08e Update docs for continue_without_database_transactions 5 năm trước cách đây
tests db1e559e22 Merge pull request #43 from chriserikhaugli/#40-Include-raw-in-requests.url 5 năm trước cách đây
.editorconfig 24d3f6aa22 Add some dotfiles 9 năm trước cách đây
.gitattributes 6e60d14ea2 Make bodyParam parsing more rbust 6 năm trước cách đây
.gitignore a81b4a86b9 Refactor tests 5 năm trước cách đây
.styleci.yml 385fbc7ba0 Fix style 5 năm trước cách đây
.travis.yml 9da8c80421 Fix lint 5 năm trước cách đây
CHANGELOG.0-1.md 627ba652e9 Update changelog 5 năm trước cách đây
CHANGELOG.md 5de8a5d05c Update CHANGELOG.md 5 năm trước cách đây
CONTRIBUTING.md 6457ea46f4 Add contribution guide 5 năm trước cách đây
LICENSE.md 0e25996b83 Initial commit 9 năm trước cách đây
README.md c668f3e9f9 Update README 5 năm trước cách đây
composer.dingo.json 6721694c27 Update deps 5 năm trước cách đây
composer.json 6721694c27 Update deps 5 năm trước cách đây
logo-scribe.png 908fd36b04 Update doc 5 năm trước cách đây
phpstan.neon d854a593c1 Extend no overwrite feature to all standard markdown files, not just routes. 5 năm trước cách đây
phpunit.xml a81b4a86b9 Refactor tests 5 năm trước cách đây
todo.md 6b32e2880f Add file upload support to Python example requests 5 năm trước cách đây

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

Documentation

Scribe is a fork of mpociot/laravel-apidoc-generator, so see the migration guide if you're coming from there.

Check out the documentation at ReadTheDocs.

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 (no --dev.
  • 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');

Contributing

Contributing is easy! See our contribution guide.