harlekoy / apidocs
Swagger 的替代品。为 Laravel 构建
v0.8.0
2019-09-05 04:49 UTC
Requires
- illuminate/support: ~6
- laravel/framework: 5.7.*|5.8.*|6.0.*
- webpatser/laravel-uuid: ^3.0
Requires (Dev)
- mockery/mockery: ^1.1
- orchestra/testbench: ~3.0
- phpunit/phpunit: ~7.0
- sempro/phpunit-pretty-print: ^1.0
- dev-master
- v0.8.0
- v0.7.6
- v0.7.5
- v0.7.4
- v0.7.3
- v0.7.2
- v0.7.1
- v0.7
- v0.6
- v0.5
- v0.4.2
- v0.4.1
- v0.4
- v0.3.2
- v0.3.1
- v0.3
- v0.2
- v0.1
- dev-dependabot/npm_and_yarn/frontend/express-4.18.2
- dev-dependabot/npm_and_yarn/frontend/decode-uri-component-0.2.2
- dev-dependabot/npm_and_yarn/frontend/css-what-2.1.3
- dev-dependabot/npm_and_yarn/frontend/shell-quote-1.7.3
- dev-dependabot/npm_and_yarn/frontend/eventsource-1.1.1
- dev-dependabot/npm_and_yarn/frontend/url-parse-1.5.10
- dev-dependabot/npm_and_yarn/frontend/follow-redirects-1.14.8
- dev-dependabot/npm_and_yarn/frontend/node-sass-7.0.0
- dev-dependabot/npm_and_yarn/frontend/path-parse-1.0.7
- dev-dependabot/npm_and_yarn/frontend/ws-6.2.2
- dev-dependabot/npm_and_yarn/frontend/dns-packet-1.3.4
- dev-dependabot/npm_and_yarn/frontend/hosted-git-info-2.8.9
- dev-dependabot/npm_and_yarn/frontend/lodash-4.17.21
- dev-dependabot/npm_and_yarn/frontend/y18n-3.2.2
- dev-dependabot/npm_and_yarn/frontend/elliptic-6.5.4
- dev-dependabot/npm_and_yarn/frontend/axios-0.21.1
- dev-dependabot/npm_and_yarn/frontend/http-proxy-1.18.1
- dev-dependabot/npm_and_yarn/frontend/websocket-extensions-0.1.4
- dev-dependabot/npm_and_yarn/frontend/acorn-5.7.4
- dev-dependabot/npm_and_yarn/frontend/lodash.template-4.5.0
- dev-dependabot/npm_and_yarn/frontend/fstream-1.0.12
- dev-dependabot/npm_and_yarn/frontend/js-yaml-3.13.1
- dev-dependabot/npm_and_yarn/frontend/lodash.defaultsdeep-4.6.1
- dev-dependabot/npm_and_yarn/frontend/mixin-deep-1.3.2
- dev-dependabot/npm_and_yarn/frontend/tar-2.2.2
- dev-dependabot/npm_and_yarn/frontend/lodash.mergewith-4.6.2
This package is auto-updated.
Last update: 2024-09-09 12:14:47 UTC
README
这里应该是你的描述。查看 contributing.md 以获取待办事项清单。
要求
- Laravel 5.5 及以上版本
安装
通过 Composer
$ composer require harlekoy/apidocs
安装 API Docs 后,使用 apidocs:install
Artisan 命令发布其资产和迁移文件。
$ php artisan apidocs:install
更新 API Docs
更新时,应重新发布 API Docs 的资产
$ php artisan apidocs:publish
重新读取 API 路由
更新您的 API 文档路由列表时,您应运行此命令以获取最新的 Laravel route:list
$ php artisan apidocs:routes
用法
在浏览器中访问您的 API 文档
/apidocs/list
如果您在您的计算机上没有运行任何本地服务器,请在命令行工具中首先运行此命令
php artisan serve
,然后它会生成此http://127.0.0.1:8000
。现在您可以使用该主机名访问路径http://127.0.0.1:8000/apidocs/list
,享受使用它吧 😄。
变更日志
请参阅 changelog 了解最近更改的详细信息。
测试
$ composer test
贡献
请参阅 contributing.md 了解详细信息及待办事项清单。
安全
如果您发现任何安全相关的问题,请通过电子邮件 me@harlekoy.com 而不是使用问题跟踪器。
鸣谢
路线图
Laravel API Docs 仍在开发中,我决定在这个早期阶段发布它,以便您可以帮助我使其更好。然而,您可以在生产环境中使用它。让我们完成下面的任务,以便我们可以有一个带有所需功能的正确功能的版本 1 运行起来。
以下是即将到来的计划
- 添加 API Docs 自定义路径支持
- 为组和端点手风琴添加过渡效果
- 在 Web 界面中添加编辑 API Docs 组和端点的方法
- 添加测试。
- 添加对必需参数的验证
许可
许可。请参阅 许可文件 了解更多详细信息。