phpsocialnetwork/insidion-swagger-acme-bundle

此包已被弃用且不再维护。未建议替代包。

Swagger Acme Bundle

dev-master 2018-02-25 10:46 UTC

This package is auto-updated.

Last update: 2024-02-05 18:15:06 UTC


README

⚠️ V2 目前处于开发中,尚未准备用于生产使用 ⚠️

你为什么需要这个包?

你需要它,因为它将 swagger.io 的强大功能集成到你的 Symfony 3 应用程序中。

如果你还没有听说过 Swagger,我们建议你看看它。它定义了你的 REST API 的服务合同。

为什么我应该为我的 Symfony REST API 定义服务合同?

  • 你不爱完美无瑕且文档齐全的工作吗?
  • 你不讨厌编写冗余的 PDF/Excel 来解释所有的 REST API 端点吗?
  • 你不希望边写代码边编写文档吗?

试试看,你不会失望的!

你的包提供了什么具体的功能?

它提供了一套内置的、美观的 Web 界面来执行提供的示例模型中的 REST 请求。

内置的 Web 界面允许你使用自定义的头部/参数/cookies 测试大多数 HTTP REST 方法(DELETE、PATCH 等)。

自己编写可能会变得繁琐,因此我们引入了这个包!

当前功能

  • 基于注解的 REST API 定义 - 使你的代码自动生成文档
  • 集成的 Swagger UI
    • 访问 <你的网站>/swagger/ 来使用它
    • 你可以通过查看 Resources/doc 文件夹来自定义路由
  • 使测试更容易。
  • 通过配置缓存,在启动时仅生成 swagger.json
    • 该包还支持用于处理缓存的自定义 Psr6 缓存服务
  • 生成的定义完全符合 Swagger 标准
  • 安全设置
  • 标签定义
  • 弃用突出显示
  • 路由和参数定义的摘要/描述
  • 为更好的合同规范定义模型

更多文档

我们不会让你在黑暗中摸索这个包是如何工作的。

你可以在 Resources/doc 文件夹中找到文档。

帮助/贡献

发现了问题? 请随意报告

有改进你体验的想法? 发送我们一个 pull request

有反馈吗?给我们发消息,非常欢迎!我们很乐意听到您的声音!

感谢您尝试使用我们💙