PSR 是 php Standard Recommendations 的简写,由 PHP FIG 组织制定的 PHP 规范,是 PHP 开发的实践标准。
目前已表决通过了 6 套标准,已经得到大部分 PHP 框架的支持和认可。
- PSR-1:基础编码规范
- PSR-2:编码风格规范
- PSR-3:日志接口规范
- PSR-4:自动加载规范
- PSR-5:缓存接口规范
- PSR-7:HTTP 消息接口规范
PSR-1 基础编码规范
- PHP 代码文件 必须 以 <?php 或 <?= 标签开始;
- PHP 代码文件 必须 以 不带 BOM 的 UTF-8 编码;
- PHP 代码中 应该 只定义类、函数、常量等声明,或其他会产生 副作用 的操作(如:生成文件输出以及修改 .ini 配置文件等),二者只能选其一;
- 命名空间以及类 必须 符合 PSR 的自动加载规范:PSR-4 中的一个;
- 类的命名 必须 遵循 StudlyCaps 大写开头的驼峰命名规范;
- 类中的常量所有字母都 必须 大写,单词间用下划线分隔;
- 方法名称 必须 符合 camelCase 式的小写开头驼峰命名规范。
PSR-2 编码风格规范
- 代码 必须 遵循 PSR-1 中的编码规范 。
- 代码 必须 使用 4 个空格符而不是「Tab 键」进行缩进。
- 每行的字符数 应该 软性保持在 80 个之内,理论上 一定不可 多于 120 个,但 一定不可 有硬性限制。
- 每个 namespace 命名空间声明语句和 use 声明语句块后面,必须 插入一个空白行。
- 类的开始花括号({) 必须 写在类声明后自成一行,结束花括号(})也 必须 写在类主体后自成一行。
- 方法的开始花括号({) 必须 写在函数声明后自成一行,结束花括号(})也 必须 写在函数主体后自成一行。
- 类的属性和方法 必须 添加访问修饰符(private、protected 以及 public),abstract 以及 final 必须 声明在访问修饰符之前,而 static 必须 声明在访问修饰符之后。
- 控制结构的关键字后 必须 要有一个空格符,而调用方法或函数时则 一定不可 有。
- 控制结构的开始花括号({) 必须 写在声明的同一行,而结束花括号(}) 必须 写在主体后自成一行。
- 控制结构的开始左括号后和结束右括号前,都 一定不可 有空格符。
PSR-3 日志接口规范
- 日志接口提供了8个级别的日志方法包含(debug, info,notice,warning,error,critical,alert,emergency),log方法接受日志级别作为第一个参数
- 每一个方法都接受一个字符串作为一个描述,或者是实现了__toString()方法的类
- 每一个方法都接受一个数组类型的上下文数据
- PsrLogAbstractLogger是实现日志接口的好的方式,PsrLogLoggerTrait仅仅需要实现log方法,PsrLogNullLogger空日志接口,PsrLogLoggerAwareInterface可以wrApper一个logger,PsrLogLogLevel 包含8个日志级别
PSR-4 自动加载规范
- 适用于类、接口、traits和其他相似的结构
- 一个完全限定的类名具备如下结构 NamespaceNameSubNamespaceName*ClassName, 即包含顶级的命名空间 as a vendor namespace ,或许包含一个或者多个子命名空间,必须包含一个类名,下划线不再具有任何意义,类名大小写敏感。自动加载不能抛出异常,不报错,不返回任何值
PSR-7 HTTP 消息接口规范
- 包含PsrHttpMessageRequestInterface和PsrHttpMessageResponseInterface,这两个接口都是扩展PsrHttpMessageMessageInterface而来
- http头大小写不敏感