PSR-2 代码风格规范
https://blog.csdn.net/qq_28602957/article/details/52248239
这篇规范是PSR-1(基本代码规范)的扩展和继承。
本规通过制定一系列规范化PHP代码的规则,以减少在浏览不同作者的代码时,因代码风格的不同而造成不便。
这个风格规范是从各种各样的项目的共性中延伸出来的。当多名程序员在多个项目中合作时,它有助于有一套准则,在所有的项目中使用。
因此,本指南的好处不是在规则本身,而是在这些规则的共享。
关键词 “必须”(“MUST”)、“一定不可/一定不能”(“MUST NOT”)、“需要”(“REQUIRED”)、
“将会”(“SHALL”)、“不会”(“SHALL NOT”)、“应该”(“SHOULD”)、“不该”(“SHOULD NOT”)、
“推荐”(“RECOMMENDED”)、“可以”(“MAY”)和”可选“(“OPTIONAL”)的详细描述可参见 RFC 2119
1.概览
- 代码必须遵循PSR-1基本代码规范。
- 代码必须使用四个空格符进行缩进,而不是一个tab键。
- 每行应该保持在80个字符以内,软限制必须是120个字符,但一定不能有硬性限制。
- 每个
namespace
命名空间声明语句和use
声明语句块后面,必须有一个空白行。 - 类的开始花括号(
{
)必须写在函数声明后自成一行,结束花括号(}
)也必须写在函数主体后自成一行。 - 方法的开始花括号(
{
)必须写在函数声明后自成一行,结束花括号(}
)也必须写在函数主体后自成一行。 - 在所有的属性和方法上都必须声明可见性(译者注:
private
,protected
以及public
);abstract
和final
必须声明在可见性之前;static
必须声明在可见性之后。 - 控制结构的关键词后面必须有一个空格符,方法和函数调用一定不能有。
- 控制结构的开始花括号(
{
)必须写在声明的同一行,而结束花括号(}
)必须写在主体后自成一行。 - 控制结构的开始左括号(
{
)之后一定不能有空格,右括号(}
)之前一定不能有空格。
1.1 例子
以下这个例子简单的展示了以上的大部分规范。
<?php
namespace Vendor\Package;
use FooInterface;
use BarClass as Bar;
use OtherVendor\OtherPackage\BazClass;
class Foo extends Bar implements FooInterface
{
public function sampleFunction($a, $b = null)
{
if ($a === $b) {
bar();
} elseif ($a > $b) {
$foo->bar($arg1);
} else {
BazClass::bar($arg2, $arg3);
}
}
final public static function bar()
{
// method body
}
}
2. 通则
2.1 基本编码规范
代码必须符合PSR-1的所有规范
2.2 文件
所有PHP文件必须使用Unix LF (linefeed)
作为行的结束符。
所有PHP文件必须以一个空白行结束。
纯PHP代码文件必须省略最后的 ?> 结束标签。
2.3 行
行的长度一定不能有硬性的约束。
行长度的软性约束一定限制在120个字符以内;如果超过此长度,代码规范检查器必须发出警告,一定不能报错。
每行不应该超过80个字符;超过80个字符的行,应该被拆分成多个不超过80个字符的后续行。
在非空白行的后面一定不能有多余的空格符。
空行可以用来改善可读性和区分相关的代码块。
每行一定不能多余一条语句。
2.4 缩进
代码必须使用四个空格符缩进,一定不能使用tab键。
备注:只用空格,不于tab混合使用,有助于避免代码差异、打补丁、重阅代码以及注释时产生混淆。使用空格还可以使调整细微的缩进来改变对齐变得简单。
2.5 关键字和True/False/Null
PHP关键字必须全部小写。
PHP常量true,false和null**必须**全部小写。
3. 命名空间以及Use声明
存在命名空间时,其后面必须有一个空白行。
所有的use,必须在命名空间后声明。
每条use
声明语句,必须只有一个use
关键字。
use
声明语句块后面必须有一个空白行。
例如:
<?php
namespace Vendor\Package;
use FooClass;
use BarClass as Bar;
use OtherVendor\OtherPackage\BazClass;
// ... additional PHP code ...
4. 类、属性和方法
此处的“类”泛指所有的class类、接口以及traits可复用代码块。
4.1 扩展和继承
关键词extends
和implements
必须和类名在同一行。
类开始的花括号({
)必须独占一行,类结束的花括号(}
)必须在类主体后独占一行。
<?php
namespace Vendor\Package;
use FooClass;
use BarClass as Bar;
use OtherVendor\OtherPackage\BazClass;
class ClassName extends ParentClass implements \ArrayAccess, \Countable
{
// constants, properties, methods
}
implements
的接口列表也可以分成多行,当这样做时,列表中的第一个接口必须放在下一行中,每行必须只有一个接口
<?php
namespace Vendor\Package;
use FooClass;
use BarClass as Bar;
use OtherVendor\OtherPackage\BazClass;
class ClassName extends ParentClass implements
\ArrayAccess,
\Countable,
\Serializable
{
// constants, properties, methods
}
4.2 属性
所有属性都必须声明可见性。
一定不能使用关键字var
声明一个属性。
每条语句一定不能定义超过一个属性。
属性名称不应该以单个下划线作为前缀来表示属性是protected
或private
。
一个属性的声明应该像下面这样。
<?php
namespace Vendor\Package;
class ClassName
{
public $foo = null;
}
4.3 方法
所有方法都必须声明可见性(访问修饰符)。
方法名称不应该以单个下划线作为前缀来表示是protected
或private
。
方法名称后一定不能有空格符,其开始花括号必须独占一行,结束花括号也必须在方法主体后单独成一行。参数左括号后和右括号前一定不能有空格。
一个方法定义应该像下面这样,注意括号,逗号,空格和花括号的位置:
<?php
namespace Vendor\Package;
class ClassName
{
public function fooBarBaz($arg1, &$arg2, $arg3 = [])
{
// method body
}
}
4.4 方法参数
在参数列表中,每个逗号之前一定不能有空格,每个逗号之后必须有一个空格。
方法参数中,有默认值的,必须放到参数列表的末尾。
<?php
namespace Vendor\Package;
class ClassName
{
public function foo($arg1, &$arg2, $arg3 = [])
{
// method body
}
}
参数列表可以被拆分成分别有一次缩进的多行,这样,列表中的第一项必须放在下一行,每一行必须只放一个参数。
拆分成多行的参数列表后,结束括号以及方法开始花括号必须写在同一行,中间用一个空格分隔,一起自成一行。
<?php
namespace Vendor\Package;
class ClassName
{
public function aVeryLongMethodName(
ClassTypeHint $arg1,
&$arg2,
array $arg3 = []
) {
// method body
}
}
4.5 abstract
,final
和static
当存在时,abstract
和final
声明必须放在可见性之前。
当存在时,static
声明必须放在可见性后。
<?php
namespace Vendor\Package;
abstract class ClassName
{
protected static $foo;
abstract protected function zim();
final public static function bar()
{
// method body
}
}
4.6 方法和函数调用
方法及函数调用时,方法名或函数名与左括号之间一定不能有空格,参数右括号前也一定不能有空格。在参数列表中,每个逗号之前一定不能有空格,每个逗号之后必须有一个空格。
<?php
bar();
$foo->bar($arg1);
Foo::bar($arg2, $arg3);
参数可以被拆分成多个有一个缩进的后续行,如果这么做,参数列表中的第一个必须放在下一行,并且每一行只能有一个参数。
<?php
$foo->bar(
$longArgument,
$longerArgument,
$muchLongerArgument
);
5. 控制结构
控制结构基本样式规范如下:
- 控制结构关键词后必须有一个空格。
- 左括号
(
后面一定不能有空格。 - 右括号
)
前一定不能有空格。 - 右括号
)
和开始花括号{
之间必须有一个空格。 - 结构体必须缩进一次。
- 结束花括号
}
必须在主体后自成一行。
每个结构体的主题都必须被包含在成对的花括号中,这使结构体看起来更加规范以及减少加入新行时,出错的可能性。。
5.1 if
,elseif
,else
一个if的结构如下所示。注意其括号、空格以及花括号的位置,并且else
和elseif
和前一个主体的结束花括号}
在同一行。
<?php
if ($expr1) {
// if body
} elseif ($expr2) {
// elseif body
} else {
// else body;
}
应该使用elseif
代替else if
,使得所有的控制关键词看起来像一个单词。
5.2 switch
和case
一个switch
结构如下所示。注意其括号、空格以及花括号的位置。case
语句必须相对于switch
进行一次缩进,break
关键字(或其他终止关键字)必须和case
主体缩进同级。如果存在一个非空的case
直穿语句,则必须有一个类似// no break
的注释。
<?php
switch ($expr) {
case 0:
echo 'First case, with a break';
break;
case 1:
echo 'Second case, which falls through';
// no break
case 2:
case 3:
case 4:
echo 'Third case, return instead of break';
return;
default:
echo 'Default case';
break;
}
5.3 while
,do while
一个while
语句如下所示。注意其括号、空格以及花括号的位置。
<?php
while ($expr) {
// structure body
}
同样,一个do while
语句如下所示。注意其括号、空格以及花括号的位置。
<?php
do {
// structure body;
} while ($expr);
5.4 for
一个for
语句看起来像下面这个样子。注意其括号、空格以及花括号的位置。
<?php
for ($i = 0; $i < 10; $i++) {
// for body
}
5.5 foreach
一个foreach
语句看起来像下面这样。注意其括号、空格以及花括号的位置。
<?php
foreach ($iterable as $key => $value) {
// foreach body
}
5.6 try
,catch
一个try catch
语句块看起来像下面这样。注意其括号、空格以及花括号的位置。
<?php
try {
// try body
} catch (FirstExceptionType $e) {
// catch body
} catch (OtherExceptionType $e) {
// catch body
}
6. 闭包
闭包声明时,关键词function
后以及关键词use
的前后都必须有一个空格。
开始的花括号{
必须写在声明的同一行,结束的花括号}
必须紧跟在主体的下一行。
参数列表和变量列表的左括号后(
以及右括号)
前,一定不能有空格。
参数列表和变量列表中,逗号前一定不能有空格,逗号后必须有空格。
闭包带默认值的参数必须放在参数列表后面。
一个闭包声明看起来像下面这个样子。注意其括号、逗号、空格以及花括号的位置。
<?php
$closureWithArgs = function ($arg1, $arg2) {
// body
};
$closureWithArgsAndVars = function ($arg1, $arg2) use ($var1, $var2) {
// body
};
参数和变量列表可以被拆分成多个有一次缩进的后续行,这样,列表中的第一个必须放在下一行并且每一行必须只有一个参数或变量。
当最终(无论是参数列表还是变量列表)被分成多行时,有括号)
和左或括号{
必须在他们中间隔一个空格,放在一起,自成一行。
以下几个闭包的例子,包含了参数和变量列表被分成多行的多情况。
<?php
$longArgs_noVars = function (
$longArgument,
$longerArgument,
$muchLongerArgument
) {
// body
};
$noArgs_longVars = function () use (
$longVar1,
$longerVar2,
$muchLongerVar3
) {
// body
};
$longArgs_longVars = function (
$longArgument,
$longerArgument,
$muchLongerArgument
) use (
$longVar1,
$longerVar2,
$muchLongerVar3
) {
// body
};
$longArgs_shortVars = function (
$longArgument,
$longerArgument,
$muchLongerArgument
) use ($var1) {
// body
};
$shortArgs_longVars = function ($arg) use (
$longVar1,
$longerVar2,
$muchLongerVar3
) {
// body
};
注意:如果闭包在函数或方法中当做一个参数直接调用时,以上规则仍然适用。
<?php
$foo->bar(
$arg1,
function ($arg2) use ($var1) {
// body
},
$arg3
);
7. 结论
有许多元素的风格和实践在本指南中被故意忽略掉。这些包括但不限于:
- 全局变量和常量的定义
- 函数的定义
- 操作符和赋值
- 行内对齐
- 注释和文档描述块
- 类名的前缀及后缀
- 最佳实践
未来的建议可能会修改和扩展本指南,以解决这些或其他元素的风格和实践。
PSR-2 代码风格规范的更多相关文章
- 【PSR规范专题(3)】PSR-2 代码风格规范
[PSR规范专题(3)]PSR-2 代码风格规范 标签(空格分隔): PHP 转载自:https://github.com/PizzaLiu/PHP-FIG/blob/master/PSR-2-cod ...
- PHP PSR-2 代码风格规范 (中文版)
代码风格规范 本篇规范是 PSR-1 基本代码规范的继承与扩展. 本规范希望通过制定一系列规范化PHP代码的规则,以减少在浏览不同作者的代码时,因代码风格的不同而造成不便. 当多名程序员在多个项目中合 ...
- PHP PSR-2 代码风格规范
代码风格规范 本篇规范是 PSR-1 基本代码规范的继承与扩展. 本规范希望通过制定一系列规范化PHP代码的规则,以减少在浏览不同作者的代码时,因代码风格的不同而造成不便. 当多名程序员在多个项目中合 ...
- Python 代码风格规范(Google)
Python风格规范 分号 tip 不要在行尾加分号, 也不要用分号将两条命令放在同一行. 行长度 tip 每行不超过80个字符 例外: 长的导入模块语句 注释里的URL 不要使用反斜杠连接行. Py ...
- .net 代码风格规范
声明:内容非原创,转自张子阳博客. 对于为什么是转载,唯一原因就是这东西居然比我整理的好,直接用得了. 1. C# 代码风格要求 1.1注释 类型.属性.事件.方法.方法参数,根据需要添加注释. 如果 ...
- .Net 项目代码风格规范
最近没啥时间自己状态也不是很好,公司的事情忙,自己也有一些事情要处理,所以好久没有写博客了.利用公司午休时间写一写,以下是参考了一些资料,整理出来,共勉之. 代码风格没有正确与否,重要的是整齐划一,清 ...
- PHP 权威代码风格规范
1.常规 尽量统一ide 比如phpstream 配置文件(Settings → Code Style → PHP → Set from... → Predefined Style → PSR1/PS ...
- Google的代码风格规范,各种语言都很全
https://code.google.com/p/google-styleguide/
- python代码风格规范
类注释模板: :: class AnotherClass: """ 类注释 """ def method(self, arg1, arg2, ...
随机推荐
- thinkphp 如何调用百度echarts 数据报表插件
echarts官网网址:http://echarts.baidu.com/ echarts源码地址:http://echarts.baidu.com/build/echarts-2.2.7.zip ...
- Spring Framework 官方文档学习(四)之Validation、Data Binding、Type Conversion
本篇太乱,请移步: Spring Framework 官方文档学习(四)之Validation.Data Binding.Type Conversion(一) 写了删删了写,反复几次,对自己的描述很不 ...
- 为什么选择使用Spring Cloud而放弃了Dubbo
为什么选择使用Spring Cloud而放弃了Dubbo 可能大家会问,为什么选择了使用Dubbo之后,而又选择全面使用Spring Cloud呢?其中有几个原因: 1)从两个公司的背景来谈:Dubb ...
- 【BZOJ】1675: [Usaco2005 Feb]Rigging the Bovine Election 竞选划区(暴力dfs+set判重)
http://www.lydsy.com/JudgeOnline/problem.php?id=1675 一开始我写了个枚举7个点....... 但是貌似... 写挫了. 然后我就写dfs.. 判重好 ...
- OEM无法启动:oracle/product/10.2.0/dbhome_1/oc4j/j2ee/OC4J_DBConsole_localhost.localdomain_orcl not found.
配置OEM环境变量 ORACLE_UNQNAME=$ORACLE_SID 要想打开OEM的web管理程序,必须先启动Database listener,再启动Datebase Control端口监控程 ...
- Sublime Text2.0.2注冊码
// Sublime Text 3 License Keys // Sublime Text 2.x -– BEGIN LICENSE -– Andrew Weber Single User Lice ...
- C语言基础之水仙花数
题目:打印出所有的“水仙花数”,所谓“水仙花数”是指一个三位数,其各位数字立方和等于该数本身. 例如:153是一个“水仙花数”,因为153=1的三次方+5的三次方+3的三次方. 程序分析:利用for循 ...
- Linux网络流量控制工具—Netem
第一篇:概念篇 Netem 是 Linux 2.6 及以上内核版本提供的一个网络模拟功能模块.该功能模块可以用来在性能良好的局域网中,模拟出复杂的互联网传输性能,诸如低带宽.传输延迟.丢包等等情况.使 ...
- phpcms替换类列表页,内容页,主页
phpcms替换类列表页,内容页,主页 利用phpcms制作企业站,首先要将静态的企业主页替换成后台可编辑的动态主页. 在phpcms/install_package/phpcms/templat ...
- 【BZOJ2037】[Sdoi2008]Sue的小球 区间DP+费用提前
[BZOJ2037][Sdoi2008]Sue的小球 Description Sue和Sandy最近迷上了一个电脑游戏,这个游戏的故事发在美丽神秘并且充满刺激的大海上,Sue有一支轻便小巧的小船.然而 ...