php注释规范

注释在写代码的过程中非常重要，好的注释能让你的代码读起来更轻松，在写代码的时候一定要注意注释的规范。

1 文件头的注释，介绍文件名，功能以及作者版本号等信息

/** 
*文件名简单介绍
* 
*文件功能。 
* @author      alvin 作者
* @version     1.0 版本号
*/

2 函数的注释，函数作用，参数介绍及返回类型

/**  
* 函数的含义说明 
* 
* @access public 
* @param int $arg1 参数一的说明 
* @param string $arg2 参数二的说明 
* @param mixed $mixed 这是一个混合类型 
* @return array 返回类型
*/

3 类的注释，类名及介绍

/** 
* 类的介绍 
* 
* 类的详细介绍（可选。）。 
* @author      alvin 作者 
* @version     1.0 版本号
*/

4 多行注释

/** 
* 多行注释
* 
*/

5 单行注释

$name = 'jiangshui'; //单行注释