如何通过Composer与PSR规范加载无类的命名空间函数？

嘿，这个问题我之前帮不少开发者捋清楚过——Composer完全支持加载命名空间下的独立函数，只是得用和类加载不一样的配置方式，下面一步步给你讲明白：

虽然是独立函数，但最好还是遵循PSR-4的命名空间结构来存放，这样整个项目的目录结构保持一致，后期维护也更清晰。举个例子：
假设你的库的根命名空间是MyLibrary，那么：

• 项目根目录
  • src/
    • Utils/
      • functions.php # 存放MyLibrary\Utils命名空间下的工具函数
    • Math/
      • calculations.php # 存放MyLibrary\Math命名空间下的数学计算函数

在函数文件里，必须先声明对应的命名空间，比如src/Utils/functions.php的内容：

<?php

namespace MyLibrary\Utils;

// 截断字符串的工具函数
function string_truncate(string $str, int $length): string {
    return mb_strlen($str) > $length ? mb_substr($str, 0, $length) . '...' : $str;
}

// 扁平化数组的工具函数
function array_flatten(array $arr): array {
    $result = [];
    array_walk_recursive($arr, function($item) use (&$result) {
        $result[] = $item;
    });
    return $result;
}

根据你的函数数量和使用场景，有两种常用的配置方式：

方案1：files自动加载（推荐用于高频使用的工具函数） #

这种方式会在Composer初始化自动加载时，直接把指定的函数文件包含进来，函数可以随时调用。在composer.json的autoload节点下添加files数组：

{
    "name": "yourname/your-library",
    "autoload": {
        "psr-4": {
            "MyLibrary\\": "src/"
        },
        "files": [
            "src/Utils/functions.php",
            "src/Math/calculations.php"
        ]
    }
}

修改完配置后，一定要执行这个命令让配置生效：

composer dump-autoload

方案2：classmap自动加载（适合函数文件较多的场景） #

如果你的函数分散在多个目录，不想手动逐个添加文件路径，可以用classmap让Composer自动扫描指定目录下的所有文件（包括类文件和函数文件）。配置如下：

{
    "name": "yourname/your-library",
    "autoload": {
        "psr-4": {
            "MyLibrary\\": "src/"
        },
        "classmap": [
            "src/Utils/",
            "src/Math/"
        ]
    }
}

同样执行composer dump-autoload更新自动加载映射文件。

配置完成后，你就可以在项目中通过命名空间直接调用函数了，两种方式可选：

<?php

// 先引入Composer的自动加载文件
require __DIR__ . '/vendor/autoload.php';

// 方式1：use导入单个函数，直接调用
use MyLibrary\Utils\string_truncate;
echo string_truncate("这是一段需要截断的长文本", 15);

// 方式2：使用完整命名空间调用（无需use）
echo MyLibrary\Utils\array_flatten([[1, 2], [3, 4], [5]]);

• 永远不要在全局命名空间下定义函数，一定要放在自己的库命名空间里，避免和其他第三方库的函数重名冲突。
• 如果函数数量较多，建议按功能拆分到不同的文件中，比如把字符串处理、数组处理的函数分别放在不同文件，方便后期维护。
• 每次修改composer.json的自动加载配置后，必须执行composer dump-autoload，否则新的配置不会生效。

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