__autoload 因仅支持单个加载器、易冲突，PHP 7.2 起弃用，8.0 移除；spl_autoload_register 支持多回调、顺序执行、灵活注册，是唯一推荐方案。
为什么 __autoload 已被废弃，必须改用 spl_autoload_register
PHP 7.2 起 __autoload 函数被正式弃用，7.4 开始报 E_DEPRECATED，8.0 直接移除。它只能注册一个全局加载器，多人协作或引入多个框架时必然冲突；而 spl_autoload_register 支持注册多个回调，顺序执行，互不干扰。
常见错误现象：Class 'XXX' not found 却没触发任何自动加载逻辑——大概率是误用了已失效的 __autoload，或忘记调用 spl_autoload_register。
- 必须在类首次被引用前（如
new XXX()或XXX::staticMethod()前）注册加载器 - 不能依赖“写在文件开头就一定生效”——PHP 解析顺序和命名空间解析规则会影响实际触发时机
- 推荐始终用匿名函数或静态方法注册，避免依赖全局作用域中的函数名
如何用 spl_autoload_register 实现 PSR-4 兼容的加载逻辑
PSR-4 是当前最通用的命名空间到路径映射规范，Composer 默认遵循它。手动实现时核心是：把命名空间前缀转成目录，类名转成文件名，拼出完整路径并 require_once。
使用场景：不依赖 Composer 的轻量项目、CLI 工具、或需对某些类做特殊加载处理（如从 Phar 或远程缓存读取）。
立即学习“PHP免费学习笔记（深入）”；
- 命名空间分隔符
需替换为目录分隔符/，但注意 Windows 下require_once能正确处理正斜杠，无需转 - 类名末尾不能带
.php后缀，否则会变成Foo.php.php；标准做法是拼完路径后加.php - 务必用
file_exists()或is_readable()判断文件是否存在，避免require_once报错中断流程
简短示例：
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_once $file;
}
}
});
spl_autoload_register 的参数和返回值有什么实际影响
该函数接受三个参数：$autoload_function（必填）、$throw（bool，默认 true）、$prepend（bool，默认 false）。日常开发中只有后两个容易踩坑。
性能影响：注册大量加载器本身开销极小，但每次类未命中时会逐个调用所有已注册函数，直到某个函数成功 require 或全部返回。因此加载器内部应尽量快速失败。
-
$throw = false时，即使所有加载器都未找到类，也不会抛出LogicException，而是静默失败——这会让Class not found错误变得难以定位 -
$prepend = true会让新注册的加载器排在调用链最前面，适用于需要“劫持”特定命名空间的场景（如 Mock 类、AOP 替换），但滥用会导致其他加载器完全失效 - 同一个函数重复注册多次，会多次执行——调试时若发现类被
require两次，先检查是否重复调用了spl_autoload_register
为什么 require_once 在自动加载里比 include 更安全
自动加载本质是“按需补全缺失定义”，不是“有条件执行代码”。用 include 可能导致同一文件被多次 require（比如两个不同加载器都匹配到了同一个类），进而引发 Cannot redeclare class 致命错误。
兼容性影响：PHP 所有版本对 require_once 的行为一致；而 include_once 在某些老版本中存在文件路径归一化 bug（如 ./foo.php 和 foo.php 被视为不同文件）。
-
require_once会检查已加载的文件列表（opcode 缓存层），确保物理文件只执行一次 - 不要在加载器里用
return试图“跳过后续加载器”——spl_autoload_register的设计就是让每个加载器独立判断，返回值无意义 - 如果类文件里有副作用（如定义全局常量、修改 ini 设置），要意识到这些操作只发生一次，且发生在类首次被引用的时刻，不是脚本启动时
