为何调用已存在的App\Sensorario\run函数提示未定义？Composer自动加载问题

问题场景 #

1. Composer配置（composer.json） #

{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

2. 函数定义文件（src/Sensorario/run.php） #

namespace App\Sensorario;

function run() {
    // do something
}

3. 调用代码（public/index.php） #

<?php

require_once __DIR__ . '/../vendor/autoload.php';

use function App\Sensorario\run;

$result = run();

4. 错误提示 #

Uncaught Error: Call to undefined function App\Sensorario\run()

已执行操作：

• composer dump-autoload
• composer install
• 检查Composer生成的所有文件

问题原因 #

PSR-4自动加载规范默认仅针对类、接口、Trait生效，Composer的自动加载器不会主动扫描文件中的独立函数并生成映射关系。因此即使文件路径和命名空间匹配，包含独立函数的文件也不会被自动加载。

解决方法 #

方法1：手动引入函数文件 #

在调用代码中直接引入函数所在文件：

<?php
require_once __DIR__ . '/../vendor/autoload.php';
// 手动引入函数文件
require_once __DIR__ . '/../src/Sensorario/run.php';

use function App\Sensorario\run;

$result = run();

缺点：失去自动加载的便利性，仅适合临时场景。

方法2：使用Composer的files自动加载规则 #

修改composer.json，添加files字段指定需要预加载的函数文件：

{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        },
        "files": [
            "src/Sensorario/run.php"
        ]
    }
}

修改后执行composer dump-autoload，Composer会将这些文件加入自动加载列表，在初始化autoloader时就完成加载，之后即可直接调用函数。

方法3：将函数封装为类的静态方法（推荐） #

遵循PSR-4的设计初衷，把函数封装到类中作为静态方法：

// src/Sensorario/Runner.php
namespace App\Sensorario;

class Runner {
    public static function run() {
        // do something
    }
}

调用代码修改为：

<?php
require_once __DIR__ . '/../vendor/autoload.php';

use App\Sensorario\Runner;

$result = Runner::run();

这种方式完全适配PSR-4自动加载机制，无需额外配置，也是PHP项目中更规范的写法。

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