php文档生成

phpDocumentor是用php语言写的一个非常强大的文档自动生成工具，利用它可以帮助我们编写规范的注释，生成易于理解，结构清晰的文档，对我们的代码升级，维护,移交等都有非常大的帮助

安装 pear

依赖pear安装：

首先是查看自己的php.exe同目录下是否存在pear这个文件,没有下载。

下载另存为go-pear.phar文件

这个文件放到php.exe所在的PHP安装目录下，我这里安装目录是D:\wamp64\ bin \php\php5.6.25\

用管理员权限运行cmd，注意选择local、按回车默认system然后继续

安装Phpdocumentor

pear list用来查看pear目录中是否存在phpdocumentor本地包

继续在dos的php目录，输入pear install -a phpdocumentor。（没有会自动下载）

此时会有以下文件:

输入phpdoc -h会有以下提示

用到最多的几个参数：

-f 要进行分析的文件名，多个文件用逗号隔开

-d 要分析的目录，多个目录用逗号分割

-t 生成的文档的存放路径

-o 输出的文档格式，结构为输出格式：转换器名：模板目录。

测试：

1.php的内容

phpdoc -o HTML:frames:earthli -f D:\wamp64\www\one\1.php -t docs

上述命令执行完成后：会在docs文件下的default中生成一个文件：haha.html

用浏览器打开：