Composer 通过 "files" 字段实现 PHP 函数文件的无条件一次性自动加载，需在 composer.json 的 autoload.files 中配置相对路径，修改后运行 composer dump-autoload 生效，并支持多文件按序加载。
Composer 支持直接加载 PHP 函数文件（即包含纯函数定义、无类声明的 .php 文件），通过 "files" 自动加载机制实现。它会在每次调用 composer autoloader（例如执行 require 'vendor/autoload.php'）时，**无条件、一次性地包含**指定的文件，适合加载全局辅助函数、常量定义或启动逻辑。
在 composer.json 中配置 files 字段
将函数文件路径写入 composer.json 的 "autoload": {"files": [...]} 中。路径支持相对路径（相对于 composer.json 所在目录）：
- 路径必须是可被
include的有效 PHP 文件（如src/helpers.php） - 支持多文件，按数组顺序依次加载（注意函数重定义问题）
- 修改后需运行
composer dump-autoload生效（开发中建议加-o生成优化加载器）
示例：添加 helpers.php 并启用自动加载
假设项目根目录下有 src/helpers.php，内容为：
function str_slug($str) {
return strtolower(trim(preg_replace('/[^\w\s]/', '', $str)));
}
在 composer.json 中添加：
"autoload": {
"files": ["src/helpers.php"]
}
执行：composer dump-autoload
之后在任意脚本中引入 autoload 后即可直接使用 str_slug()：
require 'vendor/autoload.php';
echo str_slug('Hello World!'); // hello world
注意事项与常见问题
- 不支持命名空间或类自动发现：files 加载的是“硬包含”，和 PSR-4/PSR-0 无关，仅用于函数/常量/执行语句
-
避免重复加载：不要在多个 files 条目中重复包含同一文件；也不要手动再
include已声明的 files -
区分开发与生产环境：如只需开发时加载（如调试函数），可用
"autoload-dev"字段代替"autoload" - 路径错误会导致 fatal error：确保文件存在且可读，Composer 不会跳过缺失的 files 项
验证是否生效
检查生成的 autoloader 文件（vendor/composer/autoload_files.php），应能看到类似条目：
return array(
$vendorDir . '/../../src/helpers.php',
);
该数组由 Composer 自动生成，确认存在即表示配置已生效。
