1、PHP 编程规范与编码习惯最主要的有以下几点:

  1. 1、文件说明
  2. 2Function 函数体说明
  3. 3、代码缩进
  4. 4IF省略
  5. 5、变量规范
  6. 6、命名规范
  7. 7、十行一注释
  8. 8、注释风格
  9. 9、开放关闭原则

2、文件说明 我的个人代码 - 规范如下:

  1. <?php
  2. /*
  3. +----------------------------------------------------------------------
  4. + Title : 标题
  5. + Author : 作者
  6. + Version : 版本号
  7. + Initial-Time : 这个文件初始创建的时间
  8. + Last-time : 这个文件最后修改的时间 + 修改人的名称
  9. + Desc : 这个文件的简单描述
  10. +----------------------------------------------------------------------
  11. */

3、function 函数体说明:

  1. <?php
  2. /**
  3. * 函数体简单的描述
  4. * @author_start : 作者
  5. * @author_end : 修改时间 + 修改者
  6. * @param string : $id 描述
  7. * @param array : $array 描述
  8. * @param array : $num 描述
  9. * @return : 返回值说明
  10. */
  11. function Test($id, $array = array(), $num = 1){
  12. }

注意:function里面变量参数的代码缩进风格

4、代码缩进:

  1. <?php
  2. $str = 1;
  3. $info = '123';
  4. $version = '123123';
  5. $name = 'test';
  6. $i = 'haha';
  7. # 一般在最外部的if 或流程控制语句都应该上下留空一行
  8. if ($info) {
  9. }
  10. # 一般在最外部的for或者 foreach都应该上下留空一行
  11. for ($i=0 ,$i<6 ,$i++){
  12. }

5、if省略

  1. <?php
  2. # 一般在if语句与其分支的流程控制语句当中,存在这exit或者return的情况下,都应该省略其else的部分操作
  3. # 错误
  4. if () {
  5. return false;
  6. } else {
  7. return true;
  8. }
  9. # 正确
  10. if () {
  11. return false;
  12. }
  13. return true;

6、变量规范,使用英文命名

  1. <?php
  2. # 正确
  3. $title = '标题';
  4. $name = '名称';
  5. $pwd = '密码';
  6. # 错误
  7. $biaoti = '标题';
  8. $ming = '名称';
  9. $mima = '密码';

7、命名规范

  1. <?php
  2. /**
  3. * 实际开发中,命名方式一般有三种情况
  4. * 注意:不管是类名,变量,方法名,在实际开发中,最多只能是不超过3个单词的组合
  5. * 大驼峰 :每个单词首字母大写
  6. * 小驼峰 :中间单词首字母大写
  7. * 蛇形 :每个单词小写,单词与单词之间使用 _ 符合链接
  8. */
  9. # 大驼峰,常用于类名定义
  10. class Car{}
  11. class BlueCar{}
  12. # 小驼峰,常用于方法名定义
  13. class Car{
  14. public function getColor(){}
  15. }
  16. # 蛇形,常用于变量名定义
  17. $res_id = 1;
  18. $res_name = 2;

8、注释风格

  1. <?php
  2. 1、当需要对某段代码,做大量描述时,使用以下注释风格
  3. /**
  4. * 我是说明
  5. * ① 流程一
  6. * ② 流程二
  7. * ③ 流程三
  8. */
  9. 2、当需要对一行代码,做小量描述时,使用以下注释风格
  10. # 这是XXXX给ZZZZ的变量,叫CCCC
  11. $name = '';
  12. 3、当需要对一行代码,做简介描述时,使用以下注释风格
  13. $name = ''; // X表的字段
  14. $index_head = ''; // 首页请求头

9、开放关闭原则

  1. 实际上这是一个概念,是设计模式中的一种。
  2. 简单来说,就是一个已经完成上线的class或者api,可以在不改动起原文件的情况下,对其功能进行外部扩展。
  3. 当然,这一点不是一个初级程序员能够做到的事情,有兴趣的朋友可以看下博客里的设计模式,对逻辑思维的提升,在初期会有不少的帮助。