php文档工具php documentor安装与使用方法,本文讲述了php文档工具php documentor安装与使用方法。分享给大家供大家参考,具体如下:
php documentor是pear下面的一个模块,用来生成文档。php documentor扫描指定目录下面的php源代码,扫描其中的关键字,截取需要分析的注释,然后分析注释中的专用的tag,生成html文件,接着根据已经分析完的类和模块的信息,建立相应的索引,生成html文件。在review代码的时候,有点用处。
一、安装php documentor
首先要先确认一下有没有安装pear库,
; unix: /path1:/path2 include_path = .:/usr/share/pear //pear库位置 ; ; windows: \path1;\path2 ;include_path = .;c:\php\includes
如果没有安装http://pear.php.net/go-pear,文件另存为一下。命令行下php go-pear.php,就可以安装了。 我是用yum安装的php,安装的时候,pear已经安装了。pear安装好后,我可以通过pear install phpdocumentor来安装phpdoc
[apacheuser@krlcgcms01 ~]$ phpdoc -h 里面会有很多的参数,要生成html文档,有三个参数是够了。
-d 要分析的目录,多个目录用逗号分割
-t 生成的文档的存放路径
-o 输出的文档格式
二、生产文档
复制代码 代码如下:[root@krlcgcms01 test]# phpdoc -d /tmp/test/mytest -t /tmp/test/doc -o html:frames:phpedit
上面的这句话是说,将/tmp/test/mytest目录下的php文件,生成文档资料放到/tmp/test/doc下面,文档格式html的形势。
[apacheuser@krlcgcms01 doc]$ lsblank.html elementindex.html li_首页.htmlclasstrees_default.html elementindex_首页.html mediaclasstrees_首页.html errors.html packages.htmldefault index.html 首页elementindex_default.html li_default.html
到存放生成文档的目录中看一下。系统没有装中文字符,所以中文乱码。
通过浏览器来看一下index.html,部分内容如果下
php documentor 文档工具
1. 从上图中,我们可以看出,文档中的内容主要是把php文件中的注释标签列出来,相应的文件列出来,看着比较舒服。其他没有什么。
注释标签如下:
@author 作者信息
@const 由define定义的常量
@deprecate 不建议使用的api
@global 全局变量
@package 包信息
@param 函数参数
@return返回值
@see 参考函数
@since 引入时间
@static 静态变量
@var 类成员变量
2. 上图中有乱码的,生成的html的编辑是
复制代码 代码如下:
æå®æ¹ægbkå°±ä¸ä¼æ¾ç¤ºä¹±ç çã
å¸ææ¬ææè¿°å¯¹å¤§å®¶phpç¨åºè®¾è®¡ææå¸®å©ã
æ¨å¯è½æå
´è¶£çæç« :æå»ºvim为èªå®ä¹çphpå¼åå·¥å
·çä¸äºæå·§php常ç¨å·¥å
·ç±»å¤§å
¨éå
¨é¨ä»£ç ä¸è½½åæ¨è忬¾å
è´¹çphpå¼åå·¥å
·10款å®ç¨çphp弿ºå·¥å
·phpè½»éçº§çæ§è½åæå·¥å
·xhprofçå®è£
使ç¨phpå®ç°ç½é¡µç¼åçå·¥å
·ç±»å享10个ç®åphpå¼åçå·¥å
·åäº«ä¸æ®µphpå¶ä½ç䏿æ¼é³é¦åæ¯å·¥å
·ç±»å½åæ¯è¾æµè¡ç两款phpå å¯ãè§£å¯å·¥å
·zend guardåiconcubeä»ç»php管çä¾èµ(dependency)å
³ç³»å·¥å
· composer å®è£
ä¸ä½¿ç¨å¨windowsç³»ç»ä¸ä½¿ç¨phpçæwordææ¡£çæç¨ä½¿ç¨php导åºwordææ¡£çåçåå®ä¾
http://www.bkjia.com/phpjc/1095680.htmlwww.bkjia.comtruehttp://www.bkjia.com/phpjc/1095680.htmltecharticlephpææ¡£å·¥å
·php documentorå®è£
ä¸ä½¿ç¨æ¹æ³ï¼ æ¬æè®²è¿°äºphpææ¡£å·¥å
·php documentorå®è£
ä¸ä½¿ç¨æ¹æ³ãå享ç»å¤§å®¶ä¾å¤§å®¶åèï¼å
·ä½å¦ä¸ï¼ php docum...