[摘要]type) [varname] [description] 使用范围:function 指明在此函数中引用的全局变量举例: /*** Simuliert include_once in PHP 3....
type) [$varname] [description] 使用范围:function
指明在此函数中引用的全局变量
举例:
/**
* Simuliert include_once in PHP 3.
*
* @global array $__used_files 已经include的文件列表
* @access public
*/
function include_once($filename) {
global $__used_files;
if (!isset($__used_files["include_once"][$filename])) {
$__used_files["include_once"][$filename] = true;
include($filename);
}
}
@include description 使用范围:use
指明包含的文件的信息。
举例:
/**
* 抽象绘图类的定义.
*
* @includeFunction: _require_
*/
require("abstract.php");
@link URL description 使用范围:class, function, var, module, define, use
定义在线连接,如上面3.4中讲到的,你可以使用@link添加适当的在线链接。
例如:@link http://www.phpdoc.de/ PHPDoc Home
@magic description
这个标记在phpdoc中没有说明,具体用法现在仍不清楚
@module label 使用范围:module
定义归属的模块信息,label是模块的名字,拥有相同的模块名字的函数在索引分类中将被组合在一起。如果你没有使用OOP的思想来编写PEAR代码,那么建议你使用这个标记把相关的函数归集到相应的模块下面,这样你的整体的框架不至于过于零散和混乱。
@modulegroup label 使用范围:module
定义归属的模块组 label是这个模块组的名字,如果你的应用程序的模块很多,你可以把不同的模块按照逻辑功能的不同,划分成相应的模块组,这样,你的应用框架可以有比较清晰的逻辑关系。这是对于没有使用OOP编程的来说的,如果使用OOP的思想,没有必要使用模块组的概念,因为直接使用"包-超类--基类--子类"的形式来体现你的框架结构要比使用"包-模块组-模块"的形式好的多。
@package label 使用范围:class, module
定义归属的包的信息,label 是这个包的名字。相同的包的名字的类在最终文档索引中将被分在一起。实际上,包还可以理解为不同的名字空间,虽然PHP没有名字空间的概念,但是你可以把相关的类、模块都归属于同一个包,这样,相当于组织了一个名字空间,当然,你的应用框架可能会有不同的包,可惜的是,这种情况下从语法上是得不到名字空间这种保证的,你只能通过人为地去避免不同的包的函数或者类重名。
@param[eter] (object objecttype
关键词:PEAR:运用PHPDoc简单创建你的PEAR文档