phpdoc 注释写法

/**
*  @name   名字
*  @abstract   申明变量/类/方法
*  @access   指明这个变量、类、函数/方法的存取权限
*  @author   函数作者的名字和邮箱地址
*  @category   组织packages
*  @copyright   指明版权信息
*  @const   指明常量
*  @deprecate   指明不推荐或者是废弃的信息
*  @example   示例
*  @exclude   指明当前的注释将不进行分析，不出现在文挡中
*  @final   指明这是一个最终的类、方法、属性，禁止派生、修改。
*  @global   指明在此函数中引用的全局变量
*  @include   指明包含的文件的信息
*  @link   定义在线连接
*  @module   定义归属的模块信息
*  @modulegroup   定义归属的模块组
*  @package   定义归属的包的信息

* @param  定义函数或者方法的参数信息

          * @param string $charset 值如 gbk, big5, utf-8, utf8

          标记，类型名，变量名，解释语句。

*  @return   定义函数或者方法的返回信息
*  @see   定义需要参考的函数、变量，并加入相应的超级连接。
*  @since   指明该api函数或者方法是从哪个版本开始引入的
*  @static   指明变量、类、函数是静态的。
*  @throws   指明此函数可能抛出的错误异常,极其发生的情况
*  @todo   指明应该改进或没有实现的地方

* @var  定义说明变量/属性。

          /**
* 查询缓存目录路径
* @var string
*/

*  @version   定义版本信息
*/