一 缘由
最近改版公司网站和app端的api,发现很多函数和方法都没写注释,搞得每次调用之前还需要看底层实现,有的方法名和功能还类似,区分不出使用哪个最优!为了避免给后人挖坑,除了将代码写得规范外,还想自动生成api文档,方便后来人!于是就研究上了phpdocumentor。今天说下它的安装以及使用。首先需要声明的是,网站的教程很多,但问题在于,按照网上的一些教程来,坑爹,老失败。于是干脆自己动手写一篇,记录下自己的经历。 最近改版公司网站和app端的api,发现很多函数
最近改版公司网站和app端的api,发现很多函数和方法都没写注释,搞得每次调用之前还需要看底层实现,有的方法名和功能还类似,区分不出使用哪个最优!为了避免给后人挖坑,除了将代码写得规范外,还想自动生成api文档,方便后来人!于是就研究上了phpdocumentor。今天说下它的安装以及使用。首先需要声明的是,网站的教程很多,但问题在于,按照网上的一些教程来,坑爹,老失败。于是干脆自己动手写一篇,记录下自己的经历。 最近改版公司网站和app端的api,发现很多函数