安装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

另外有需要云服务器可以了解下创新互联cdcxhl.cn，海内外云服务器15元起步，三天无理由+7*72小时售后在线，公司持有idc许可证，提供“云服务器、裸金属服务器、高防服务器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案，具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势，专为企业上云打造定制，能够满足用户丰富、多元化的应用场景需求。