PSR规范学习笔记

更多详细内容见：https://github.com/PizzaLiu/PHP-FIG

目前包括以下几个规范：

PSR-0（弃用）

PSR-1

PSR-2

PSR-3

PSR-4

1.PSR-0

自动加载规范，此规范已被启用 - 本规范已于 2014 年 10 月 21 日被标记为弃用，目前新的替代规范为【PSR-4】

本文是为自动加载器实现通用自动加载所需要遵循的编码规范

• 一个标准的命名空间与类名称的定义必须符合以下结构：\<Vendor Name><Namespace>

• *(ClassName)
• 其中 Vendor Name 为每个命名空间都必须要有的一个顶级命名空间名
• 需要的话，每个命名空间下可以拥有多个子命名空间
• 当根据完整的命名空间名从文件系统中载入类文件时，每个命名空间之间的分隔符都会被转换成文件夹路径分隔符
• 类命名中的每个_字符也会被转换成文件夹路径分隔符，而命名空间中的_字符则是无特殊含义的。
• 当从文件系统中载入标准的命名空间或类时，都将添加.php 为目标文件后缀
• 组织名称（Vendor Name）、命名空间 (Namespace) 以及类的名称 (Class Name) 可由任意大小写字母组成。

2.PSR-1

基本代码规范，本篇规范制定了代码基本元素的相关标准，以确保共享的 PHP 代码间具有较高程度的技术互通性。

关键词“必须”（MUST）、“一定不可、一定不能”（MUST NOT）、“需要”（REQUIRED）、“将会”（SHALL）、“不会”（SHALL NOT）、“应该”（SHOULD）、“不该”（SHOULD NOT）、“推荐”（RECOMMENDED）、“可以”（MAY）和“可选”（OPTIONAL）

• PHP 代码文件必须以 <?php 或 <?= 标签开头
• PHP 代码文件必须以不带 BOM 的 UTF- 8 编码【推荐阅读：utf- 8 与 utf-8(无 BOM)的区别】
• PHP 代码中应该只定义类、函数、常量等声明，或其他会产生从属效应的操作（生成文件输出以及修改.ini 配置文件等），二者只能选其一
• 命名空间以及类必须符合 PSR 的自动加载规范：PSR-4;
• 类的命名必须遵循 StudlyCaps 大写开头的驼峰命名规范;
• 类中的常量所有字母都必须大写，单词间用下划线分隔；
• 方法名称必须符合 camelCase 式的小写开头驼峰命名规范

3.PSR-2

• 代码必须遵循 PSR- 1 中的编码规范
• 代码必须使用四个空格符而不是 tab 键进行缩进。
• 每行的字符数应该软性保持在 80 个内，理论上不可多于 120 个，但一定不能由硬性限制
• 每个 namespace 命名空间声明语句和 use 声明语句块后面，必须插入一个空白行
• 类的开始花名号（{）必须在函数声明后自成一行，结束花名号 (}) 也必须在函数主体后自成一行
• 类的属性和方法必须添加访问修饰符（private protected 以及 public），abstract 以及 final 必须声明在访问修饰符之前，而 static 必须声明在访问修饰符之后。
• 控制结构的关键字后必须要有一个空格符，而调用方法或函数时则一定不能有。
• 控制结构的开始花括号（{）必须写在声明的同一行，而结束花括号（}）必须写在主体后自成一行。
• 控制结构的开始左括号后和结束右括号前，都一定不能有空格符。

4.PSR-3

5.PSR-4