更新时间:2018-03-16 来源:黑马程序员 浏览量:
编码规则采用常用规则就可,具体说哪一个好,哪一个不好也是不科学的,每种风格都有各自的好处,这得看系统,代码怎样容易阅读这才是王道。
最基本要求
以标准计算机英文为蓝本,杜绝一切拼音、或拼音英文混杂的命名方式。英语不好者,请借助网络上的翻译工具。
一、变量命名
(1)使用英文名词、动词,以大写字母作为单词的分隔,其他的字母均使用小写,单词的首个字母使用小写。如:
$repeatCount = '';
$delUserSql = '';
(2)变量命名如要用缩写,只能使用项目中有据可查的英文缩写方式,例如可以使用$data而不可使用$data1、$data2这样容易产生混淆的形式,应当使用$articleData、$userData这样一目了然容易理解的形式。
(3)除非特殊情况,一般不推荐使用下划线。如:$repeat_count = '';(不推荐)
二、数组变量命名
使用英文名词、动词,以大写字母作为单词的分隔,其他的字母均使用小写,单词的首个字母使用小写,不使用下划线,以字符串 Array 为后缀,例: $scopeArray = array(); $bookIdArray = array();
提示:
除非特殊情况,一般不推荐使用下划线。如:$book_id_array = array();(不推荐)
三、全局变量
全局变量应该带前缀‘g’, 使用大写字母作为词的分隔,其他的字母均使用小写。理由:知道一个变量的作用域是非常重要的。 例如: global $gLog;
四、全局常量命名
使用英文名词、动词,所有字母都使用大写,以下划线'_'分隔每个单词。这是命名全局常量的传统。例如:
define( 'WEBSITE_NAME', '名称' );
define( 'WEBSITE_URL', '地址' )
define("A_GLOBAL_CONSTANT", "Hello world!");
五、静态变量命名
第一种写法:静态变量应该带前缀‘s’,使用大写字母作为词的分隔,其他的字母均使用小写。理由:知道一个变量的作用域是非常重要的。 例如:
function test(){
static $sStatus = 0;
}
第二种写法:使用英文名词、动词,以大写字母作为单词的分隔,其他的字母均使用小写,单词的首个字母使用小写,不使用下划线,以字符串 Static 为后缀, 例如:
function getDirectoryFile(){
static $fileArrayStatic = '';
static $fileNumStatic = '';
...
}
function getDirectoryFile(){
static $fileArrayStatic = '';
static $fileNumStatic = '';
...
}
六、函数命名
函数名使用小写字母、下划线组合。如:get_client_ip().函数名字采用C语言的惯例,所有的字母使用小写字母,使用'_'分割单词。 这样可以更易于区分相关联的类名。
注意点1:不要把小括号和函数名紧贴在一起。 要用空格隔开它们。 如果小括号紧贴着函数名,二者很容易被看成是一体的。
例如:
function some_bloody_function () {
...
}
注意点2:除非必要,不要在Return返回语句中使用小括号。
七、类的命名规范
(1). 使用英文名词,类文件采用驼峰式写法。以大写字母作为词的分隔,其他的字母均使用小写,名词的首个字母使用大写,不使用下划线。
(2). 使用完整单词,避免缩写词(除非该缩写词被更广泛使用,像URL,HTML)
(3). 在为类命名前首先要知道它是什么。如果通过类名提供的线索,您还是想不起这个类是什么的话,那么您的设计是做得不够好。
(4). 超过三个单词组成的混合类名是容易造成系统各个实体间的混淆,请重新设计类名。
例如:
class UserAccount{
...
}
class PaintingOrder{
...
}
八、类文件命名规范
类的文件名与类的名字保持一致,包括大小写以“ .class.php”作为文件的后缀。 如:MyDb类保存的文件名称是MyDb.class.php,MySql类保存的文件名称是MySql.class.php,Page类保存的文件名是Page.class.php,UserName类保存的文件名称是:UserName.class.php 。
注意:正是由于类的文件名要与类的名字保持一致,所以一个php文件只能包含一个类定义编码。
九、类属性命名规范
使用英文名词、动词,以大写字母作为词的分隔,其他的字母均使用小写,对于类属性为某个对象变量,则以字符串 Object 为后缀,普通属性命名规范同变量的命名规范。如果是用于存储对象的属性,使用1个下划线开始。例如:
public $tableName = '';
private $databaseObject = '';
public $_username = NULL;
十、类方法命名规范
类中的方法可自行定义如下两种,
1)全部使用小写用下划线作为词的分隔 (get_file_content),
2)采用驼峰法,即以大写字母作为词的分隔,其他的字母均使用小写,
通常每个方法只执行一项逻辑动作事务,所以对它们的命名应该清楚的说明它们是做什么的:
如用checkEmailErrors()代替errorCheck(),用dumpDataToFile()代替dataFile()。这么做使功能和数据成为更可区分的物体。
十一、类方法参数命名
方法的参数的命名规范同变量的命名规范。
十二、类的实例对象的命名(对象变量命名)
类的实例对象的命名规范同变量的命名规范,只不过实例对象是以1个下划线开头的,同类中存储对象的属性的规范一样。
这样,无论是在类的内部,还是类的外部,只要是以下划线开头的变量,那就是对象名。(jQuery对象的命名规范与此一致。国外通用。) 例:
$_name = new UserName();
有的公司要求是 "变量名" + "_obj",如:$name_obj;
而有的公司则使用类名称为变量前缀,所有字母都使用大写,以字符串_OBJECT 为后缀,例如:
$USERNAME_OBJECT = new UserName();$PAINTINGORDER_OBJECT = new PaintingOrder();
十三、数据库命名
数据库表名所有字母都使用小写,使用'_'作为每个词的分界,数据字段命名也与数据表命名相同.
例如:
[hide]
cz_goods_attr(商品属性表)
cz_goods_type(商品类别表)
十四、模板文件名命名
所有字母都使用小写,使用'_'作为每个词的分界,这样做的好处是方便平移到其他的系统平台中,不会因为大小写而发生问题.
例如:
brand_add.html (品牌增加显示模版文件)
brand_list.html(品牌展示模版文件)
十五、文件名的命名规范
文件名使用英文名词、英文动词,以及下划线,所有字母都使用小写字母。例如: index.php、index_ad.html。
本文版权归黑马程序员PHP学院所有,欢迎转载,转载请注明作者出处。谢谢!
作者:黑马程序员PHP培训学院