PHP MVC项目PSR-4命名空间自动加载失效，请求技术支持

核心错误原因分析 #

报错Class "App\Controllers\BaseController" not found本质是PSR-4自动加载规则未被正确遵循，同时存在手动加载与自动加载冲突、文件名与类名不匹配的问题。

具体修复步骤 #

1. 修正文件名以匹配PSR-4规范 #

PSR-4要求类名与文件名完全大小写一致，否则自动加载无法识别：

• 将app/controllers/home.php重命名为app/controllers/Home.php
• 将app/controllers/textTranslator.php重命名为app/controllers/TextTranslator.php
• 将app/models/languages.php重命名为app/models/Languages.php
• 将app/core/Controllers.php重命名为app/core/Controller.php（确保该文件类名为Controller）

2. 清理手动加载的冲突代码 #

init.php中手动引入了大量命名空间类，会与Composer自动加载逻辑冲突，修改app/init.php为：

<?php
// 仅保留自动加载和非类文件
require_once 'vendor/autoload.php';
require_once 'core/session.php';
require_once 'core/config.php';
require_once 'core/functions.php';
?>

（所有命名空间类如Controller、App、CSRFHelper均由Composer自动加载，无需手动引入）

3. 更新Composer自动加载映射 #

在app目录下打开命令行，执行以下命令生成最新的类映射文件：

composer dump-autoload

该命令会更新vendor/composer/autoload_psr4.php，确保Composer能正确关联命名空间与文件路径。

4. 优化命名空间引用（规范优化） #

Home.php已处于App\Controllers命名空间下，同命名空间的BaseController无需额外use，修改代码为：

namespace App\Controllers;
use App\Models\User;

class Home extends BaseController {
    // 类逻辑
}

5. 验证核心类命名空间 #

确保app/core/Controller.php的命名空间正确：

namespace App\Core;

class Controller {
    // 基类逻辑
}

完成以上步骤后，重新访问项目，BaseController找不到的错误即可解决。

内容的提问来源于stack exchange，提问作者Rishabh Raj