安装phpDocumentor

写文件是一个程序设计师最痛苦的事情之一,尤其是程序写好后有人要你把function、class等等写成一份文件。不管你是写c/c++,perl,ruby,php都不例外。

成都创新互联公司专注于钦南企业网站建设,自适应网站建设,商城网站定制开发。钦南网站建设公司,为钦南等地区提供建站服务。全流程按需制作,专业设计,全程项目跟踪,成都创新互联公司专业和态度为您提供的服务

phpdocumentor是我们的就行,只要在写程序的时候,多写一点注释,范例、说明,注意一下格式,等到程序完工后,只要一个指令,就可以立刻把全部程序的说明文件产生出来,而且还有多种样式可以选择,甚至可以做成PDF,CHM。下面是安装过程。

phpDocumentor本身已经是pear的成员之一,所以安装的时候只要用pear来安装即可。安装之前先确保你的电脑上已经有php。

一、安装pear

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

/usr/local/php/bin/php go-pear.php                    #执行这条命令之后按回车执行安装。

二、安装DB

下面通过pear来安装PHP-PEAR_DB库

wget download.pear.php.net/package/DB-1.7.14.tgz

pear install DB-1.7.14.tgz                            #安装DB库

pear install phpDocumentor                            #安装phpDocumentor

安装完毕。下面测试

三、测试

phpdoc -o HTML:Smarty:PHP -d /home/wwwroot/polyguide/application/controllers/app -t /home/phpdocument

#执行完毕之后就可以到/home/phpdocument目录下查看文档了。注意,打开可能是乱码。需要更改浏览器的编码格式成“UTF-8”。

命令说明:

    采用 HTML:Smarty:PHP 的格式,-d后面接的是你的程序放置目录,-t是将生成的文件放在哪个目录下。如果你只要对一个文件生成的话,把-d改成-f。-f后面就是你要对哪个文件生成文档。文档的格式基本上有HTML,XML,PDF,CHM四大类别。

本篇文档是我安装的时候经由多篇博客汇聚而来。感谢@蒜容黄瓜的博客 @鸟哥のlinux


分享标题:安装phpDocumentor
本文网址:http://myzitong.com/article/jjdcpg.html