php文档工具PHP Documentor安装与使用方法,_PHP教程

WBOY
Release: 2016-07-12 08:59:59
Original
1084 people have browsed it

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" 

Copy after login

如果没有安装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

Copy after login

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

通过浏览器来看一下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文档的原理和实例

www.bkjia.comtruehttp://www.bkjia.com/PHPjc/1095680.htmlTechArticlephp文档工具PHP Documentor安装与使用方法, 本文讲述了php文档工具PHP Documentor安装与使用方法。分享给大家供大家参考,具体如下: PHP Docum...
Related labels:
source:php.cn
Statement of this Website
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn
Popular Tutorials
More>
Latest Downloads
More>
Web Effects
Website Source Code
Website Materials
Front End Template
About us Disclaimer Sitemap
php.cn:Public welfare online PHP training,Help PHP learners grow quickly!