_files["include_once"][$filename])) {
$__used_files["include_once"][$filename] = true;
include($filename);
}
}




@include description 使用范围：use
指明包含的文件的信息。
举例：
/**
* 抽象绘图类的定义.
*
* @include function: _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|type) [$varname] [description] 使用范围：function
定义函数或者方法的参数信息。这是最常使用的文档标记了。

ojecttype 是对象的类名，type 指出这个参数的类型，它可以是下列类型：

string 该参数是一个字符型变量。
array 该参数是一个数组。
integer 该参数是一个数值型。
integer (octal) 该参数是一个数值型，并且是按照八进制方式存放。
integer (hexadecimal) 该参数是一个数值型，并且是按照十六进制方

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

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

	Web www.51ec.org

上一篇信息学院： 搜索引擎技术核心揭密(PHP)

下一篇信息学院： 比较PHPLIB Template和FastTemplate…