因为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");
这是定义换行的标志,DOS下面是换行+回车,UNIX下面只是回车就可以。
下面,为你的要生成文档的应用程序做一些定制工作:
// Sets the name of your application.
// The name of the application is used e.g. as a page title
$doc->setApplication("PHPDoc");
setApplication()用来设置你的应用程序的名称,将PHPDOC替换成你应用程序的名字。
// directory where your source files reside:
$doc->setSourceDirectory(PHPDOC_INCLUDE_DIR);
setSourceDirectory()设置你的应用程序的PHP源文件所在的目录,将PHPDOC_INCLUDE_DIR替换成你实际的目录。
// save the generated docs here:
$doc->setTarget(PHPDOC_INCLUDE_DIR."apidoc/");
setTarget()设置你的API文档存放的目录,PHPDOC将在这个目录下面生成XML及HTML文件。将PHPDOC_INCLUDE_DIR."apidoc/"替换成你自己的目录。
// use these tem
| 对此文章发表了评论 |
