您现在的位置: 无忧电子商务网 >> 信息学院 >> 程序开发 >> php >> 正文

使用PHPDoc轻松建立你的PEAR文档

作者:佚名    信息学院来源:整理    点击数:    更新时间:2008-2-2 我要参与讨论

  出错,无法连接数据库,网络连接超时或者是在一些情况下,你"故意"抛出的异常等等。

@todo 使用范围:class, function, module, use
指明应该改进或没有实现的地方

@var[iable] (object objecttype|type) [$varname] [description] 使用范围:var
定义说明变量/属性。
object objecttype|type 定义你的变量的类型,同@param一样
$varname 该变量的名字,你可以从其他地方使用@see来引用这个名字
description 对变量的描述

@version label 使用范围:class, function, module, use
定义版本信息.
你当然可以自己手工写这些版本信息,不过pear推荐你使用cvs的$id标记来自动标示你的版本信息。形式如下:

@version $id
这样,当你checkout的时候,cvs自动会扩展成: @version $id: phpdocparsercore.php,v 1.4 2001/02/18 14:45:27 uw exp

5. 生成文档
5.1 安装phpdoc
安装phpdoc很简单,实际上因为它已经随同php 4.05一同发布了,所以如果你的php是4.05,那么在pear目录下面会发现phpdoc这个模块.如果你没有发现,你可以从phpdoc的cvs获得一份最新的源码.

5.2 运行phpdoc
运行phpdoc需要做一些准备工作,首先要调整你的php.ini的参数,

因为phpdoc运行的时间比一般的php应用要长,很可能会超过你在php.ini中定义的最大运行时间(缺省是30秒),根据作者的建议:piii,60秒,120秒pii,240秒mmx200,480秒如果配置更低的话。如果出现超时,你可以自己适当延长这些数值。

在php.ini中修改:
;;;;;;;;;;;;;;;;;;;
; resource limits ;
;;;;;;;;;;;;;;;;;;;

max_execution_time = 480
memory_limit = 8388608




如果你不愿意或者没有修改php.ini的权限,那么你可以使用set_time_limit()函数来设置这个时间,使用方法: set_time_limit(480); 设置从此点开始,运行480秒后才超时。将这个函数加在index.php中,就可以和修改php.ini达到同样的效果。

其次,你要修改phpdoc目录下面的index.php文件:
// directory with include files
define("phpdoc_include_dir", "c:/www/apache/doc/");


将"c:/www/apache/doc/修改成你的phpdoc的目录
// important: set this to the linebreak sign of your system!
define("linebreak", "\r\n&qu

上一页  [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]  ... 下一页  >> 

在google里搜索更多使用PHPDoc轻松建立你的PEAR文档

Google
Web www.51ec.org
  • 上一篇信息学院:

  • 下一篇信息学院:
  • 【字体: 】【发表评论】【加入收藏】【告诉好友】【打印此文】【关闭窗口
    我来说两句 对此文章发表了评论
      昵 称: *必填    ·注册用户·
      评 分: 1分 2分 3分 4分 5分     严禁发表危害国家安全、政治、黄色淫秽等内容的评论,用户需对自己在使用本网站服务过程中的行为承担法律责任。本站管理员有权保留或删除评论内容,评论内容只代表机友个人观点,与本网站立场无关。  
    评 论
    内 容

     
    评论列表 (最新 评论仅限网友观点!)

    供求信息




    | 设为首页 | 加入收藏 | 关于我们 | 广告服务 | 联系方式 | 友情链接 | 版权申明