基于php编程规范(详解)
今天写这个是为了提醒自己编程过程不仅要有逻辑思想还有要规范代码这样可读性
1、PHP编程规范与编码习惯最主要的有以下几点:
1文件说明
2function函数体说明
3代码缩进
4if省略
5变量规范
6命名规范
7十行一注释
8注释风格
9开放关闭原则
2、文件说明个人代码-规范如下:
/* +---------------------------------------------------------------------- +Title:标题 +Author:作者 +Version:版本号 +Initial-Time:这个文件初始创建的时间 +Last-time:这个文件最后修改的时间+修改人的名称 +Desc:这个文件的简单描述 +---------------------------------------------------------------------- */
3、Function函数体说明:
/**
*函数体简单的描述
*@author_start:作者
*@author_end:修改时间+修改者
*@paramstring:$id描述
*@paramarray:$array描述
*@paramarray:$num描述
*@return:返回值说明
*/
functionTest($id,$array=array(),$num=1){
}
注意:Function里面变量参数的代码缩进风格
4、代码缩进:
$str=1;
$info='123';
$version='123123';
$name='test';
$i='haha';
#一般在最外部的if或流程控制语句都应该上下留空一行
if($info){
}
#一般在最外部的for或者foreach都应该上下留空一行
for($i=0,$i<6,$i++){
}
5、IF省略
#一般在if语句与其分支的流程控制语句当中,存在这exit或者return的情况下,都应该省略其else的部分操作
#错误
if(){
returnfalse;
}else{
returntrue;
}
#正确
if(){
returnfalse;
}
returntrue;
6、变量规范,使用英文命名
#正确 $title='标题'; $name='名称'; $pwd='密码'; #错误 $biaoti='标题'; $ming='名称'; $mima='密码';
7、命名规范
/**
*实际开发中,命名方式一般有三种情况
*注意:不管是类名,变量,方法名,在实际开发中,最多只能是不超过3个单词的组合
*大驼峰:每个单词首字母大写
*小驼峰:中间单词首字母大写
*蛇形:每个单词小写,单词与单词之间使用_符合链接
*/
#大驼峰,常用于类名定义
classCar{}
classBlueCar{}
#小驼峰,常用于方法名定义
classCar{
publicfunctiongetColor(){}
}
#蛇形,常用于变量名定义
$res_id=1;
$res_name=2;
9、注释风格
1、当需要对某段代码,做大量描述时,使用以下注释风格 /** *我是说明 *①流程一 *②流程二 *③流程三 */ 2、当需要对一行代码,做小量描述时,使用以下注释风格 #这是XXXX给ZZZZ的变量,叫CCCC $name=''; 3、当需要对一行代码,做简介描述时,使用以下注释风格 $name='';//X表的字段 $index_head='';//首页请求头
10、开放关闭原则
实际上这是一个概念,是设计模式中的一种。
简单来说,就是一个已经完成上线的class或者api,可以在不改动起原文件的情况下,对其功能进行外部扩展。
以上这篇基于php编程规范(详解)就是小编分享给大家的全部内容了,希望能给大家一个参考,也希望大家多多支持毛票票。