dedoc/scramble

Laravel应用程序的API文档自动生成。

资助包维护!
romalytvynenko

安装次数: 841,452

依赖者: 14

建议者: 0

安全: 0

星标: 1,163

关注者: 14

分支: 111

开放问题: 29


README

Scramble – Laravel API documentation generator

Scramble

Scramble可以生成Laravel项目的API文档。无需手动编写PHPDoc注释。文档以OpenAPI 3.1.0格式生成。

警告 包处于早期阶段。这意味着可能存在错误,API很可能会更改。如果您发现错误,请创建一个问题。欢迎提出建议。

文档

您可以在scramble.dedoc.co找到完整文档。

简介

该项目的主要宗旨是不需要您注释代码即可生成API文档。

这使您能够专注于代码,避免注释每个可能的参数/字段,因为这可能会导致文档过时。通过从代码自动生成文档,您的API将始终拥有最新且可靠的文档。

安装

您可以通过composer安装此包

composer require dedoc/scramble

使用

安装后,您将在应用程序中添加2个路由

  • /docs/api - 文档的UI查看器
  • /docs/api.json - 以JSON格式描述您的API的Open API文档。

默认情况下,这些路由仅在local环境中可用。您可以通过定义viewApiDocs网关来更改此行为。

Donate