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

这里脚本会询问我们是否是选择服务器范围,还是本地拷贝,我们选择系统。默认就是选择系统,直接回车。

windows下安装Pear和PhpDocumentor(phpdoc)笔记_第1张图片

4、这里会列出pear路径配置,询问我们是否修改。回车接受,开始安装pear库。

windows下安装Pear和PhpDocumentor(phpdoc)笔记_第2张图片

5、安装过程中,会提示我们修改php.ihi设置inclue_path,输入“y"回车继续安装。

注意:这里安装脚本设置的是自动修改php.ini设置include_path,就我观察,输入“Y”回车,php.ini并没有修改成功,这里为了保险,我们可以自己人肉确认一遍include_path是否设置正确。

windows下安装Pear和PhpDocumentor(phpdoc)笔记_第3张图片

6、安装完成,提示我们导入pear环境变量注册表文件:E:\wamp\bin\php\php5.2.11\PEAR_ENV.reg,我们找到该文件,双击导入注册表。回车结束安装。该文件起设置pear环境变量的作用。

windows下安装Pear和PhpDocumentor(phpdoc)笔记_第4张图片

7、输入pear,确认pear是否成功安装,如果出现以下界面,就表示pear已经安装成功。windows下安装Pear和PhpDocumentor(phpdoc)笔记_第5张图片

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,得到下图所示,就表示安装成功了。 

windows下安装Pear和PhpDocumentor(phpdoc)笔记_第6张图片

你可能感兴趣的:(document)