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

本文讲述了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 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
, 安装
, 使用
, phpDocumentor
文档工具
php documentor、php接口文档生成工具、php api文档生成工具、php文档生成工具、php api文档编写工具,以便于您获取更多的相关知识。

时间: 2024-10-03 07:04:52

php文档工具PHP Documentor安装与使用方法_php技巧的相关文章

使用ltrace工具跟踪PHP库函数调用的方法_php技巧

本文实例讲述了使用ltrace工具跟踪PHP库函数调用的方法.分享给大家供大家参考,具体如下: 可能大家已经很熟悉使用strace来跟踪系统调用,今天介绍一个跟踪库函数的利器ltrace 比如我有这么一段PHP代码 test.php: <?php $y = '1380'; $arr = array(); for($i = 0; $i < 2000; $i ++){ $arr[] = "{$i}"; //故意用引号包起来设成字符串 } for($i = 0; $i <

Linux下ZendOptimizer的安装与配置方法_php技巧

内容:  在装的好的Red Hat Linux 9 + Apache 2.0.55 + MySQL 5.1.6 + PHP 5.1.2后,接下来就是安装linux下的php加速器ZendOptimizer 2.6.2了.  自己编译 PHP 后,Zend Optimizer 2.6.2 需要自己设置一下,请参照以下步骤:  假设你编译滴PHP在如下目录:/opt/php  第一步:下载 Zend Optimizer 2.6.2 地址:http://downloads.zend.com/optim

PHP文档工具

写文档是一项乏味却不得不做的工作,而编写API级的文档更是意味着大量的重复劳动和难以保持的一致性.这里我们要推荐给大家的,是支持PHP5语法分析的文档工具--phpDocumentor. 使用phpDocumentor不仅可以自动从代码中提取出函数和方法定义,还可以自动处理各个class之间的关系,并据此生成class tree.你还可以选择将文档生成html.chm或者pdf.有了phpDocumentor,文档工作变得轻松了很多. 安装phpDocumentor 在pear下安装phpDoc

可查看、打印word文档工具:Word Viewer

      即使您没有安装 Word,您也可以查看.打印和复制 Word 文档.什么软件这么牛呢?今天就给大家介绍微软开发的免费的查看.打印word文档工具:Word Viewer.       Word Viewer最新的两个版本是Word Viewer 2003和Word Viewer 2007.   Microsoft Office Word Viewer 2003 介绍:      除 Word 文档文件 (.doc) 外,您还可以打开使用下列格式保存的文件: RTF 格式 (.rtf)

不需word即可查看、打印word文档工具:Word Viewer

     即使您没有安装 Word,您也可以查看.打印和复制 Word 文档.什么软件这么牛呢?今天就给大家介绍微软开发的免费的查看.打印word文档工具:Word Viewer.       Word Viewer最新的两个版本是Word Viewer 2003和Word Viewer 2007. Microsoft Office Word Viewer 2003 介绍:      除 Word 文档文件 (.doc) 外,您还可以打开使用下列格式保存的文件: RTF 格式 (.rtf) 文本

文档工具Dr.Explain、原型设计工具

写软件文档时,使用Dr.Explain这个工具可以事半功倍. 文档工具Dr.Explain 特点 Ø 自动抓取界面元素并标识 Ø 可导出CHM.pdf.HTML.RTF格式 Ø CHM格式的文件可以添加关键词形成索引列表 Ø 可以获取web winforms Flex等多种的界面和子元素 一键抓取界面 新建项目 抓界面:Add Window 选取窗口后软件自动获取软件的所有界面元素 在这个基础上进行组织和润色,方便了很多. 样例 Sample_Real_application_manual.gu

Word文档的表格中数据排序的方法

  Word文档的表格中数据排序的方法         1.在表格中单击将插入点光标放置到任意单元格中,然后在"表格工具-布局"选项卡中单击"数据"组中的"排序"按钮,如图1所示. 图1 单击"排序"按钮 2.打开"排序"对话框,在"主要关键字"下拉列表中选择排序的主要关键字,在"类型"下拉列表框中选择排序标准,然后单击其后的"降序"单选按钮选择以

Word文档怎么设置文字环绕图片 设置方法大全

在报纸中,我们经常会看到一张图片被嵌入到了文字中(如下图),你是不是以为这中效果只有使用专业的排版软件才可以实现?易捷PDF转换成Word可以告诉你,Word中的文字环绕图片功能就可能实现这种排版效果,无论您使用的是2003.2007还是2010版本的Word软件,都是没问题的. 文档怎么设置文字环绕图片 设置方法大全-"> 一.Word2003设置文字环绕图片的方法 1.插如-图片,在Word文档中插入需要的图片; 2.右键单击图片,单击"设置图片格式"里面的&quo

Word文档网页无法复制保存的解决方法

  无论是学生还是工作的人对查资料都是避无可避的,工作中的一切都需要摸索与学习,有些还需要整理文献资料,对于电脑操作系统中的复制操作都是非常熟悉因为它操作简单方便,无论是左击选中还是使用键盘快捷键,都特别简单,不用一个个打字节省了不少时间.但是win7系统最近对于保存下来的网页,用两种方法均无法复制,一般用户遇到这样的情况只会老老实实打字输入,下面小编就向没有电脑技术基础的用户介绍windows系统Word文档网页被限制无法复制的解决方法. Word文档网页无法复制保存的解决方法 方法一: 1.