PHP 8.2 本身不提供自动加载功能，真正实现的是 Composer 生成的 PSR-4 加载器；需在 composer.json 中精准配置 autoload.psr-4（命名空间双反斜杠结尾、路径正斜杠结尾）、确保文件结构与命名空间逐字符对应，并执行 composer dump-autoload 后引入 vendor/autoload.php。
PHP 8.2 本身不提供自动加载功能，它只是严格执行 PSR-4 规范的运行环境。真正实现自动加载的是符合 PSR-4 的加载器，最常用、最可靠的方式仍是通过 Composer 配置并生成标准加载器——PHP 8.2 的严格类型检查和清晰错误提示，反而让配置错误（如大小写、反斜杠方向、路径结尾）更容易被发现和修正。
composer.json 配置必须精准
在项目根目录的 composer.json 中，autoload.psr-4 字段是核心。以下三点缺一不可：
- 命名空间前缀必须以双反斜杠结尾，JSON 中写作
"App\": "app/"（单个反斜杠会被 JSON 解析为转义，必须写两个） - 路径值必须以正斜杠结尾，如
"app/"，不能是"app"、"./app/"或"app\" - 支持多前缀，例如同时管理应用与测试代码：
"App\": "app/", "Tests\": "tests/"
文件结构与命名空间逐字符对应
PSR-4 是纯字符串映射，不扫描、不猜测。PHP 8.2 在 Linux 环境下大小写敏感，一旦出错立即报 Class not found：
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
-
namespace AppHttpControllers;→ 必须放在app/Http/Controllers/目录下 - 类名
LoginController→ 文件名必须是LoginController.php（不能是logincontroller.php或Login_controller.php） -
AppModelsBlogPost→ 对应路径为app/Models/Blog/Post.php，中间层级不可省略或合并
生成并启用加载器
配置完 composer.json 后，必须执行命令生成静态映射表：
立即学习“PHP免费学习笔记（深入）”；
- 运行
composer dump-autoload（不是 install/update，它们不一定重读 autoload） - 该命令会更新
vendor/composer/autoload_psr4.php，这是一个纯数组，运行时无 I/O 开销 - 在入口文件（如
public/index.php）顶部引入：require __DIR__ . '/../vendor/autoload.php';
快速验证是否生效
别等运行时报错才排查，用这几条命令即时确认：
-
composer show --platform查看当前注册的所有 PSR-4 映射 -
php -r "var_dump(class_exists('AppHttpControllersHomeController'));"返回bool(true)表示成功 - 故意把命名空间写成
App/Http（正斜杠），PHP 8.2 会明确提示“Class 'App/HttpControllersHomeController' not found”，帮你快速定位问题点
