__autoload() 已被废弃，因 spl_autoload_register() 支持多回调、可控顺序、异常捕获且兼容 Composer；而 __autoload 是全局单例，无法共存、不支持参数。
为什么 __autoload() 已被废弃，必须用 spl_autoload_register()
PHP 7.2 起 __autoload() 函数被正式弃用，7.4 开始报 E_DEPRECATED，8.0 完全移除。直接定义 __autoload 不再触发，也不会报错——而是彻底静默失效。这是最常踩的坑：本地 PHP 7.1 能跑，上线到 8.0 环境就抛 Class not found 却查不出原因。
根本原因是：spl_autoload_register() 支持多回调、可控制执行顺序、能捕获异常、且与 Composer 生态完全兼容；而 __autoload 是全局单例，无法共存，也不支持参数传递。
怎样正确注册自动加载器：spl_autoload_register() 的三种写法
它接受一个可调用（callable），可以是函数名字符串、匿名函数或数组形式的 [类， 方法]。推荐始终传匿名函数，避免命名污染和 作用域 问题。
- 基础写法（按命名空间映射路径）：
spl_autoload_register(function ($class) {$file = str_replace('\', '/', $class) . '.php'; if (file_exists($file)) {require_once $file;} }); - 带根目录前缀（更安全，防止遍历系统路径）：
$base_dir = __DIR__ . '/src/'; spl_autoload_register(function ($class) use ($base_dir) {$file = $base_dir . str_replace('\', '/', $class) . '.php'; if (file_exists($file)) {require_once $file;} }); - 支持多个后缀（如
.php和.inc）：spl_autoload_register(function ($class) {foreach (['.php', '.inc'] as $ext) {$file = str_replace('\', '/', $class) . $ext; if (file_exists($file)) {require_once $file; return;} } });
为什么 require_once 比 include_once 更合适
自动加载本质是“类定义必须存在”，不是“尝试包含”。如果文件不存在或语法错误，include_once 只发警告（Warning）并继续执行，后续实例化时才爆 Fatal error: Class not found，堆 栈信息丢失原始加载点。
立即学习“PHP 免费学习笔记（深入）”；
require_once 遇错直接中止并给出明确文件路径和行号，便于定位哪个类加载失败。另外，它天然防重复加载——即使同一类被多次请求（比如依赖树中多处引用），也只引入一次。
注意：require_once 的“once”是基于文件绝对路径判断的，所以确保 $file 是完整路径（用 realpath() 或拼全 __DIR__）。
实际项目中容易忽略的三个细节
自动加载看似简单，但线上出问题往往卡在这些地方：
- 大小写敏感：Linux 下
MyClass.php和myclass.php是不同文件，但类名myclass在 PHP 中合法（尽管违反 PSR-4）。确保文件名与类名严格一致（首字母大写 + 驼峰）。 - 返回值陷阱：注册的 回调函数** 不能有返回值 **。如果写了
return true;或隐式返回，PHP 会认为“已处理完毕”，后续注册的其他加载器（比如 Composer 的）将被跳过。 - 执行时机：
spl_autoload_register()必须在任何new、static::、class_exists()之前调用。常见错误是把它写在某个 工具 类内部、或放在条件分支里，导致部分类永远不注册。
Composer 默认生成的 vendor/autoload.php 就是靠 spl_autoload_register() 实现的——它本身不定义逻辑，而是把 PSR-4 映射规则转成一堆闭包注册进去。理解这一点，才能真正看懂 vendor 目录下 autoload_* 文件的作用。
