解读

在国内一线互联网公司的 PHP 面试中，PSR-4 是 Composer 自动加载的“标配”规范。面试官通常不会只问“怎么用”，而是追问“为什么这样设计”“目录结构写错会怎样”“多项目共用命名空间如何隔离”“与 PSR-0 差异在哪”。回答时务必把“规范条文 + Composer 实现 + 真实踩坑案例”串起来，体现“规范落地能力”。

知识点

1. PSR-4 是 PHP-FIG 提出的自动加载规范，Composer 的 autoload_psr4.php 是其官方实现。
2. 核心条文：
   a) 命名空间前缀（Namespace Prefix）与基目录（Base Directory）做“字符串前缀”映射；
   b) 去掉前缀后的子命名空间，直接对应子目录，大小写敏感；
   c) 命名空间分隔符 \ 转换成目录分隔符 /（Windows 下兼容 \）；
   d) 类名与文件名必须完全一致（大小写），后缀 .php；
   e) 不允许在类名里出现下划线转目录的“PSR-0 遗留规则”。
3. composer.json 声明方式：
   "autoload": { "psr-4": { "App\": "src/", "Vendor\Package\": "src/" } }
4. 运行 composer dump-autoload 后生成 vendor/composer/autoload_psr4.php 映射数组；spl_autoload_register 压入 Composer\Autoload\ClassLoader。
5. 常见错误：
   – 目录大小写与命名空间不一致（Linux 服务器直接 Class not found）；
   – 在命名空间前缀末尾漏写 \，导致前缀匹配失败；
   – 一个前缀映射到多个目录，Composer 会按声明顺序搜索，性能略降；
   – 把 PSR-0 的下划线目录转换习惯带到 PSR-4，找不到文件。
6. 与 PSR-0 差异：
   – PSR-0 需要把 “_” 转成目录分隔符，且必须逐级匹配；
   – PSR-0 已废弃，Laravel 6+、Symfony 5+ 全部迁移到 PSR-4。
7. 国内微服务场景：多仓库共用 “Company\” 前缀，通过 Composer path 仓库把各自子目录映射到 “company/order”, “company/pay”，实现“单一代码风格、多服务独立部署”。
8. 性能调优：
   – 生产环境开启 composer dump-autoload --optimize --apcu，生成 classmap+APCu 缓存，减少 stat 调用；
   – 避免在 PSR-4 目录里放大量非类文件，防止 opcache 浪费内存。

答案

PSR-4 自动加载规范通过“命名空间前缀 ⇆ 基目录”的字符串前缀映射实现。Composer 在 vendor/composer/autoload_psr4.php 中保存一张哈希数组，键是前缀如 App\，值是对应的基目录数组。当 PHP 遇到未定义的类 App\Service\UserService 时，SPL 自动加载器按以下步骤解析：

1. 遍历 autoload_psr4.php，找到最长匹配前缀 App\；
2. 去掉前缀后得到子命名空间 Service\UserService；
3. 将 \ 替换成目录分隔符，得到 Service/UserService.php；
4. 拼接基目录 src/，形成完整路径 src/Service/UserService.php；
5. 文件存在即 require，否则继续下一个前缀。

因此，只要保证“命名空间、子目录、文件名”三者大小写一致，并在 composer.json 中正确声明前缀与基目录，就能实现零配置、跨平台的自动加载。生产环境建议执行 composer dump-autoload --optimize，把 PSR-4 规则预生成 classmap，加 APCu 缓存，可让框架入口减少 80% 的 stat 系统调用，支撑国内电商大促高并发场景。

拓展思考

1. 如果公司代码历史包袱重，部分老库用 PSR-0，部分新服务用 PSR-4，如何在同一个 composer.json 中共存？
   答：同时声明 "psr-0" 和 "psr-4" 两段映射，Composer 会分别生成两套规则，注意老库目录保持 PSR-0 的下划线习惯即可。
2. 在 CI 阶段如何检测研发同学写错大小写？
   答：在 GitHub Actions 或 GitLab CI 中跑 phpstan --level=0 配合 composer dump-autoload --strict，若类名与文件大小写不一致会直接抛 Fatal error，可提前拦截。
3. 当项目使用 Docker 多阶段构建，源码目录被挂载为 volume，如何在容器启动阶段依旧保持 PSR-4 缓存？
   答：把 composer dump-autoload --optimize --apcu 放到镜像构建阶段，生成静态 classmap；运行时只需挂载 .env 与 storage，避免重复扫描磁盘。