php - 格式化类的 Swagger 输出

Question

与虚拟类一起使用时，有没有办法以更好的方式格式化 Swagger 输出？例如：

@return Account

由于缺少新行，输出对我来说有点混乱：

Answer 1

它是由 swagger-ui 在运行时创建的，我们肯定会随着时间的推移对其进行改进。我们可能会将其替换为格式化 json 的模型表示。

现在您可以删除@return 注释并直接在长描述下添加您想要的html（以您想要的方式放置响应信息），它将以相同的方式显示

为此，您可以复制粘贴您在资源管理器上获得的相同 html

此外，您不必对所有 api 方法都这样做，只对那些有很多字段并且看起来很乱的方法