phpdocumentor 安装以及使用说明

一  缘由       

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

二  安装

    安装的环境是win10+xampp，

    1      php.exe的路径是：C:\xampp\php；首先就是查看自己的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 lin