PHP自动加载正常但无法调用其他命名空间下的函数问题

问题核心 #

你遇到的问题根源是Composer默认的PSR-4自动加载仅针对类文件，不会自动识别并加载命名空间下的独立函数文件。虽然同命名空间的类能正常加载，但函数文件未被纳入自动加载机制，导致调用时触发“call to undefined function”错误。

解决方案 #

1. 修改composer.json配置 #

在autoload节点中添加files字段，明确指定要自动加载的函数文件路径：

{
    "autoload": {
        "psr-4": {
            "sirJuni\\": "sirJuni/src/"
        },
        "files": [
            "sirJuni/src/Helper/Functions.php"
        ]
    }
}

如果有多个函数文件，可在files数组中依次追加文件路径。

2. 更新自动加载映射 #

执行以下命令让Composer重新生成自动加载文件：

composer dump-autoload

3. 验证调用 #

此时你的原有代码即可正常运行：

<?php
require_once "vendor/autoload.php";

use function sirJuni\Framework\Helper\redirect;

redirect("hello/hi");
?>

原理说明 #

Composer的PSR-4规范基于类名与文件名一一对应的逻辑实现自动加载，而独立函数不属于类范畴，因此不会被自动扫描加载。通过files配置，你可以强制让Composer在初始化自动加载时就引入指定的函数文件，从而让命名空间下的函数被正确识别和调用。

内容的提问来源于stack exchange，提问作者Shoaib Wani