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中MD5函数使用实例代码
Jun 07 PHP
用PHP将网址字符串转换成超链接(网址或email)
May 25 PHP
生成ubuntu自动切换壁纸xml文件的php代码
Jul 17 PHP
在php和MySql中计算时间差的方法
Apr 22 PHP
apache配置虚拟主机的方法详解
Jun 17 PHP
php防止SQL注入详解及防范
Nov 12 PHP
php生成数组的使用示例 php全组合算法
Jan 16 PHP
php中字符串和正则表达式详解
Oct 23 PHP
php随机抽奖实例分析
Mar 04 PHP
thinkPHP数据查询常用方法总结【select,find,getField,query】
Mar 15 PHP
PHP实现的Redis多库选择功能单例类
Jul 27 PHP
Laravle eloquent 多对多模型关联实例详解
Nov 22 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
sourcesafe管理phpproj文件的补充说明(downmoon)
2009/04/11 PHP
php利用header函数实现文件下载时直接提示保存
2009/11/12 PHP
php页面缓存方法小结
2015/01/10 PHP
通过php动态传数据到highcharts
2017/04/05 PHP
jquery 得到当前页面高度和宽度的两个函数
2010/02/21 Javascript
jquery复选框全选/取消示例
2013/12/30 Javascript
JavaScript中rem布局在react中的应用
2015/12/09 Javascript
js密码强度实时检测代码
2016/03/02 Javascript
jquery实现一个简单的表单验证实例
2016/03/30 Javascript
深入理解requestAnimationFrame的动画循环
2016/09/20 Javascript
bootstrap的3级菜单样式,支持母版页保留打开状态实现方法
2016/11/10 Javascript
纯JS焦点图特效实例(可一个页面多用)
2016/12/07 Javascript
Angular实现跨域(搜索框的下拉列表)
2017/02/16 Javascript
深入理解vue.js中的v-if和v-show
2017/06/22 Javascript
js/jquery遍历对象和数组的方法分析【forEach,map与each方法】
2019/02/27 jQuery
vue element-ui中table合计指定列求和实例
2020/11/02 Javascript
[01:32]dota2拉比克至宝(222)
2018/12/20 DOTA
通过Python 接口使用OpenCV的方法
2018/04/02 Python
python爬虫_实现校园网自动重连脚本的教程
2018/04/22 Python
python selenium自动上传有赞单号的操作方法
2018/07/05 Python
python脚本开机自启的实现方法
2019/06/28 Python
python归并排序算法过程实例讲解
2020/11/04 Python
jupyter 添加不同内核的操作
2021/02/06 Python
分享全球十款超强HTML5开发工具
2014/05/14 HTML / CSS
夏洛特和乔治婴儿和儿童时装精品店:Charlotte and George
2018/06/06 全球购物
运动会领导邀请函
2014/01/10 职场文书
小学生我的梦想演讲稿
2014/08/21 职场文书
学生会竞选演讲稿学习部
2014/08/25 职场文书
党员个人自我评价
2015/03/03 职场文书
奖学金个人总结
2015/03/04 职场文书
个性与发展自我评价
2015/03/06 职场文书
劳动模范获奖感言
2015/07/31 职场文书
辞职报告(范文三篇)
2019/08/27 职场文书
CSS3实现三角形不断放大效果
2021/04/13 HTML / CSS
MySQL数据库如何查看表占用空间大小
2022/06/10 MySQL
JS前端使用Canvas快速实现手势解锁特效
2022/09/23 Javascript