1、PHP 编程规范与编码习惯最主要的有以下几点:
1、文件说明
2、Function 函数体说明
3、代码缩进
4、IF省略
5、变量规范
6、命名规范
7、十行一注释
8、注释风格
9、开放关闭原则
2、文件说明 我的个人代码 - 规范如下:
<?php
/*
+----------------------------------------------------------------------
+ Title : 标题
+ Author : 作者
+ Version : 版本号
+ Initial-Time : 这个文件初始创建的时间
+ Last-time : 这个文件最后修改的时间 + 修改人的名称
+ Desc : 这个文件的简单描述
+----------------------------------------------------------------------
*/
3、function 函数体说明:
<?php
/**
* 函数体简单的描述
* @author_start : 作者
* @author_end : 修改时间 + 修改者
* @param string : $id 描述
* @param array : $array 描述
* @param array : $num 描述
* @return : 返回值说明
*/
function Test($id, $array = array(), $num = 1){
}
注意:function里面变量参数的代码缩进风格
4、代码缩进:
<?php
$str = 1;
$info = '123';
$version = '123123';
$name = 'test';
$i = 'haha';
# 一般在最外部的if 或流程控制语句都应该上下留空一行
if ($info) {
}
# 一般在最外部的for或者 foreach都应该上下留空一行
for ($i=0 ,$i<6 ,$i++){
}
5、if省略
<?php
# 一般在if语句与其分支的流程控制语句当中,存在这exit或者return的情况下,都应该省略其else的部分操作
# 错误
if () {
return false;
} else {
return true;
}
# 正确
if () {
return false;
}
return true;
6、变量规范,使用英文命名
<?php
# 正确
$title = '标题';
$name = '名称';
$pwd = '密码';
# 错误
$biaoti = '标题';
$ming = '名称';
$mima = '密码';
7、命名规范
<?php
/**
* 实际开发中,命名方式一般有三种情况
* 注意:不管是类名,变量,方法名,在实际开发中,最多只能是不超过3个单词的组合
* 大驼峰 :每个单词首字母大写
* 小驼峰 :中间单词首字母大写
* 蛇形 :每个单词小写,单词与单词之间使用 _ 符合链接
*/
# 大驼峰,常用于类名定义
class Car{}
class BlueCar{}
# 小驼峰,常用于方法名定义
class Car{
public function getColor(){}
}
# 蛇形,常用于变量名定义
$res_id = 1;
$res_name = 2;
8、注释风格
<?php
1、当需要对某段代码,做大量描述时,使用以下注释风格
/**
* 我是说明
* ① 流程一
* ② 流程二
* ③ 流程三
*/
2、当需要对一行代码,做小量描述时,使用以下注释风格
# 这是XXXX给ZZZZ的变量,叫CCCC
$name = '';
3、当需要对一行代码,做简介描述时,使用以下注释风格
$name = ''; // X表的字段
$index_head = ''; // 首页请求头
9、开放关闭原则
实际上这是一个概念,是设计模式中的一种。
简单来说,就是一个已经完成上线的class或者api,可以在不改动起原文件的情况下,对其功能进行外部扩展。
当然,这一点不是一个初级程序员能够做到的事情,有兴趣的朋友可以看下博客里的设计模式,对逻辑思维的提升,在初期会有不少的帮助。