必须用 spl_autoload_register()，因为 __autoload() 在 PHP 8.0 已被彻底移除，PHP 7.4 起调用即致命错误，且仅支持单次定义，无法兼容多库共存；而 spl_autoload_register() 支持多注册、顺序执行、互不干扰，是 Composer 及主流框架的基石。
必须用 spl_autoload_register()，__autoload() 在 PHP 8.0 已彻底消失，不是“不推荐”，是根本跑不起来。
为什么 __autoload() 不能碰，连测试都不行
PHP 7.2 起它就被标记为废弃，7.4 开始报 Fatal error: Uncaught Error: Call to undefined function __autoload()，8.0 直接从引擎里删了。它只允许定义一次，第三方库、框架、甚至你自己的一个测试文件再定义一次，就直接 fatal。而 spl_autoload_register() 天然支持多注册、顺序执行、互不干扰——Composer、Laravel、Symfony 全靠这个活着。
- 别在任何环境写
function __autoload() { ... }，哪怕本地 PHP 7.1 能过，上线换容器/主机就崩 - 不要用
@抑制警告来“假装它还存在”——这是把问题藏进日志，不是解决 - 检查是否误用了：运行
spl_autoload_functions()，如果返回空数组，说明压根没注册成功；如果只看到一个奇怪的函数名，大概率是某个老库偷偷塞了__autoload()并被忽略
spl_autoload_register() 注册时最容易漏掉的三件事
注册本身很简单，但三个细节不处理，类照样找不到，而且查不出原因：
- 必须在
new ClassA()或ClassA::method()之前调用——不是“文件开头就行”，而是要在类首次被解析前完成注册；CLI 和 Web 环境加载顺序不同，建议统一放在入口文件（如index.php或cli.php）最顶部 - 回调函数只能接收一个参数：
$class（完整类名字符串），不能依赖外部变量或容器；传入闭包时别捕获大对象，否则 autoload 变成内存泄漏温床 - 别在回调里
throw或exit：PHP 会静默吞掉异常，后续加载器也不会执行，结果就是Class 'X' not found却没有任何线索
路径拼错导致类找不到，90% 出在这几个地方
自动加载失败，不是 PHP 不工作，是你给的路径和文件系统对不上。Linux 下大小写敏感、路径分隔符、扩展名缺一不可。
立即学习“PHP免费学习笔记（深入）”；
- 类名
AppControllersUser→ 路径必须是src/Controllers/User.php，不是src/controllers/user.php（小写）也不是src/Controllers/User.inc（错后缀） - 用
str_replace('\', '/', $class)转命名空间，别用explode()+join()，前者快且能正确处理嵌套反斜杠（Windows 路径兼容性也靠它） - 拼完路径后，务必用
is_readable($file)或file_exists($file)判断，再require；盲目require会触发 Warning 并中断整个 autoload 链 - 路径构造别硬写
../app/或./classes/，统一用dirname(__DIR__) . '/src/'或__DIR__ . '/src/'，避免相对路径在 CLI/Web 下行为不一致
该用 require 还是 require_once？答案很反直觉
多数教程写 require_once，但它在 autoload 场景下是危险操作：PHP 的 “已加载文件列表” 在 CLI 和 FPM 模式下表现不一致；更麻烦的是，当你同时用了 Composer 和自定义加载器，require_once 可能让 Composer 的初始化逻辑被跳过。
- 唯一安全做法：用
require，但靠前缀过滤确保每个类只被一个加载器处理（例如只响应MyApp\开头的类） - 不用
include：失败不报错，类没加载成功却无提示，调试抓狂 - 别指望
_once防重复——PSR-4 的前缀隔离才是正解；autoload 本就不该让同一个类被多个加载器命中
真正难的不是写几行 spl_autoload_register()，而是让每个类名到路径的映射都经得起大小写、跨平台、多加载器共存的检验。一旦路径规则松动，autoload 就退化成黑盒报错——你得盯着 realpath() 输出、ls -l 文件权限、php -l 语法检查，三者缺一不可。
