PHP 8.0 必须用 spl_autoload_register，__autoload 已被彻底移除，定义即无效；核心是类名、命名空间、文件路径三者严格对齐，大小写或路径错一位都会导致 Class not found。

直接说结论：PHP 8.0 **必须用 spl_autoload_register，绝不能写 __autoload —— 它已在 PHP 8.0 中被彻底移除，写了就报 Fatal error。自动加载不是“配一下就能跑”，核心是类名、命名空间、文件路径三者严格对齐；错一个字母、少一个反斜杠、大小写不一致（尤其 Linux 环境），都会导致 Class not found。

为什么 __autoload 在 PHP 8.0 下完全失效

PHP 8.0 不再识别 __autoload 函数名，哪怕你定义了也不会触发，更不会报 Deprecated 警告——它直接跳过，等同于没写。这不是兼容性问题，是硬性移除。

• 所有依赖 __autoload 的旧代码，升级到 PHP 8.0 后会立刻崩：类存在但 new X() 报错
• 第三方库若自带 __autoload（比如某些老 SDK），必须手动 patch 或替换为 spl_autoload_register
• spl_autoload_register 注册的函数接收单个 $class 参数（完整类名，含命名空间），而 __autoload 也只收这个参数——迁移时函数体可复用，但注册方式必须改

spl_autoload_register 回调里最容易翻车的三件事

注册函数看似简单，但生产环境出问题，90% 出在路径拼错、扩展名遗漏、或盲目 require。

• 别硬拼 .php 后缀却忘了检查：类名末尾带 .php（如误写成 AppControllerUser.php）会导致路径变成 User.php.php；标准做法是拼完路径后统一加 .php
• 路径分隔符别用 str_replace('\', '/', $class) 处理 Windows 路径——PHP 的 require 本身支持正斜杠，且 str_replace('', '/', $class) 才是正确转命名空间分隔符的方式（注意单引号内反斜杠需双写）
• 必须用 file_exists($file) 或 is_readable($file) 判断再 require；直接 require $file 会触发 Warning 并中断后续加载器执行，导致本该由 Composer 加载的类也失败

PSR-4 映射规则写错的典型表现

类文件找不到，八成是 PSR-4 前缀和目录没对上。PHP 不会猜你把 AppControllersUser 放在 app/Controllers/User.php 还是 src/Http/Controllers/UserController.php。

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

• 前缀必须以反斜杠结尾：'App\'，不是 'App' 或 'App\'（后者少一个反斜杠）；strncmp($class, 'App\', 4) 比 str_starts_with($class, 'App\') 更稳妥（PHP 8.0+ 才有 str_starts_with）
• 计算相对路径时，要用 substr($class, strlen('App\'))，不能漏掉前缀长度；否则 App\Models\User 会变成 Models\User 而不是 Models/User
• Linux 下文件系统大小写敏感：User.php 和 user.php 是两个文件，但 new User() 只找 User.php；开发机用 Windows 逃过一劫，上线 Linux 就炸

Composer autoload 配置错位的真实后果

很多人以为只要 composer.json 里写了 "autoload"，运行 composer dump-autoload 就万事大吉。其实错配会静默失效。

立即学习“PHP免费学习笔记（深入）”；

• 配置项写成 "psr-4": { "App": "src/" }（缺反斜杠），Composer 生成的加载器根本不会匹配 App\Controllers\User，因为前缀比对失败
• 目录路径写错：比如写成 "src/Controllers" 而不是 "src"，那么 App\Controllers\User 会被映射成 src/Controllers/Controllers/User.php（多了一层）
• 没执行 composer dump-autoload 或忘记 require 'vendor/autoload.php' —— 自动加载器压根没注册，和没写一样

真正麻烦的不是写错，而是错误不报在加载器里，而是报在业务代码第一行 new XXX() 上，然后你得倒查命名空间、文件名、路径、composer.json、甚至 OPcache 是否缓存了旧的 autoload 文件——这些细节一旦漏看，两小时就没了。