**代码注释规范** ~~~ /** * 测试方法 * * @ApiTitle (方法名test) * @ApiSummary (测试描述信息) * @ApiAuthor (接口作者) * @ApiMethod (POST) * @ApiRoute (/api/demo/test/) * @ApiHeaders (name=token, type=string, required=true, description="请求的Token") * @ApiParams (name="id", type="integer", required=true, description="会员ID") * @ApiParams (name="name", type="string", required=true, description="用户名") * @ApiParams (name="data", type="object", sample="{'user_id':'int','user_name':'string','profile':{'email':'string','age':'integer'}}", description="扩展数据") * @ApiReturnParams (name="code", type="integer", required=true, sample="0") * @ApiReturnParams (name="msg", type="string", required=true, sample="返回成功") * @ApiReturnParams (name="data", type="object", sample="{'user_id':'int','user_name':'string','profile':{'email':'string','age':'integer'}}", description="扩展数据返回") * @ApiReturn ({ 'code':'1', 'msg':'返回成功' }) */ public function test() { $this->success('返回成功', $this->request->param()); } ~~~ | 标签 | 实例 | 说明 | | --- | --- | --- | | @abstract | | 抽象类的变 和方法 | | @access | public, private or protected | 文档的访问和使用权限。＠ ccess private表明这个文档是私有的 | | @author | 小明 | 文档作者信息 | | @copyright | 名称时间 | 文档版权信息 | | @deprecated | Version | 文档中被废除的方法 | | @deprec | | 同 @deprecated | | @example | /path/to/example | 文挡的外部保存示例文件的位置 | | @exception | | 文档中方法抛出的异常，也可参照＠ hrows | | @global | 类型 $globalvarname | 文档中的全局变量及有关的方法和函数 | | @ignore | | 忽略文档中指定的关键字 | | @internal | | 开发团队内部信息 | | @link | URL | 类似于lic se ，但还可以通过访问 地址找到文档中更多的详细信息 | | @name | 变量别名 | 为某个变量指定别名 | | @magic | | PHPDoc兼容phpDocumentor的标签 | | @package | 封装包的名称 | 一组相关类、函数封装的包名称 | | @param | usemame 用户名 | 输入变量含义注释 | | @return | 如返回bool | 输出函数返回结果描述，一般不用在vo id 空返回结果的〕的函数中 | | @see | Class Login() | 文件关联的任何元素（全局变量，包括页面、类、函数、定义、方法、变量〉 | | @since | version | 记录什么时候对文档的哪些部分进行了更改 | | @static | | 记录静态类、方法 | | @staticvar | | 在类、函数中使用的静态变量 | | @subpackage | | 子版本 | | @throws | | 抛出的异常 | | @todo | | 表示文件未完成或者要完善的地方 |