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 直接移除。现在写它，等于主动给自己埋兼容性雷。

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 字样时

示例（安全写法）：

1. spl_autoload_register(function ($class) { 
2.     $prefix = 'App\'; 
3.     $base_dir = __DIR__ . '/src/'; 
4.     if (str_starts_with($class, $prefix)) { 
5.         $relative_class = substr($class, strlen($prefix)); 
6.         $file = $base_dir . str_replace('\', '/', $relative_class) . '.php'; 
7.         if (is_readable($file)) { 
8.             require $file; // 注意：不是 require_once 
9.         } 
10.     } 
11. }); 

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 生态的约束。

Tags: PHP怎样自动加载类 PHP自动加载机制 Autoload

分享到：