PHP 8.0 必须用 spl_autoload_register，__autoload 已被彻底移除；核心是类名、命名空间、文件路径三者严格对齐，错一位即 Class not found。
必须用 spl_autoload_register，__autoload 在 PHP 8.0 已彻底移除，任何还依赖它的项目在升级后会直接报致命错误。
为什么 __autoload 不能用了
它不是“不好用”，而是根本无法协作：__autoload 只允许定义一次，后注册的会无条件覆盖前一个。第三方库、框架、你自己写的加载逻辑全挤在一个函数里，谁先加载、谁该负责、路径怎么分，全靠运气。
常见错误现象：Class 'AppUser' not found，但代码里明明写了 __autoload —— 实际上是另一个库（比如旧版 Smarty 或某 SDK）悄悄重写了它，你的逻辑根本没执行。
PHP 7.2 起已标记为废弃，7.4 开始抛 E_DEPRECATED 警告，8.0 直接移除。现在写它，等于主动给自己埋兼容性雷。
立即学习“PHP免费学习笔记（深入）”；
spl_autoload_register 怎么注册才不翻车
它本身不决定路径怎么拼，只管按顺序调用你注册的函数。真正容易出错的是注册时机和函数内部逻辑。
- 必须在类首次被引用前注册，比如放在
index.php最开头，而不是某个条件分支里 - 别在多个文件里反复调用
spl_autoload_register注册匿名函数——会导致同一逻辑重复注册多次，每次类未命中都多跑一遍，白白拖慢性能 - 推荐封装成静态方法或单个闭包，统一入口管理，例如：
spl_autoload_register([MyLoader::class, 'load']);
- 不要依赖“写在文件顶部就一定生效”：命名空间解析、
use语句、class_alias都会影响实际触发时机
PSR-4 路径映射的三个硬规则
手动实现 PSR-4 时，90% 的加载失败都卡在这三处：
- 命名空间末尾的反斜杠
是必须的，"App"和"App"完全是两个前缀，漏掉就匹配不上 - 类名中的
必须替换成目录分隔符/，但不要自己写str_replace('\', DIRECTORY_SEPARATOR, ...)——require_once在 Windows 下能正确处理正斜杠，强行转反而在跨平台时出问题 - 拼完路径后必须加
.php，且不能多加后缀，User.php.php这种错误很常见，尤其当类名本身含.php字样时
示例（安全写法）：
spl_autoload_register(function ($class) {
$prefix = 'App\';
$base_dir = __DIR__ . '/src/';
if (str_starts_with($class, $prefix)) {
$relative_class = substr($class, strlen($prefix));
$file = $base_dir . str_replace('\', '/', $relative_class) . '.php';
if (is_readable($file)) {
require $file; // 注意：不是 require_once
}
}
});
require 还是 require_once？这里最容易踩坑
自动加载函数里用 require_once 看似稳妥，实则危险：
- PHP 的 “已加载文件列表” 在 CLI 和 FPM 模式下行为不一致，可能导致本地测试正常、线上报错
- 当你同时用了 Composer 和自定义加载器，
require_once可能跳过 Composer 加载器里的初始化逻辑（比如静态属性赋值、常量定义） - 真正防重复的手段是前缀隔离（如 PSR-4 的命名空间约束），不是靠
_once语义
正确做法只有一条：所有 autoload 函数里统一用 require，并确保每个类只由一个加载器负责——也就是严格过滤前缀，不兜底加载所有 *.php 文件。
最后提醒一句：如果你用了 Composer，别自己写 autoload。直接 require 'vendor/autoload.php'，它内部就是基于 spl_autoload_register 实现的，且已做路径预编译和 OPcache 优化。手写容易错，还绕不开 Composer 生态的约束。
