PHP注释规范

必须注释的地方：PHP文件头和函数头
1、PHP文件头注释规范：
1    /**
2      * [description]             　　　　　　  PHP文件描述
3      * @author [author] <[email]>   　　　　　 作者信息，[作者名称]<[邮箱地址]>
4      * @version [version]                　　 当前版本号[版本号]
5      * @since [version]            　　　　　　从项目哪个版本加入此文件，[版本]
6      */
2、PHP方法（函数）注释规范：
1     /**
2      * [function description]               　　　　方法（函数）描述
3      * @param  [type] $param1   [description]      方法（函数）传入的参数1， @param [参数类型] $参数名 [描述]
4      * @param  [type] $param2 [description]　　　　 方法（函数）传入的参数2， @param [参数类型] $参数名 [描述]
5      * @return [type]       [description]          方法（函数）的返回值，@return [返回值类型] [返回值描述]
6      */

 

posted @ 2015-09-09 10:20  肯瑞托学徒  阅读(503)  评论(0)  编辑  收藏  举报