windows下安装Pear和PhpDocumentor(phpdoc)笔记

 

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://www.phpdoc.org/ 

手册文档：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”的压缩包

长宽或光纤网络安装毫无压力

下载路径：http://sourceforge.net/projects/phpdocu/files/PhpDoc/phpDocumentor-1.4.3/PhpDocumentor-1.4.3.tgz/download

这里出现了一个小插曲，明明是.tgz的，下载到本地就是.gz的。无奈只好手动改名文件为.tgz后缀。拷贝至php.exe同级目录下。折腾尝试了半天算是弄明白了这么本地安装。

pear help

得到pear命令帮助

pear help install

得到install帮助

言归正传，输入：

pear install PhpDocumentor-1.4.3.tgz

提示安装成功

10、输入 phpdoc -h，得到下图所示，就表示安装成功了。