PHP API框架中PSR规范有哪些

在PHP开发中，PSR（PHP Standards Recommendation）规范是由PHP-FIG（PHP Framework Interoperability Group）制定的一系列标准，旨在提高PHP代码的互操作性和可维护性。这些规范涵盖了从代码风格到接口设计等多个方面，对于构建高质量的PHP API框架至关重要。本文将详细介绍PHP API框架中常见的PSR规范，并探讨它们在实际开发中的应用。

1. PSR-1: 基础编码标准

PSR-1是PHP编码标准的基础，它定义了PHP代码的基本格式和结构。遵循PSR-1规范可以确保代码的一致性和可读性。

1.1 文件格式

• PHP代码必须使用<?php或<?=标签。
• 文件编码必须为UTF-8 without BOM。
• 文件应该只包含PHP代码，或者包含PHP代码和HTML代码的混合。

1.2 类命名

• 类名必须使用大驼峰命名法（StudlyCaps）。
• 类名应该与文件名一致，且文件名应该以.php结尾。

1.3 方法命名

• 方法名必须使用小驼峰命名法（camelCase）。
• 方法名应该具有描述性，能够清晰地表达其功能。

1.4 常量命名

• 常量名必须全部大写，单词之间用下划线分隔。

1.5 命名空间

• 命名空间和类名必须遵循PSR-4自动加载规范。

2. PSR-2: 编码风格指南

PSR-2是对PSR-1的扩展，它进一步细化了PHP代码的编码风格，包括缩进、括号、空格等方面的规定。

2.1 缩进

• 代码必须使用4个空格进行缩进，禁止使用Tab键。

2.2 行长度

• 每行代码的长度应该控制在80个字符以内，最长不超过120个字符。

2.3 控制结构

• 控制结构关键字（如if、else、for等）后面必须有一个空格。
• 控制结构的左括号{必须与控制结构关键字在同一行，右括号}必须独占一行。

2.4 方法定义

• 方法定义的左括号{必须与方法名在同一行，右括号}必须独占一行。
• 方法的参数列表中的逗号后面必须有一个空格。

2.5 类和接口

• 类和接口的左括号{必须与类名或接口名在同一行，右括号}必须独占一行。
• extends和implements关键字必须与类名或接口名在同一行。

3. PSR-3: 日志接口规范

PSR-3定义了一个通用的日志接口，使得不同的日志库可以相互兼容。通过遵循PSR-3规范，开发者可以在不同的日志库之间轻松切换。

3.1 日志级别

• PSR-3定义了8个日志级别：debug、info、notice、warning、error、critical、alert、emergency。

3.2 日志方法

• 每个日志级别对应一个方法，如debug()、info()等。
• 日志方法接受两个参数：消息和上下文。消息是一个字符串，上下文是一个关联数组，用于传递额外的信息。

3.3 日志接口

• PSR-3定义了一个LoggerInterface接口，所有遵循PSR-3规范的日志库都必须实现这个接口。

4. PSR-4: 自动加载规范

PSR-4定义了PHP类的自动加载标准，使得开发者可以更方便地组织和管理代码。

4.1 命名空间与目录结构

• 命名空间的前缀必须与目录结构相对应。
• 类名必须与文件名一致，且文件名必须与类名的大小写一致。

4.2 自动加载器

• PSR-4规范要求自动加载器必须能够根据命名空间和类名自动加载对应的文件。
• 自动加载器必须遵循PSR-4的命名规则，且必须能够处理大小写敏感的文件名。

5. PSR-7: HTTP消息接口规范

PSR-7定义了HTTP消息的接口规范，包括请求和响应的表示方式。通过遵循PSR-7规范，开发者可以构建与HTTP协议兼容的API。

5.1 HTTP消息接口

• PSR-7定义了RequestInterface、ResponseInterface、ServerRequestInterface等接口，用于表示HTTP请求和响应。
• 这些接口定义了HTTP消息的基本属性和方法，如getMethod()、getUri()、getHeaders()等。

5.2 流接口

• PSR-7还定义了StreamInterface接口，用于表示HTTP消息的主体部分。
• 流接口提供了读写数据的方法，如read()、write()、seek()等。

5.3 消息工厂

• PSR-7定义了RequestFactoryInterface、ResponseFactoryInterface等工厂接口，用于创建HTTP消息对象。

