- @api: 提供给第三方使用的接口
- @author: 标明作者
- @param: 参数
- @return: 返回值
- @todo: 待办
- @version: 版本号
- @inheritdoc: 文档继承
- @property: 类属性
- @property-read: 只读属性
- @property-write: 只写属性
- @const: 常量
- @deprecated: 过期方法
- @example: 示例
- @final: 标识类是终态, 禁止派生
- @global: 指明引用的全局变量
- @static: 标识类、方法、属性是静态的
- @ignore: 忽略
- @internal: 限内部使用
- @license: 协议
- @link: 链接,引用文档等
- @see: 与 link 类似, 可以访问内部方法或类
- @method: 方法
- @package: 命名空间
- @since: 从指定版本开始的变动
- @throws: 抛出异常
- @uses: 使用
- @var: 变量
- @copyright: 版权声明
对应的常见类型，如下：
- string: 字符串
- int/integer: 数字
- boolean/bool: 布尔
- float/double: 浮点
- object: 对象实例
- TestClass: 指定类
- mixed: 任意类型
- array: 数组
- TestClass[]: 指定类型数组
- resource: 文件资源
- void: 无
- null:
- callable: 回调函数
- function: 方法
- self/$this: 当前实例