PHPdocument2 安装及使用教程

一 简介

       Phpdocument2 是我以前所介绍的phpdocument的最新版本，之所以介绍它是因为老版的phpdocument在我们服务器（php 5.3.8 ，我怀疑是缺少必要的扩展库导致不能用）上运行总是报一些奇葩的错误导致无法使用，而敝人又解决不了，所以干脆换最新版本咯。。。。。。

       Phpdocument2 在模板上做了很大改进，现在虽然只有一套模板（老版本的模板都不能用）但却很高端大气上档次，比老版本华丽很多。唯一的缺憾是只有控制台版本。

 

 

二 安装

       这里我采用pear方式安装

1，  如果你的电脑没有安装pear，先安装pear

1）  首先从pear官网下载最新版的go-pear.phar.

http://pear.php.net/go-pear.phar

2）  控制台下 cd 到php目录下（如：我的php在D:\xampp\php\ ）

3）  输入命令php  你go-pear.phar的存放路径/go-pear.phar

这有可能报错：Could not open input file: PEAR\go-pear.phar

这时改用命令：php -d phar.require_hash=0 你go-pear.phar的存放路径/go-pear.phar ( 路径不要包含中文)

4）  余下的根据英文提示一步步来吧，就是改改路径，基本默认就可以了，这个不用细说了吧。

唯一需要注意的就是要输入 php.exe 的路径

（这个要是搞不定建议稍微怀疑一下自己的智商。。。）

 

2，  安装phpdocument2

1）安装好pear后应该就已经自动注册好环境变量了，要是没有也不要紧，要不就自己添加一下环境变量，要不就cd到 你pear的安装位置，如果使用的默认安装位置用该是C:\Documents and Settings\Administrator
2）输入pear 回车 先运行一下（我也不知道为什么要有这一步，但是如果不运行一我下面的命令 控制台就不认识）

这是因为pear.bat临时把phpdoc的位置加载到了环境变量里面

2）输入如下两条命令

pear channel-discover pear.phpdoc.org
pear install phpdoc/phpDocumentor-alpha
 

3）  漫长等待……………(主要看网速)………………….安装完成

4）可以看到在你的pear安装目录下多了一个phpdoc.bat 的文件，这证明你安装成功了

三 使用

1）要是没有添加环境变量就自己添加一下环境变量，要不先cd到 你phpdoc.bat的位置

2) 输入pear 回车 先运行一下（我也不知道为什么要有这一步，但是如果不运行一我下面的命令 控制台就不认识）

3）输入命令phpdoc  -d D:\test  -t D:\test2

           -d 要解析的文件夹

           -t 生成文件的文件夹

4）大功告成。。。。。

 

四 错误

      报错了！！！ 你用的是 xampp 吧 看一下 php版本 5.3.8 吧 呵呵

      你的错误是不是缺少扩展库php_xsl.dll 。。。

      不知道xampp官方怎么搞得，还是有人改过服务器的php.ini

      你在php.ini 文件里 写有很多extension 的地方加上一句

      extension=php_xsl.dll      重启一下apache

      好了吧，要是还不行就自己解决吧，我没碰到过了

五 关于Image_GraphViz

      Phpdocument2 有一个绘制类层次图的功能要用到，当然不安装Image_GraphViz也没关系，只是没法绘制类图而已，其余没有差别。

      不过我还是建议安装上，因为感觉这个功能貌似很厉害（声明：我没见过它绘制的类图，也没用安装过）

      安装方法：pear channel-discover pear.phpdoc.org

               pear install Image_GraphViz

六 其余安装方式

phpdocument2 也可以直接从官网下载，不通过pear

      但是，要修改一下bin目录下的 phpdoc.dat  有兴趣的可以自己研究一下

      （我没研究出来，对于dos 命令我不太懂。。。。）