php文档工具PHP Documentor安装与使用方法


Posted in PHP onJanuary 25, 2016

本文讲述了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]$ ls
blank.html elementindex.html li_�页.html
classtrees_default.html elementindex_�页.html media
classtrees_�页.html errors.html packages.html
default index.html �页
elementindex_default.html li_default.html

到存放生成文档的目录中看一下。系统没有装中文字符,所以中文乱码。

通过浏览器来看一下index.html,部分内容如果下

php文档工具PHP Documentor安装与使用方法

PHP Documentor 文档工具

1. 从上图中,我们可以看出,文档中的内容主要是把php文件中的注释标签列出来,相应的文件列出来,看着比较舒服。其他没有什么。

注释标签如下

@author 作者信息
@const 由define定义的常量
@deprecate 不建议使用的API
@global 全局变量
@package 包信息
@param 函数参数
@return返回值
@see 参考函数
@since 引入时间
@static 静态变量
@var 类成员变量

2. 上图中有乱码的,生成的html的编辑是

<meta http-equiv='Content-Type' content='text/html; charset=iso-8859-1'/>

把它改成gbk就不会显示乱码的。

希望本文所述对大家PHP程序设计有所帮助。

PHP 相关文章推荐
PHP中的加密功能
Oct 09 PHP
文章推荐系统(三)
Oct 09 PHP
深入解析php模板技术原理【一】
Jan 10 PHP
PHP性能优化准备篇图解PEAR安装
Dec 05 PHP
PHP应用JSON技巧讲解
Feb 03 PHP
php使用imagick模块实现图片缩放、裁剪、压缩示例
Apr 17 PHP
typecho插件编写教程(六):调用接口
May 28 PHP
简单了解PHP编程中数组的指针的使用
Nov 30 PHP
php模板引擎技术简单实现
Mar 15 PHP
YII动态模型(动态表名)支持分析
Mar 29 PHP
PHP后期静态绑定实例浅析
Dec 21 PHP
PHP simplexml_load_string()函数实例讲解
Feb 03 PHP
PHP代码维护,重构变困难的4种原因分析
Jan 25 #PHP
PHP+apc+ajax实现的ajax_upload上传进度条代码
Jan 25 #PHP
PHP实现的oracle分页函数实例
Jan 25 #PHP
PHP设置头信息及取得返回头信息的方法
Jan 25 #PHP
基于命令行执行带参数的php脚本并取得参数的方法
Jan 25 #PHP
crontab无法执行php的解决方法
Jan 25 #PHP
win7安装php框架Yii的方法
Jan 25 #PHP
You might like
一个程序下载的管理程序(三)
2006/10/09 PHP
在smarty模板中使用PHP函数的方法
2011/04/23 PHP
PHP通过串口实现发送短信
2015/07/08 PHP
JavaScript Event学习第七章 事件属性
2010/02/07 Javascript
JS判断当前日期是否大于某个日期的实现代码
2012/09/02 Javascript
javascript对象的使用和属性操作示例详解
2014/03/02 Javascript
Jquery中offset()和position()的区别分析
2015/02/05 Javascript
简介JavaScript中的italics()方法的使用
2015/06/08 Javascript
js鼠标点击图片切换效果代码分享
2015/08/26 Javascript
js点击文本框弹出可选择的checkbox复选框
2016/02/03 Javascript
详解VUE自定义组件中用.sync修饰符与v-model的区别
2018/06/26 Javascript
VUE单页面切换动画代码(全网最好的切换效果)
2019/10/31 Javascript
javascript单张多张图无缝滚动实例代码
2020/05/10 Javascript
Vue 实现监听窗口关闭事件,并在窗口关闭前发送请求
2020/09/01 Javascript
jQuery-App输入框实现实时搜索
2020/11/19 jQuery
[03:04]DOTA2英雄基础教程 影魔
2013/12/11 DOTA
[01:17:12]职来职往完美电竞专场
2014/09/18 DOTA
简单的Python抓taobao图片爬虫
2014/10/26 Python
Python 基础教程之str和repr的详解
2017/08/20 Python
在Python3 numpy中mean和average的区别详解
2019/08/24 Python
Python3 JSON编码解码方法详解
2019/09/06 Python
django创建简单的页面响应实例教程
2019/09/06 Python
wxpython布局的实现方法
2019/11/01 Python
python进程的状态、创建及使用方法详解
2019/12/06 Python
python3.7.3版本和django2.2.3版本是否可以兼容
2020/09/01 Python
Python爬虫爬取微博热搜保存为 Markdown 文件的源码
2021/02/22 Python
利用CSS3的特性改变文本选中时的颜色
2013/09/11 HTML / CSS
详解CSS3中@media的实际使用
2015/08/04 HTML / CSS
保卫科工作岗位职责
2014/03/01 职场文书
支部鉴定材料
2014/06/02 职场文书
中央空调节能方案
2014/06/15 职场文书
2014年党员整改措施范文
2014/09/21 职场文书
2015新员工试用期工作总结
2014/12/12 职场文书
入党自传范文2015
2015/06/26 职场文书
基于Pygame实现简单的贪吃蛇游戏
2021/12/06 Python
【海涛教你打DOTA】黑鸟第一视角解说
2022/04/01 DOTA