6. PSR-11: 容器接口规范

PSR-11定义了一个通用的容器接口，用于管理依赖注入和服务定位。通过遵循PSR-11规范，开发者可以构建可扩展的PHP应用。

6.1 容器接口

• PSR-11定义了ContainerInterface接口，所有遵循PSR-11规范的容器都必须实现这个接口。
• 容器接口提供了get()和has()方法，用于获取和检查容器中的服务。

6.2 服务定位

• 容器接口允许开发者通过服务名称获取服务对象。
• 服务名称通常是一个字符串，可以是类名、接口名或别名。

6.3 依赖注入

• 容器接口支持依赖注入，开发者可以通过容器自动解析和注入依赖对象。

7. PSR-12: 扩展编码风格指南

PSR-12是对PSR-2的扩展，它进一步细化了PHP代码的编码风格，特别是在类和方法的定义方面。

7.1 类定义

• 类定义的左括号{必须与类名在同一行，右括号}必须独占一行。
• 类中的属性和方法必须按照可见性（public、protected、private）进行分组。

7.2 方法定义

• 方法定义的左括号{必须与方法名在同一行，右括号}必须独占一行。
• 方法的参数列表中的逗号后面必须有一个空格。

7.3 控制结构

• 控制结构关键字（如if、else、for等）后面必须有一个空格。
• 控制结构的左括号{必须与控制结构关键字在同一行，右括号}必须独占一行。

8. PSR-15: HTTP服务器请求处理器接口规范

PSR-15定义了HTTP服务器请求处理器的接口规范，使得开发者可以构建与PSR-7兼容的中间件和请求处理器。

8.1 请求处理器接口

• PSR-15定义了RequestHandlerInterface接口，所有遵循PSR-15规范的请求处理器都必须实现这个接口。
• 请求处理器接口提供了handle()方法，用于处理HTTP请求并返回响应。

8.2 中间件接口

• PSR-15定义了MiddlewareInterface接口，所有遵循PSR-15规范的中间件都必须实现这个接口。
• 中间件接口提供了process()方法，用于处理HTTP请求并调用下一个中间件或请求处理器。

9. PSR-16: 简单缓存接口规范

PSR-16定义了一个简单的缓存接口，使得开发者可以轻松地在不同的缓存库之间切换。

9.1 缓存接口

• PSR-16定义了CacheInterface接口，所有遵循PSR-16规范的缓存库都必须实现这个接口。
• 缓存接口提供了get()、set()、delete()等方法，用于操作缓存数据。

9.2 缓存项

• PSR-16定义了CacheItemInterface接口，用于表示缓存中的单个项。
• 缓存项接口提供了getKey()、get()、set()等方法，用于操作缓存项。

10. PSR-17: HTTP工厂接口规范

PSR-17定义了HTTP消息工厂的接口规范，使得开发者可以创建与PSR-7兼容的HTTP消息对象。

10.1 请求工厂接口

• PSR-17定义了RequestFactoryInterface接口，所有遵循PSR-17规范的请求工厂都必须实现这个接口。
• 请求工厂接口提供了createRequest()方法，用于创建HTTP请求对象。

10.2 响应工厂接口

• PSR-17定义了ResponseFactoryInterface接口，所有遵循PSR-17规范的响应工厂都必须实现这个接口。
• 响应工厂接口提供了createResponse()方法，用于创建HTTP响应对象。

11. PSR-18: HTTP客户端接口规范

PSR-18定义了HTTP客户端的接口规范，使得开发者可以构建与PSR-7兼容的HTTP客户端。

11.1 客户端接口

• PSR-18定义了ClientInterface接口，所有遵循PSR-18规范的HTTP客户端都必须实现这个接口。
• 客户端接口提供了sendRequest()方法，用于发送HTTP请求并返回响应。

11.2 请求选项

• PSR-18允许开发者在发送HTTP请求时传递请求选项，如超时时间、代理设置等。

12. 总结

PSR规范为PHP开发者提供了一套统一的编码标准和接口规范，极大地提高了PHP代码的互操作性和可维护性。在构建PHP API框架时，遵循这些规范不仅可以提高代码质量，还可以减少与其他库和框架的兼容性问题。通过理解和应用这些规范，开发者可以构建出更加健壮和可扩展的PHP应用。