出错,无法连接数据库,网络连接超时或者是在一些情况下,你"故意"抛出的异常等等。
@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
@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
| 对此文章发表了评论 |
