辞职了有些空余时间，做了一个自动 PHP 自动生成 swagger 文档工具，零代码入侵。

看一些自动生成 swagger 文档的工具，都是要在注释写一些特定的语法，本人有洁癖很难接受写一大坨奇怪语法的东西在注释里边，干脆就撸了一个自动生成 swagger 文档的工具，基于 php-parser语法树构建文档结构。

生成文档样例

文档详情：

https://github.com/eclogue/knight/tree/master/docs

github 项目

写得有些糙，目前 manjusaka 只针对courser 自动生成文档。manjusaka 会把大的 swagger 文档拆成若干个小的部分， 手动写过 swagger 文档的人应该知道一旦 api 接口过百，如果是单一个 yaml 文件大几千行，看一下就头疼更别说让人改。

小弟不才如果做得不对，欢迎大神斧正或者贡献代码。

因为是零入侵，所以不可能做的完美，有些地方还需要自己手动改，但已经节省了很大工作（准确的说需要定义 200 response 数据结构和 tag，security ）。

入口文件:

--- swagger: '2.0' ################################################################################ # API Information # ################################################################################ info: version: v0.1.1 title: knight API description: | 这是 knight 自动生成 API，仅限供参考。api 采用 rest 风格，正常情况下 response statusCode 20x 为成功的返回， 40x 为客户端错误， 50x 为服务端错误， 20x 返回 格式为 { message: 'OK', data: ... } 非 20x 返回 { message: '错误描述', code: '详细请看 api 错误码'} ################################################################################ # Host, Base Path, Schemes and Content Types # ################################################################################ host: localhost basePath: / schemes: - http produces: - application/json consumes: - application/json - multipart/form-data tags: - name: Auth description: 认证 - name: Users description: 用户 paths: $ref: ./routers/index.yaml definitions: $ref: ./definitions/index.yaml