PHP自定义自动加载器报错：未找到FFI\Exception类

你的问题核心是：自定义自动加载器拦截了PHP内置类的加载请求，但没有在无法处理时让PHP的默认加载流程继续执行。FFI\Exception是PHP扩展提供的内置类，并非你项目中的自定义类，所以你的自动加载器找不到对应文件，又阻止了PHP用默认方式加载它。

问题原因 #

你当前的自动加载器在找不到文件时没有返回false，PHP会认为加载逻辑已经完成，不会尝试调用其他自动加载器（包括PHP内置的），导致内置的FFI\Exception无法被加载。

解决方法 #

1. 修改自动加载器，返回false让PHP继续处理 #

当自定义加载器无法找到类文件时，必须返回false，这样PHP才会触发后续的自动加载机制，包括加载内置类的逻辑。

修改后的代码：

<?php

spl_autoload_register(function ($class){
    $class_file = str_replace("\\", "/", $class) . ".php";

    if(file_exists($class_file)) {
        require_once $class_file;
        return true; // 明确标记加载成功
    }

    // 找不到文件，返回false让PHP尝试其他自动加载器
    return false;
});

?>

2. 可选优化：提前排除内置命名空间 #

为了避免对PHP内置类做无效的文件检查，可以直接判断类名是否属于PHP内置命名空间（比如FFI\、PDO\等），直接返回false让默认加载器处理：

<?php

spl_autoload_register(function ($class){
    // 排除FFI等PHP内置命名空间
    $builtInNamespaces = ['FFI\\', 'PDO\\', 'DateTime\\'];
    foreach ($builtInNamespaces as $ns) {
        if (str_starts_with($class, $ns)) {
            return false;
        }
    }

    $class_file = str_replace("\\", "/", $class) . ".php";

    if(file_exists($class_file)) {
        require_once $class_file;
        return true;
    }

    return false;
});

?>

关键说明 #

• spl_autoload_register的回调函数返回值决定了PHP是否继续尝试其他自动加载器：返回false时，PHP会继续调用下一个注册的自动加载器；返回true或无返回值时，PHP会停止加载流程。
• 内置类的加载由PHP本身处理，不需要你的自动加载器介入，所以遇到内置命名空间的类时直接放行即可。

内容的提问来源于stack exchange，提问作者Gianluca Starke