一 缘由
最近改版公司网站和app端的api，发现很多函数和方法都没写注释，搞得每次调用之前还需要看底层实现，有的方法名和功能还类似，区分不出使用哪个最优！为了避免给后人挖坑，除了将代码写得规范外，还想自动生成api文档，方便后来人！于是就研究上了phpdocumentor。今天说下它的安装以及使用。首先需要声明的是，网站的教程很多，但问题在于，按照网上的一些教程来，坑爹，老失败。于是干脆自己动手写一篇，记录下自己的经历。
二 安装
安装的环境是win10+xampp，
1 php.exe的路径是：C:xamppphp；首先就是查看自己的php.exe目录下有无pear这个文件，好吧，我这个是没有的。那么， 将https://pear.php.net/go-pear.phar另存为go-pear.phar文件，并保存到php.exe所在路径中
2 第二步很重要，很多文章中都是说，直接进入到php的安装目录，执行命令 php go-pear.phar
问题就出在这里：报错，提示 ：
PHP Warning: mkdir(): File exists in phar://C:/xampp/php/go-pear.phar/System.php on line 294
Warning: mkdir(): File exists in phar://C:/xampp/php/go-pear.phar/System.php on line 294
PHP Warning: mkdir(): No such file or directory in phar://C:/xampp/php/go-pear.phar/System.php on line 294
Warning: mkdir(): No such file or directory in phar://C:/xampp/php/go-pear.phar/System.php on line 294
Unable to create Temporary directory for processing C:xamppphpphpdoc mp.
Run this script as administrator or pick another location.
C:xamppphp>PHP Warning: mkdir(): File exists in phar://C:/xampp/php/go-pear.phar/System.php on line 294
Could not open input file: Warning:
如图所示：
找了好久，终于找到原因了：权限不够导致的！！！需要以管理员的权限进入到dos下，我直接在C:WindowsSystem32目录下，以管理员的方式进入dos中：
然后切换到刚才的目录下，执行 php go-pear.phar， 按回车默认system然后继续。后面操作均为默认。最后成功安装，查看php.exe同目录就可以看到pear这个文件了：
安装成功后，再来执行pear install phpdocumentor即可。
三 使用phpdocumentor
输入phpdoc -h 会有如下提示：
一般，用得多的几个参数解释如下：
-f 要进行分析的文件名，多个文件用逗号隔开
-d 要分析的目录，多个目录用逗号分割
-t 生成的文档的存放路径
-o 输出的文档格式，结构为输出格式：转换器名：模板目录。
例如，我这边生成doc的命令是：
phpdoc -d "C:wwwweb" -t "C:wwwwebdoc"
然后在对应的目录下去查看生成的文档即可！