PHP_DOC 实时生成 API 文档

随着API的迅速发展，如何编写出更加规范的API文档说明则显的尤其重要。

你是否还经过手写的方式来生成和编写这些文档呢？

那么你就OUT啦！

工欲善其事，必先利其器。

本文分享一款工具：PHP_DOC。

可在线实时查看API接口的参数、返回和说明，无须手动维护文档。

背景

你还在为维护 API文档 而烦恼吗？

维护 客户端 接口。

维护 Rpc 接口。

...

那么问题来了，

能不能根据代码进行生成API文档呢？

能不能生成高逼格的界面来进行展现呢？

能不能适合不一样框架的系统呢？

原理

首先用程序分析代码的注释，而后进行友好的展现。

实现

（1） 列出全部的API文件。
（2） 点击文件名，能够查看里面的接口。
（3） 点击接口名称，能够查看接口的注释。

效果图

图1

图2

图3

图4

PHP_DOC 实时生成 API 文档 GIF

若是你们须要下载源码，能够关注微信公众号，回复 “php_doc” 便可。

Thanks ~

---

推荐阅读

• 系统的讲解 - SSO 单点登陆
• 系统的讲解 - PHP WEB 安全防护
• 系统的讲解 - PHP 缓存技术
• 系统的讲解 - PHP 接口签名验证
• 系统的讲解 - PHP 浮点数高精度运算