XAMPP环境下PHP基于命名空间的autoloading无法加载类问题咨询

云上老周

2026-9-28

XAMPP环境下PHP命名空间自动加载路径错误修复方案

错误说明

你遇到的报错翻译如下：

警告：require_once(C:/xampp/htdocs/app/admin/modules/smartForm/smartForm.php)：未能打开流：没有对应文件或目录，错误位于 C:\xampp\htdocs\php\smartfrom\app\system\autoLoader.php 第3行

问题根因

路径拼接逻辑错误：你使用的$_SERVER["DOCUMENT_ROOT"]指向XAMPP默认站点根目录C:/xampp/htdocs，但你的实际项目存放在站点根目录下的php/smartfrom/子目录中，自动加载器拼接路径时缺少了项目所在的子目录前缀，导致找不到类文件。
原自动加载代码末尾缺失分号，存在语法错误隐患。

修复方案

方案1：调整站点根目录配置（推荐，适配生产环境逻辑）

修改XAMPP中Apache的httpd.conf配置文件，将DocumentRoot和对应的<Directory>配置项值改为你的项目根目录C:/xampp/htdocs/php/smartfrom，重启Apache后原有自动加载代码即可正常运行。

方案2：修改自动加载代码（无需改站点配置，适合本地调试）

基于自动加载文件的位置计算项目根目录，避免依赖站点配置的路径，修改后代码如下：

spl_autoload_register(function($className){
    // 自动加载文件位于app/system下，往上追溯2级就是项目根目录
    $projectRoot = dirname(__DIR__, 2) . '/';
    require_once($projectRoot . str_replace('\\', '/', $className) . '.php');
});