PhpDocumentor 生成文档

最近项目需要phpdoc生成文档,首先安装PhpDocumentor,利用pear安装:
切换用户:
su root
安装PhpDocumentor:

pear install PhpDocumentor
生成文档:

Phpdoc –h 
会得到一个phpDocumentor的详细参数列表。先看看最重要的几个吧。
-d  
这个目录代表着需要生成文档的原始php文件目录(注意是目录) 
-t  
这个目录代表着生成的文档存放目录
-o  

这个参数代表着生成的文档格式,例如html格式,参数就是
phpdoc -d /mnt/www/ci_system_3/application/controllers/api1 -t /mnt/www/sui -o HTML:frames:phpedit
    浏览生成文档结果很让我失望,程序中中文乱码,后google搜索得知,PhpDocumentor的默认编码是:iso-8859-1的,我的项目都是utf8编码的,所以需要把编码改成utf-8才可以。
进入PhpDocumentor的模板目录把模板文件修改成utf-8编码:

cd /usr/share/pear-data/PhpDocumentor/phpDocumentor/Converters
执行字符串查找并替换命令:

find ./ -name '*.tpl' | xargs sed -i 's/iso-8859-1/utf-8/g'
    执行完毕之后再生成项目文档,浏览项目中中文乱码解决。
以后如果项目换了别的编码,也可以用此命令修改过去。

  

很简单,大功告成,界面太丑,可以自定义界面.看手册.

原文地址:https://www.cnblogs.com/boundless-sky/p/7401077.html