注册自动加载器
设置 spl_autoload_register，并配置基于 Composer 的自动加载。
注册自动加载器 是 CoddyKit 上的免费 PHP Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 PHP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 PHP Academy 课程共包含 4 节课。
spl_autoload_register
spl_autoload_register() 会注册一个回调函数，每当使用未定义的类时，PHP 就会调用它。多个自动加载器会按照注册顺序运行。
基本自定义自动加载器
手动编写的最小 PSR-4 风格自动加载器：
<?php
spl_autoload_register(function (string $class): void {
$prefix = 'App\\';
$baseDir = __DIR__.'/src/';
if (!str_starts_with($class, $prefix)) return;
$rel = substr($class, strlen($prefix));
$file = $baseDir.str_replace('\\', '/', $rel).'.php';
if (file_exists($file)) require $file;
});多个自动加载器
为每个命名空间前缀注册一个自动加载器，使每个加载器只处理自己的类。
<?php
spl_autoload_register(fn($c) => loadFromSrc($c));
spl_autoload_register(fn($c) => loadFromLib($c));Composer 的 autoload.php
实际上，您几乎不会编写自己的自动加载器。Composer 会生成一个自动加载器，覆盖所有软件包以及您自己的 PSR-4 映射。
<?php
require __DIR__.'/vendor/autoload.php';dump-autoload
添加新类或更改 composer.json 的自动加载设置后，请重新生成自动加载器：composer dump-autoload。
优化的自动加载器
composer dump-autoload --optimize 会构建静态类映射，从而消除运行时的文件系统扫描。建议在生产环境中使用。
自动加载文件（全局函数）
对于包含全局函数的辅助文件，请在 composer.json 中使用 files 键。这些文件始终会被引入。
// composer.json
{
"autoload": {
"files": ["src/helpers.php"]
}
}自动加载器执行顺序
自动加载器会按照注册顺序调用。如果第一个自动加载器找不到类，它会无错误返回，然后 PHP 会尝试下一个。
调试自动加载问题
“找不到类”的常见原因包括：缺少 dump-autoload、文件名或类名大小写错误，或者 composer.json 中的命名空间前缀不匹配。
PSR-4 与类映射的性能
PSR-4 会执行文件系统状态查询。类映射执行哈希映射查找，速度更快，但每添加一个新类都需要重新生成。
测试自动加载
验证您的自动加载器：
<?php
require 'vendor/autoload.php';
$obj = new \App\Services\EmailService();
echo get_class($obj); // App\Services\EmailService总结
spl_autoload_register 是所有 PHP 自动加载机制的基础。Composer 会处理繁重的工作——添加新类后只需运行 dump-autoload。
快速检查
哪个命令可以重新生成 Composer 自动加载器？
常见问题解答
「注册自动加载器」课时是免费的吗？
是的 — 「注册自动加载器」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 PHP Academy 课程的其余内容，请升级到 CoddyKit PRO。 PHP Academy 课程共包含 4 节课。
「注册自动加载器」这节课中我会学到什么？
设置 spl_autoload_register，并配置基于 Composer 的自动加载。 你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 PHP Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 PHP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「注册自动加载器」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 PHP Academy 课中编写并运行代码吗？
能。每节 PHP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。