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

安装pear

依赖pear安装：

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

http://pear.php.net/go-pear.phar下载另存为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

用阅读器打开：