psr php标准规范,PHP PSR 标准规范速览

PSR-1 基础编码规范

PHP 代码文件 必须 以 <?php 或 <?= 标签开始；

PHP 代码文件 必须 以 不带 BOM 的 UTF-8 编码；

PHP 代码中 应该 只定义类、函数、常量等声明，或其他会产生 副作用 的操作(如：生成文件输出以及修改 .ini 配置文件等)，二者只能选其一；

命名空间以及类 必须 符合 PSR 的自动加载规范： [PSR-0(已废弃)或 PSR-4] 中的一个。

类的命名 必须 遵循 StudlyCaps 大写开头的驼峰命名规范；

类中的常量所有字母都 必须 大写，单词间用下划线分隔；

方法名称 必须 符合 camelCase 式的小写开头驼峰命名规范。

PSR-2 编码风格规范

代码 必须 遵循 [PSR-1] 中的编码规范 。

代码 必须 使用 4 个空格符而不是「Tab 键」进行缩进。

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

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

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

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

类的属性和方法 必须 添加访问修饰符(private、protected 以及 public)，abstract 以及 final 必须 声明在访问修饰符之前，而 static 必须 声明在访问修饰符之后。

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

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

控制结构的开始圆括号(()后和结束圆括号())前，都 一定不可 有空格符。

PSR-4 自动加载规范

PSR-4 描述了从文件路径中 自动加载 类的规范。 它拥有非常好的兼容性，并且可以在任何自动加载规范中使用，包括 PSR-0。 PSR-4 规范也描述了放置 autoload 文件(就是我们经常引入的 vendor/autoload.php)的位置。

规范

术语「class」指的是类(classes)、接口(interfaces)、特征(traits)和其他类似的结构。

全限定类名具有以下形式：

\(\)*\

全限定类名必须拥有一个顶级命名空间名称，也称为供应商命名空间(vendor namespace)。

全限定类名可以有一个或者多个子命名空间名称。

全限定类名必须有一个最终的类名(我想意思应该是你不能这样 \(\)*\ 来表示一个完整的类)。

下划线在全限定类名中没有任何特殊含义(在 PSR-0 中下划是有含义的)。

全限定类名可以是任意大小写字母的组合。

所有类名的引用必须区分大小写。

全限定类名的加载过程

在全限定的类名(一个「命名称空间前缀」)中，一个或多个前导命名空间和子命名空间组成的连续命名空间，不包括前导命名空间的分隔符，至少对应一个「根目录」。

「名称空间前缀」后面的相邻子命名空间与根目录下的目录名称相对应(且必须区分大小写)，其中名称空间的分隔符表示目录分隔符。

最终的类名与以.php 结尾的文件名保持一致，这个文件的名字必须和最终的类名相匹配(意思就是如果类名是 FooController，那么这个类所在的文件名必须是 FooController.php)。

自动加载文件禁止抛出异常，禁止出现任何级别的错误，也不建议有返回值。