PHP编码规范的深入探讨


Posted in PHP onJune 06, 2013

缩进与空白字符(Indenting and Whitespace)
使用 2 个空格而不使用 tab 键进行代码缩进(notepad++, Eclipse 等编辑器均支持此项配置);
行尾不应该有空白字符
应使用 \n (Unix换行符),而不是 \r\n (Windows 换行符)
所有文件均应以一个空行结尾

运算符(Operators)
所有二元运算符(二个值之间的运算符),如 +, -, =, !=, ==, > 等等,在运算符两端均需留有一个空格,如应该使用 $foo = $bar 而不是 $foo=$bar。
所有一元运算符(只操作一个值班的运算符),例如 ++,在值与运算符之间则不应加入空格

转型(Casting)
在 (type) 与要转型的变量之间应加入一个空格,如 (int) $mynumber.
控制结构(Control Structures)
控制结构包含 if, for, while, switch 等等,下面是一个简单的 if 语句结构示例:

if (condition1 || condition2) {
  action1;
}
elseif (condition3 && condition4) {
  action2;
}
else {
  defaultaction;
}

(Note: 不要使用 "else if" -- 总是使用 elseif.)
控制语句的关键词与左边括号之间应该有一个空格,以此来与函数调用进行区分。
即使在大括号是可选的情况下,也应当总是使用大括号。这样可以加强代码的可读性以及减少因嵌套带来的逻辑错误。
switch 语句结构示例:
switch (condition) {
  case 1:
    action1;
    break;
  case 2:
    action2;
    break;
  default:
    defaultaction;
}
do-while 语句结构示例:
do {
  actions;
} while ($condition);

行长度与封装(Line length and wrapping)
通常情况下,每行代码的长度不应超过80个字符
以下情况,行长度可超过80个字符:当行内包含过长的函数名称、函数/类定义、变量声明等
为方便阅读和理解,控制结构的行长度可超过80个字符
  if ($something['with']['something']['else']['in']['here'] == 
mymodule_check_something($whatever['else'])) {
    ...
  }
  if (isset($something['what']['ever']) && $something['what']['ever'] > $infinite 
&& user_access('galaxy')) {
    ...
  }
  // Non-obvious conditions of low complexity are also acceptable, but should
  // always be documented, explaining WHY a particular check is done.
  if (preg_match('@(/|\\)(\.\.|~)@', $target) && strpos($target_dir, $repository) 
!== 0) {
    return FALSE;
  }

控制条件(condition)不应该写作多行
控制条件应该适当拆分以便于阅读和理解,编写代码时要避免以下情形:
// DON'T DO THIS!
if ((isset($key) && !empty($user->uid) && $key == $user->uid) || (isset($user-
>cache) ? $user->cache : '') == ip_address() || isset($value) && $value >= time()))
{
  ...
}

将控制条件进行拆分,不仅便于阅读,同时也方便添加注释让人知道为何进行这样的条件判断
// Key is only valid if it matches the current user's ID, as otherwise other
// users could access any user's things.
$is_valid_user = (isset($key) && !empty($user->uid) && $key == $user->uid);
// IP must match the cache to prevent session spoofing.
$is_valid_cache = (isset($user->cache) ? $user->cache == ip_address() : FALSE);
// Alternatively, if the request query parameter is in the future, then it
// is always valid, because the galaxy will implode and collapse anyway.
$is_valid_query = $is_valid_cache || (isset($value) && $value >= time());
if ($is_valid_user || $is_valid_query) {
  ...
}

函数调用(Function Calls)
调用函数时,函数名与左括号之间没有空格,除最后一个参数外,每个参数后的 , 都应跟上一个空格,如:
$var = foo($bar, $baz, $quux);
如之前所说,等号两边应该各有一个空格。当有一系列相关语句时,出于可读性的考虑,可以适当增加空格的数量,如:
$short         = foo($bar);
$long_variable = foo($baz);

函数声明(Function Declarations)
包含默认值的参数应当放在最后,当函数拥有返回值时,尽量返回便于理解的值:

function funstuff_system($field) {
  $system["description"] = t("This module inserts funny text into posts randomly.");
  return $system[$field];
}

类构造器调用(Class Constructor Calls)
当调用不带参数的类构造器时,始终包含括号
$foo = new MyClassName();

带参数的类构造器
$foo = new MyClassName($arg1, $arg2);
如果使用变量做为类名,需先为变量赋值,然后才调用类构造器:

$bar = 'MyClassName';
$foo = new $bar();
$foo = new $bar($arg1, $arg2);

