PSR 是 PHP Standards Recommendations 的缩写,由 PHP-FIG 组织维护。它的目标不是规定”怎么写业务代码”,而是让不同库之间能互相替换、互相组合。最直接的体现就是:你能把 Monolog 的日志处理器塞进任何框架,因为大家都遵守同一套接口。
最常用的几个
| 编号 | 内容 | 实际影响 |
|---|---|---|
| PSR-1 | 基础编码规范 | 文件只用 <?php,类名与文件名对应 |
| PSR-3 | 日志接口 | LoggerInterface,换日志库不用改业务代码 |
| PSR-4 | 自动加载 | 命名空间映射目录,Composer 的核心 |
| PSR-7 | HTTP 消息 | Request/Response 对象不可变 |
| PSR-11 | 容器接口 | ContainerInterface,框架容器可互换 |
| PSR-12 | 扩展编码风格 | 缩进、括号、空行的统一约定 |
PSR-4 的实际含义
{
"autoload": {
"psr-4": {
"App\": "src/",
"App\Admin\": "src/Admin/"
}
}
}
// AppHttpControllerHomeController
// → src/Http/Controller/HomeController.php
规则很简单:命名空间前缀映射到目录,去掉前缀后的部分按反斜杠转成目录层级,类名加 .php。一个文件一个类,文件名大小写必须与类名一致——在 Linux 上大小写敏感,写错就是找不到类。
PSR-3 为什么重要
业务代码依赖接口而不是具体实现,这样测试时可以塞一个假日志器,上线时换成文件或 ELK,代码一行不用改。
<?php
use PsrLogLoggerInterface;
final class OrderService
{
public function __construct(private LoggerInterface $logger) {}
public function pay(int $orderId): void
{
$this->logger->info('订单支付', ['order_id' => $orderId]);
}
}
要不要严格遵守
新项目建议直接用 PSR-12,配 php-cs-fixer 自动格式化,成本几乎为零。老项目不必强行改造全站,但新增文件应该遵守,避免风格进一步分裂。规范的价值在于减少无意义的争论——格式交给工具,人专注在逻辑上。
本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。