PhpDocumentor简介
PHPDocumentor是一个用PHP写的工具,对于有规范注释的php程序,它能够快速生成具有相互参照,索引等功能的API文档。老的版本是phpdoc,从1.3.0开始,更名为phpDocumentor,新的版本加上了对php5语法的支持,同时,可以通过在客户端浏览器上操作生成文档,文档可以转换为PDF,HTML,CHM几种形式,非常的方便。
参考介绍:
百度百科:http://baike.baidu.com/view/1269751.htm
维基百科:http://en.wikipedia.org/wiki/Phpdoc http://en.wikipedia.org/wiki/PhpDocumentor
手册文档:http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_phpDocumentor.pkg.html
本机环境介绍:
wamp集成环境,php版本5.2.11
安装目录:E:\wamp\bin\php\php5.2.11
php.exe和php.ini.所在目录:E:\wamp\bin\php\php5.2.11
1、确认wamp环境能正常运行。
2、开始 -> 运行 -> 输入cmd回车,切换到php.exe所在目录
3、输入 go-pear.bat
这里脚本会询问我们是否是选择服务器范围,还是本地拷贝,我们选择系统。默认就是选择系统,直接回车。
4、这里会列出pear路径配置,询问我们是否修改。回车接受,开始安装pear库。
5、安装过程中,会提示我们修改php.ihi设置inclue_path,输入“y"回车继续安装。
注意:这里安装脚本设置的是自动修改php.ini设置include_path,就我观察,输入“Y”回车,php.ini并没有修改成功,这里为了保险,我们可以自己人肉确认一遍include_path是否设置正确。
6、安装完成,提示我们导入pear环境变量注册表文件:E:\wamp\bin\php\php5.2.11\PEAR_ENV.reg,我们找到该文件,双击导入注册表。回车结束安装。该文件起设置pear环境变量的作用。
7、输入pear,确认pear是否成功安装,如果出现以下界面,就表示pear已经安装成功。
8、安装PhpDocumentor前的一些准备,升级pear,可能我们安装的pear版本会有点老,故这里要升级pear。
输入:
pear upgrade pear
等升级完成,安装PhpDocumentor依赖包。
输入:
pear install XML_Parser
pear install XML_Beautifier
9、安装PhpDocumentor
输入:
pear install PhpDocumentor
注意:这里由于网络原因,下载安装很可能会失败,或者等很长时间后安装失败,可以直接上官网下载压缩包,回来安装。记得是下后缀名是“tgz”的压缩包
长宽或光纤网络安装毫无压力
这里出现了一个小插曲,明明是.tgz的,下载到本地就是.gz的。无奈只好手动改名文件为.tgz后缀。拷贝至php.exe同级目录下。折腾尝试了半天算是弄明白了这么本地安装。
pear help
得到pear命令帮助
pear help install
得到install帮助
言归正传,输入:
pear install PhpDocumentor-1.4.3.tgz
提示安装成功
10、输入 phpdoc -h,得到下图所示,就表示安装成功了。