1.程序注释：写在代码前面而不是后面，单行代码按照习惯写在代码尾部；大段注释采用/**/的方式，通常为文件或函数的顶部，代码内部使用'//'；注释不宜太多；代码注释应该描述为什么而不是做什么，给代码阅读者提供最主要的信息。
2.文件注释：文件注释一般放在文件的顶部，包括本程序的描述、作者、项目名称、文件名称、时间日期、版本信息、重要的使用说明（类的调用，注意事项等）。版本更改要修改版本号，并加上mofify注释。
3.类和接口注释：按照一般的习惯，一个文件只包含一个类。
4.方法和函数注释：方法和函数的注释写在前面，通常需要表明信息的主要可见性、参数类型和返回值类型。
/**
* 连接数据库
* @param string $dbhost 数据库服务器地址
* @param string $dbuser 数据库用户名
* @param string $dbpwd 数据库密码
*/
六、代码风格
1.缩进和空格：使用4个空格做为缩进，不使用Tab键；变量赋值时，等号两边留出空格。（$url = '$_GET['url']';）
2.语句断行：尽量保证程序语句一行即一句；尽量不要使一行的代码过长，80个字符以内；如果一行的代码太长，请使用类似于‘.='方式断行连接；执行数据库的sql语句操作时，尽量不要再函数内写sql语句，而先用变量定义sql语句，然后在执行操作的函数中调用定义的变量。
3.更好的习惯：在代码中使用下面列举的方法，可以使代码更优雅。
1）：多使用php中已经存在的常量，而不要自己定义。
例：//换行
echo $msg."\r\n";
echo $msg,PHP_EOL;
php中PHP_EOL是一个预定义常量，表示一行结束，随着所使用系统不同，使用PHP_EOL代码可移植性更高
2）：在echo中使用逗号做连接符，比用‘.'做连接符代码更美观。
3）：单引号的效率高于双引号，但二者在使用上有区别，学会使用printf函数。
例：//echo
echo '每个'.$scholl.'大约有'.floor($avg).'个学生'；
//printf
$format = '每个%s大于有$d个学生';
printf($format,$school,$avg);
4) ：详细的注释
5）：不要 滥用语法糖，语法糖就是语言中的潜规则，即不具备普遍代表性的语法。
您可能感兴趣的文章: