欢迎来到PHP PSR标准讲座：写代码也能“标准化”！
各位PHP开发者们，大家好！今天我们来聊聊一个非常重要的主题——PSR标准。如果你还在用“自创规则”写PHP代码，那么今天这场讲座可能会让你大开眼界！我们将以轻松诙谐的方式，带你走进PHP标准化的世界，并教你如何写出优雅、规范的代码。
什么是PSR标准？
首先，让我们从头说起。PSR是“PHP Standards Recommendation”的缩写，翻译过来就是“PHP标准建议”。它是由PHP-FIG（PHP Framework Interop Group，PHP框架互操作组）制定的一系列规范，旨在帮助开发者编写一致、可读性强、易于维护的代码。
简单来说，PSR就像是一份“行业公约”，告诉你如何命名文件、如何格式化代码、如何处理错误等等。虽然这些标准并不是强制性的，但它们已经被广泛接受和使用，特别是在开源项目中。
PSR家族成员介绍
目前，PSR家族已经发布了多个标准，每个标准都有其独特的用途。下面我们来逐一认识一下这些“家庭成员”：
| 标准编号 | 名称 | 描述 |
|---|---|---|
| PSR-1 | 基本编码标准 | 定义了PHP代码的基本规则，比如每个文件必须以<?php开头等。 |
| PSR-2 | 编码风格指南 | 细化了PSR-1，规定了代码的缩进、空格、括号等格式化规则。 |
| PSR-3 | 日志接口 | 提供了一个统一的日志记录接口，方便不同日志库之间的互操作性。 |
| PSR-4 | 自动加载标准 | 规范了类文件的命名和路径映射规则，便于自动加载器使用。 |
| PSR-6 | 缓存接口 | 定义了一套缓存系统的通用接口。 |
| PSR-7 | HTTP消息接口 | 规范了HTTP请求和响应对象的结构。 |
| PSR-11 | 容器接口 | 提供了一个容器（Dependency Injection Container）的标准接口。 |
| PSR-15 | HTTP中间件接口 | 规范了HTTP中间件的行为和接口。 |
| PSR-16 | 简单缓存接口 | 提供了一个更简单的缓存接口。 |
是不是有点眼花缭乱？别担心，我们会逐步解析其中的关键内容。
实战演练：如何应用PSR标准？
接下来，我们通过一些实际案例，看看如何在日常开发中应用这些标准。
1. PSR-1 & PSR-2：代码格式化
PSR-1和PSR-2主要关注代码的格式化问题。以下是一些关键规则：
- 文件必须以
<?php开头，并且不能包含HTML标签。 - 每行代码最多80个字符（虽然现代IDE支持更长的行数，但保持简洁总是好的）。
- 使用4个空格代替Tab键。
- 函数名和变量名使用小写字母和下划线（如
get_user_info）。 - 类名使用驼峰命名法（如
UserManager）。
示例代码
<?php
namespace AppController;
use AppModelUser;
class UserController
{
public function getUserInfo(int $userId): array
{
$user = new User();
return $user->find($userId);
}
}注意：以上代码遵循了PSR-1和PSR-2的所有规则。
2. PSR-4：自动加载
PSR-4是一个非常实用的标准，它定义了类文件的命名和路径映射规则，使得我们可以轻松实现自动加载。
规则说明
- 文件路径必须与命名空间一一对应。
- 类名必须与文件名相同。
示例代码
假设我们有一个类AppControllerUserController，根据PSR-4规则，它的文件路径应该是：
src/App/Controller/UserController.php然后，我们在composer.json中配置自动加载：
{
"autoload": {
"psr-4": {
"App\": "src/"
}
}
}运行composer dump-autoload后，就可以直接使用这个类了！
3. PSR-3：日志接口
PSR-3提供了一个统一的日志接口，方便我们在不同的日志库之间切换。以下是其核心方法：
emergency($message)：系统不可用时使用。alert($message)：需要立即采取行动的情况。critical($message)：严重错误。error($message)：普通错误。warning($message)：警告信息。notice($message)：正常但值得注意的信息。info($message)：信息性消息。debug($message)：调试信息。
示例代码
<?php
use PsrLogLoggerInterface;
class LoggerExample
{
private $logger;
public function __construct(LoggerInterface $logger)
{
$this->logger = $logger;
}
public function doSomething()
{
try {
// 执行某些操作
$this->logger->info('操作成功');
} catch (Exception $e) {
$this->logger->error('发生错误: ' . $e->getMessage());
}
}
}4. PSR-7：HTTP消息接口
PSR-7规范了HTTP请求和响应对象的结构，使得我们可以更容易地处理HTTP通信。
示例代码
<?php
use PsrHttpMessageResponseInterface;
use PsrHttpMessageServerRequestInterface;
function handleRequest(ServerRequestInterface $request): ResponseInterface
{
$response = new ZendDiactorosResponse();
$body = $request->getBody();
$data = json_decode($body, true);
if (isset($data['name'])) {
$response->getBody()->write("Hello, " . $data['name']);
} else {
$response->getBody()->write("Hello, Guest");
}
return $response->withStatus(200);
}总结
今天的讲座就到这里啦！希望你对PHP PSR标准有了更深入的了解。记住，编写标准化代码不仅是为了让代码看起来更漂亮，更是为了提高团队协作效率和代码的可维护性。
最后，引用一句国外技术文档中的经典语录：“Code is read more often than it is written.”（代码被阅读的次数远比编写的次数多）。所以，让我们一起努力，写出更优雅、更规范的代码吧！
如果有任何疑问或想法，请随时提问！
