**代碼注釋規范** ~~~ /** * 測試方法 * * @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 | | 表示文件未完成或者要完善的地方 |