网站源码编码中文版.pdfVIP

文章(/blogs)光头哥(/blog/gtg)文章详情(/user

PHPPSR-2代码风格规范(中文版)(/a/1190000002521620)

光头哥(/u/gtg)7801月29日发布

推荐2推荐

收藏21收藏，2.2k浏览

代码风格规范

本篇规范是PSR-1()基本代码规范的继承与扩

展。

希望通过制定一系列规范化PHP代码的规则，以减少在浏览不同作者的代码时，因代码风格的

不同而造成不便。

当多名程序员在多个项目中合作时，就需要一个共同的编码规范，

而本文中的风格规范源自于多个不同项目代码风格的共同特性，

因此，的价值在于我们都遵循这个编码风格，而不是在于它本身。

“必须”(MUST)、“一定不可/一定不能”(MUSTNOT)、“需要”(REQUIRED)、

将会SHALL)、“不会”(SHALLNOT)、“应该”(SHOULD)、“不该”(SHOULDNOT)、

“推荐”(RECOMMENDED)、“可以”(MAY)和”可选“(OPTIONAL)的详细描述可参见[RFC2119]

[]。

1.概览

•代码必须遵循PSR-1()中的编码规范。

•代码必须使用4个空格符而不是tab键进行缩进。

•每行的字符数应该软性保持在80个之内，理论上一定不可多于120个，但一定不能有硬性限

制。

•每个namespace命名空间语句和use语句块后面，必须一个空白行。

•类的开始花括号({)必须写在函数后自成一行，结束花括号(})也必须写在函数主体后自成

一行。

•方法的开始花括号({)必须写在函数后自成一行，结束花括号(})也必须写在函数主体后自

成一行。

•类的属性和方法必须添加修饰符（private、protected以及public），以

及final必须在修饰符之前，而static必须在修饰符。(/user

•控制结构的关键字后必须要有一个空格符，而调用方法或函数时则一定不能有。

•控制结构的开始花括号({)必须写在的同一行，而结束花括号(})必须写在主体后自成一

行。

•控制结构的开始左括号后和结束右括号前，都一定不能有空格符。

1.1.例子

以下例子程序简单地展示了以上大部分规范：

update:因下面程序的?php标记影响样式故删除，请阅读的时候自动加上

namespaceVendor\Package;

useFooInterface;

useBarClassasBar;

useOtherVendor\OtherPackage\BazClass;

classFooextendsBarimplementsFooInterface

{

publicfunctionsampleFunction($a,$b=null)

{

if($a===$b){

bar();

}elseif($a$b){

$foo-bar($arg1);

}else{

BazClass::bar($arg2,$arg3);

}

}

finalpublicstaticfunctionbar()

{

//methodbody

}

}

2.通则

2.1基本编码准则

代码必须符合PSR-1()中的所有规范。