php注释规范

 

 

注释在写代码的过程当中很是重要,好的注释能让你的代码读起来更轻松,在写代码的时候必定要注意注释的规范。(转自李老师)php

php里面常见的几种注释方式:函数

1.文件头的注释,介绍文件名,功能以及做者版本号等信息post

复制代码
/** 
*文件名简单介绍
* 
*文件功能。 
* @author      alvin 做者
* @version     1.0 版本号
*/ 
复制代码

2.函数的注释,函数做用,参数介绍及返回类型spa

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

3.类的注释,类名及介绍code

复制代码
/** 
* 类的介绍 
* 
* 类的详细介绍(可选。)。 
* @author      alvin 做者 
* @version     1.0 版本号
*/ 
复制代码

4.多行注释blog

/* php注释语法
   这是多行注释。*/ 

5.单行注释it

$n = 10; //数量n,这是单行注释