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 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。