数组(Array)
数组的值之间应使用空格分隔,赋值操作符号(=>)左右也应包含空格:
$some_array = array('hello', 'world', 'foo' => 'bar');
当声明数组的字符长度超过80个字符(通常在构造表单和菜单时),应该将各元素分行、缩进编写:
$form['title'] = array(
  '#type' => 'textfield',
  '#title' => t('Title'),
  '#size' => 60,
  '#maxlength' => 128,
  '#description' => t('The title of your node.'),
);

注意:最后一个数组元素末尾有一个逗号,这并不是手误,而是避免有新元素加入到最后之后因缺少逗号而出现解析错误。(从某种程度上来讲,在最后一个数组元素末尾加上逗号是一种推荐的做法,甚至在向drupal.org提交代码时,一些代码规范检测脚本会因为最后一个元素没有添加逗号而出现警告提示。)

引号(Quotes)
Drupal 对于单引号和双引号的使用并没有很强硬的标准,只需在同一模块内保持用法的统一即可。
使用单引号的效率要高于双引号,因为解析器不需要到引号之间查找变量。以下是使用双引号的两种情况:
引号中间带有变量,如"<h2>$header</h2>"
引号中间带有单引号,使用双引号可避免对单引号的转义 "He's a good person." 当然也可以使用单引号,但 .pot 解析器不能很好的处理这种情况,而且看起来怪怪的'He\'s a good person.'

字符串连接(String Concatenations)
在点与要连接字符串之间需要加入空格以加强代码可读性:
如果只是简单地连接变量,可以使用双引号
使用连接赋值符(.=)时,需要在符号两侧预留空格

注释(Comment)
注释规范单独在 Doxygen及注释格式规范页面 讨论

引入代码(Including Code)
任何无条件引用文件的情况下,使用 require_once(), 任何有条件引用文件的情况,则使用 include_once(). 这两条语句都会保证文件只被引入一次。
当从当前目录或子目录引入代码时,始终以点路径开头
include_once ./includes/mymodule_formatting.inc
在 Drupal 7 及更新版本中,使用 DRUPAL_ROOT 常量:
require_once DRUPAL_ROOT . '/' . variable_get('cache_inc', 'includes/cache.inc');
PHP 代码标签(PHP Code Tags)
始终使用<?php ?>来界定PHP代码而不使用要<? ?>。这是为了遵循Drupal规范,同时也便于代码在其它系统和平台中被引用。
自 Drupal 4.7 开始,最后的 ?> 都故意被忽略不写,原因如下:
移除它可以避免在文件末尾出现空白字符,这些空白字符可能导致“文件头已发送(header already sent)”错误,XHTML/XML验证错误,及其它问题
PHP 官方说明 结尾的PHP界定符是可选项
PHP.net 自身也移除了文件末尾的界定符(如 prepend.inc )

分号(Semicolons)
PHP 语言要求除了代码块以外,大多数行尾都要跟上分号。Drupal 代码规范同样有此要求,并且对于代码块也是如此。以下是一个单行代码块的示例:
 -- YES
 -- NO
示例 URL(Example URL)
使用 example.com 表示所有示例 URLs
命名规范(Naming Conventions)
函数与变量(Functions and Variables)
函数与变量名称应该使用小写字母,且单词之间使用下划线分隔。函数应该使用模块组/模块名称作为前缀,以避免与不同模块间的冲突。
持久变量(Persistent Variables)
持久变量是指通过 variable_get()/variable_set() 函数取得和设置的变量,变量名称应该使用小写字母,且单词之间使用下划线进行分隔。持久变量也应该使用模块组/模块名称作为前缀,以避免与不同模块间的冲突。

常量(Constants)
常量始终要求使用全大写字母,且单词之间使用下划线进行分隔。(包括PHP内置常量 TRUE, FALSE, NULL)
模块中定义的常量需始终使用大写的模块名称作为前缀。
在 Drupal 8 及之后,应使用 const 关键词代替 define() 函数来定义常量,因为效率更高
注意 const 不能用于PHP表达式,因此在条件判断和非字面值(non-literal value ???)时,还是应当使用 define() 函数

全局变量(Global Variables)
定义全局变量时,应当使用下划线加模块/主题名称开头
类(Class)
类名应使用驼峰式命名(即单词首字母大写)

类中的方法(函数)和属性(成员变量)应使用首字母小写的驼峰式

定义访问权限时,使用 protected 而代替 private,从而其它的类可以在必要时扩展和更新方法。Protected 和 public 函数和变量不应以下划线开头。
更多关于 面向对象的编码规范
文件名(Filename)
所有文档文件都应加上 .txt 后缀,以便于 Windows 用户查看。同时,所有文件名称应该全部大写,而文件后缀应该全部小写。
如 README.txt, INSTALL.txt, TODO.txt, CHANGELOG.txt 等等。

