PHP 8 中配置 PSR-4 自动加载的核心是正确声明 composer.json 的 autoload.psr-4 映射（命名空间须双反斜杠结尾、路径以正斜杠结尾），确保类文件路径与命名空间严格逐字符对应，并执行 composer dump-autoload 生成 vendor/composer/autoload_psr4.php 静态映射表，最后在入口文件引入 vendor/autoload.php。
PHP 8 中配置 PSR-4 自动加载，核心是通过 composer.json 声明命名空间与目录映射，并借助 Composer 生成标准加载器。整个过程不依赖 PHP 版本特性（PSR-4 在 PHP 5.3+ 即可运行），但 PHP 8 的严格类型和错误提示能更快暴露配置错误，比如大小写不一致或反斜杠误写。
1. 编写正确的 composer.json autoload 配置
在项目根目录的 composer.json 文件中，确保 autoload 字段按 PSR-4 规范书写：
- 命名空间前缀必须以双反斜杠结尾（JSON 中写为
"App\": "app/"），这是匹配的硬性条件，缺一个就无法识别； - 路径值以正斜杠结尾（如
"app/"），且是相对于composer.json的相对路径，不能写成"./app"或"app"； - 支持多个前缀，例如同时管理后台和 API 模块：
"autoload": {
"psr-4": {
"App\": "app/",
"Admin\": "admin/",
"Api\": "api/"
}
}
2. 保证类文件结构与命名空间完全对应
PSR-4 要求命名空间层级、目录层级、类名三者严格一一映射，且大小写敏感（尤其影响 Linux 生产环境）：
-
namespace AppHttpControllers;→ 必须存于app/Http/Controllers/目录下； - 类名为
LoginController→ 文件名必须是LoginController.php，不能是logincontroller.php或login_controller.php； - 子命名空间
AppModelsBlogPost→ 对应路径为app/Models/Blog/Post.php，中间不可跳级或合并目录。
3. 生成并引入自动加载器
配置完成后，必须手动触发映射表重建：
立即学习“PHP免费学习笔记（深入）”；
- 执行命令：
composer dump-autoload（不是install或update，它们不会重读 autoload 配置）； - 该命令会更新
vendor/composer/autoload_psr4.php—— 这是一个静态映射数组，运行时不扫描磁盘； - 在入口文件（如
index.php或public/index.php）顶部引入：require __DIR__ . '/../vendor/autoload.php';
4. 验证是否生效
快速确认配置正确性的方法：
- 运行
composer show --platform查看当前已注册的 PSR-4 映射； - 临时加一行测试代码：
php -r "var_dump(class_exists('AppHttpControllersHomeController'));"，返回true表示成功； - 故意把命名空间写错（如
App/Http用正斜杠），观察是否报Class not found—— PHP 8 的错误信息更明确，能直接指出哪一级不匹配。
