一 简介
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 命令我不太懂。。。。)