| 标签 | 说明 |
|
@access public|private|protected |
描述了访问级别。当使用反射技术时，这个标签不是很有用，这是因为API能够自动获取这一特性。在PHPDoc中，用它可略去私有成员的文档生成。 |
|
@author Author Name [<author@email.com>] |
帮助获得负责某个特定元素的人的信息（强烈推荐使用这一标签） |
|
@copyright Copyright Information |
可指定代码的版权所有者 |
|
@deprecated [version information] |
可通知代码的使用者这个元素不再被使用并且已经被替换 |
|
@example [path|url] description |
可引用一个例子，阐释如何使用这个元素。第二个参数可以是一个路径也可以是一个完整的URL |
|
@filesource |
可用来表示希望让文件源出现在文档中，这一标签只能出现在页面级别的块中，在其他地方出现将会被忽略 |
|
@global datatype description |
说明了全局变量的数据类型。这一标签必须紧贴在全局变量的前面，并且只对PHPDocumentor解析器起作用。对于基于反射技术的解析器用处不大。 |
|
@ignore |
通知解析器忽略这个元素，并且不将它包含在文档中 |
|
@internal |
可以隐藏特定的信息，使之不出现在公开文档中。可以用在内嵌的注释内容中或者新行注释中。 |
|
@license url [license] |
指定此软件授权信息的URL，还可以说明授权者的姓名 |
|
@link url [description] |
在文章中包含一个连接。这个标签可以用在内嵌的内容中。 |
|
@param datatype $variablename [,...] description |
说明与函数和方法关联的参数。这可能是最重要的标签。变量名称参数可以包括,...符号以表示函数可以传入不定数量的其它参数 |
| @return datatype description | 说明了函数或方法返回的数据类型，这可能是第二个重要的标签，并且它是在PHP中包含关于返回数据的元数据的唯一方法。推荐所有具有返回值得函数使用这一标签。 |
| @see reference | 引用另外一个元素的文档。在这里可以使用不同类型的指针，包括文件、函数名称、类方法以及其他许多类型的指针。多个指针值可以用逗号隔开。这个标签也可以用在内嵌的内容中。 |
|
@since version [informatioin] |
用于说明这个元素第一次出现的版本信息 |
|
@todo description |
包含了待完成工作的信息，或者待解决问题的信息 |
|
@version |
指定了元素的当前版本号 |