####PHP文档注释规范
~~~
// +----------------------------------------------------------------------
// | 项目名称 [ 文档功能简要描述 ]
// +----------------------------------------------------------------------
// | Copyright (c) 2016-2016 版权 All rights reserved.
// +----------------------------------------------------------------------
// +----------------------------------------------------------------------
// | Author: Chenjl // +----------------------------------------------------------------------
~~~
####函数/方法头部注释
~~~
/**
* 函数/方法作用描述
*
* @access public
* //指明关键字的存取权限:private、public或proteced
* @version 0.0.1
* //指明版本信息
* @Author Chenjl *
* //指明编码作者
* @return mixed | void
* //指明一个方法或函数的返回值
* @copyright
* //指明版权信息
*/
~~~
####程序代码注释
注释的原则是将问题解释清楚,并不是越多越好。
若干语句作为一个逻辑代码块,这个块的注释使用:/* */方式。
具体到某一个语句的注释,可以使用行尾注释://。