辅助模块及工具
Coder 模块:可以遵循部分以上代码规范,对代码进行审查及修改建议
Drupal Code Sniffer :代码规范检测工具
PAReview.sh :还处理沙盒中的代码规范检测脚本,几乎严格遵守以上所有代码规范并给出修改建议。

PHP 相关文章推荐
第十节--抽象方法和抽象类
Nov 16 PHP
一步一步学习PHP(2)――PHP类型
Feb 15 PHP
php下清空字符串中的HTML标签的代码
Sep 06 PHP
php数组函数序列之array_unique() - 去除数组中重复的元素值
Oct 29 PHP
php计算十二星座的函数代码
Aug 21 PHP
thinkphp的URL路由规则与配置实例
Nov 26 PHP
php计算两个文件相对路径的方法
Mar 14 PHP
php提交表单发送邮件的方法
Mar 20 PHP
php中使用sftp教程
Mar 30 PHP
PHP实现的购物车类实例
Jun 17 PHP
如何使用纯PHP实现定时器任务(Timer)
Jul 31 PHP
Yii2创建控制器(createController)方法详解
Jul 23 PHP
PHP输出XML到页面的3种方法详解
Jun 06 #PHP
PHP转换文件夹下所有文件编码的实现代码
Jun 06 #PHP
利用PHP实现图片等比例放大和缩小的方法详解
Jun 06 #PHP
PHP删除目录及目录下所有文件的方法详解
Jun 06 #PHP
解决PHP超大文件下载,断点续传下载的方法详解
Jun 06 #PHP
探讨PHP函数ip2long转换IP时数值太大产生负数的解决方法
Jun 06 #PHP
php IP转换整形(ip2long)的详解
Jun 06 #PHP
You might like
php 魔术方法使用说明
2009/10/20 PHP
PHP 解决utf-8和gb2312编码转换问题
2010/03/18 PHP
纯php打造的tab选项卡效果代码(不用js)
2010/12/29 PHP
php中获取指定IP的物理地址的代码(正则表达式)
2011/06/23 PHP
浅析php中json_encode()和json_decode()
2014/05/25 PHP
php简单判断文本编码的方法
2015/07/30 PHP
PHP的命令行命令使用指南
2015/08/18 PHP
PHP中加速、缓存扩展的区别和作用详解(eAccelerator、memcached、xcache、APC )
2016/07/09 PHP
PHP实现与java 通信的插件使用教程
2019/08/11 PHP
JScript中的&quot;this&quot;关键字使用方式补充材料
2007/03/08 Javascript
javascript:文字不间断向左移动的实例代码
2013/08/08 Javascript
jquery给图片添加鼠标经过时的边框效果
2013/11/12 Javascript
关于Javascript作用域链的八点总结
2013/12/06 Javascript
简介AngularJS的视图功能应用
2015/06/17 Javascript
jquery插件jquery.nicescroll实现图片无滚动条左右拖拽的方法
2015/08/10 Javascript
解析AngularJS中get请求URL出现的跨域问题
2016/12/01 Javascript
详解nodejs 配置文件处理方案
2019/01/02 NodeJs
Vue实现点击显示不同图片的效果
2019/08/10 Javascript
使用Easyui实现查询条件的后端传递并自动刷新表格的两种方法
2019/09/09 Javascript
微信小程序之滑动页面隐藏和显示组件功能的实现代码
2020/06/19 Javascript
如何通过JS实现日历简单算法
2020/10/14 Javascript
[34:10]Secret vs VG 2019国际邀请赛淘汰赛 败者组 BO3 第二场 8.24
2019/09/10 DOTA
python实现批量监控网站
2016/09/09 Python
python机器学习理论与实战(二)决策树
2018/01/19 Python
Python 使用PyQt5 完成选择文件或目录的对话框方法
2019/06/27 Python
关于python3.7安装matplotlib始终无法成功的问题的解决
2020/07/28 Python
NUK奶瓶美国官网:NUK美国
2016/09/26 全球购物
诗狄娜化妆品官方网站:Stila Cosmetics
2016/12/21 全球购物
销售找工作求职信
2013/12/20 职场文书
咖啡蛋糕店创业计划书
2014/01/28 职场文书
代理班主任的自我评价
2014/02/04 职场文书
计算机专业职业规划
2014/02/28 职场文书
军训教官感言
2014/03/02 职场文书
三月学雷锋月活动总结
2014/04/28 职场文书
观看建国大业观后感
2015/06/01 职场文书
golang通过递归遍历生成树状结构的操作
2021/04/28 Golang