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
用浏览器打开: