PSR-2 Coding Style Guide

本文主要是对PSR-2 的简单翻译. 英文源址 http://www.php-fig.org/psr/psr-2/

PSR2继承和扩展PSR1--基本编码规范

本手册的目的是使用一系列共同遵守的编码格式规范来减少不同开发者之间的认知冲突.

这些规则从众多项目中总结出来.当工程师们在不同的项目中合作时,这个规则帮助大家建立共识.规则的本身并不是优势,而是遵守规则所带来的理解便利.

关键字"MUST","MUST NOT" "SHOULD" "SHALL" 等参考RFC 2119.

OverView

1 必须遵循PSR1

2 使用4空格缩进,而不是tab

3 禁止每行长度硬限制.软限制每行120字符,实际每行应少于80字符

4 在namespace 声明和 use 声明之后必须有一空行

5 类的声明左花括号必须另起一行,右花括号必须在声明体结束另一一行

6 方法声明的花括号同上

7 所有的属性和方法必须声明可见性, abstract 和 final 必须声明在可见性之前,static 必须声明在可见性之后.  public static || final public || abstract protected

8 控制结构关键字 break ,continue , else 之后必须有一个空格,方法和函数一定不要.

9 else 等控制结构的开始花括号必须在同一行,结束花括号必须另起一行

10 开始的圆括弧之后需要有1个空格,结束的圆括弧之前不需要.