PHP PSR 代码规范基本介绍

PSR 是 PHP Standard Recommendation 的简写，即PHP推荐标准。

目前经过的规范有 PSR-0(Autoloading Standard)、PSR-1(Basic Coding Standard)、PSR-2(Coding Style Guide)、PSR-3(Logger Interface)、PSR-4(Improved Autoloading)。

PSR 不是PHP官方标准，而是从如Zend、Symfony2等知名PHP项目中提炼出来的一系列标准，目前有愈来愈多的社区项目加入并遵循该标准。

PHP FIG（Framework Interoperability Group）框架可互用性小组是制定PSR开发规范的组织。他们的目的在于以最低程度的限制制定一个统一的标准，让各个框架遵循统一的编码规范。

 

====================PSR-0（自动加载规范）=======================

PSR-0(Autoloading Standard)类自动加载规范，该规范现已废弃（Deprecated），它将由PSR-4替代。

1.一个彻底合格的命名空间和类名必须遵循如下结构 "\VendorName\Namespace\ClassName"

2.每一个命名空间必须有顶级的命名空间 "VendorName"

3.每一个命名空间能够有任意多个子命名空间

4.每一个命名空间在被文件系统加载时必须被转换为操做系统路径分隔符 (DIRECTORY_SEPARATOR)

5.每一个"_"字符在"类名"中被转换为DIRECTORY_SEPARATOR。而在 PSR-4 中使用下划线没有任何特殊含义

6.符合命名标准的命名空间和类名必须以".php"结尾来加载文件

7.命名空间和类名能够由大小写字母组成，但必须对大小写敏感以保证多系统兼容性

 

====================PSR-1（基本代码规范）=======================

PSR-1(Basic Coding Standard)基本代码规范，用以确保共享的PHP代码间具备较高程度的技术互通性。

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

2.PHP代码源文件必须使用不带 BOM 的 UTF-8 编码

3.一个源文件建议只用做定义类、函数、常量等声明，或者其余产生从属效应的操做（如：输出信息，修改配置文件等）

4.命名空间以及类必须符合 PSR 的自动加载规范：PSR-0 或 PSR-4

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

6.类中的常量全部字母都必须大写，单词间用下划线分隔

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

 

* BOM(byte order mark)是 Unicode 标准的一部分，一般用于标记纯文本字节序(byte order)，使得文本处理程序可以识别读入的文件使用的 Unicode 编码（UTF-八、UTF-1六、UTF-32）。

* 从属效应是指仅仅经过包含文件，不直接声明类、函数和常量而执行的逻辑操做。一份PHP源文件应该要么就只包含不产生从属效应的定义操做，要么就包含只会产生从属效应的逻辑操做，切勿同时包含二者。

 

====================PSR-2（代码风格规范）=======================

 PSR-2(Coding Style Guide)代码风格规范，经过制定一系列规范化PHP代码的规则，以减小因代做者码风格不一样而形成的阅读不便。

1.代码必须遵循 PSR-1 中的编码规范

2.代码必须使用4个空格来进行缩进，而非制表符(TAB)

3.建议每行代码字符数保持在80个之内，理论上不可多于120个，但不作硬性限制

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

5.类的左花括号 "{" 必须写在声明后自成一行，右花括号 "}" 也必须在类主体下自成一行

6.方法的左花括号 "{" 必须放在声明后自成一行，右花括号 "}" 也必须于主体下自成一行

7.类的属性和方法必须添加访问修饰符（private、protected、public），abstract 以及 final 必须声明在访问修饰符以前，而 static 必须声明在访问修饰符以后（例：final public static）

8.在控制结构关键字的后面必须有一个空格，而调用方法或函数时必定不能有（控制结构：if-else、switch-case、try-catch、while、foreach ...）

9.控制结构的左花括号 "{" 必须跟其处于同一行，右花括号 "}" 必须在控制结构主体以后自成一行

10.控制结构的开始左括号以后，和结束右括号以前都不能够有空格

 

====================PSR-3（日志接口规范）=======================

PSR-3(Logger Interface)日志接口规范，主要目的是为了让日志类库经过接收一个 LoggerInterface 对象来记录日志信息。

1.LoggerInterface 接口对外定义了八个方法，分别用来记录 RFC 5424 中定义的八个等级的日志：debug、info、notice、warning、error、critical、alert、emergency

2.第九个方法 log()，第一个参数为记录等级。可以使用一个预先定义的等级常量做为参数来调用此方法，必须与直接调用以上八个方法具备相同的效果。若是传入的等级常量没有预先定义，则必须抛出 psr\Log\InvalidArgumentException 类型的异常。不推荐使用自定义的日志等级，除非你很是肯定当前类库对其有所支持。

 

 ====================PSR-4（自动加载新规）=======================

PSR-4(Improved Autoloading)本规范是关于自动载入对应类的相关规范，是 PSR-0 自动加载规范的补充。

1.此处的“类”是一个泛称，它包含类、接口、traits 以及其余相似的结构

2.彻底限定类名须要遵循如下结构：\<命名空间>(\<子命名空间>)*\<类名>

　　* 彻底限定类名必需要有一个顶级命名空间，被称为 "vendor namespace"；

　　* 彻底限定类名能够有一个或多个子命名空间；

　　* 彻底限定类名必须有一个终止类名；

　　* 彻底限定类名中任意一部分中的下划线都没有特殊含义；

　　* 彻底限定类名能够由任意大小写字母组成；

　　* 彻底限定类名必须以大小写敏感的方式引用；

3.当根据完整的类名载入相应的文件时：

　　* 彻底限定类名中，连续的一个或几个子命名空间构成的命名空间前缀（不包括顶级命名空间的分隔符），至少对应着至少一个基础目录；

　　* 紧接命名空间前缀后的子命名空间必须与相应的”文件基目录“相匹配，其中的命名空间分隔符将做为目录分隔符；

　　* 终止类名对应一个以 .php 结尾的文件，文件名必须和终止类名大小写匹配；

4.自动加载器（autoloader）的实现不能抛出异常，不可引起任一级别错误，也不该该有返回值