autoload.files 是唯一能直接加载全局函数文件的机制，它在每次引入 composer autoloader 时无条件启动即加载；psr-4 不支持纯函数，而 autoload.files 通过在 vendor/autoload.php 中插入 require 语句来加载工具函数、常量等副作用型文件。
Composer 的 autoload.files 是唯一能直接加载全局函数文件的机制，它会在每次 composer autoloader 被引入时无条件执行——不是按需加载，而是启动即加载。
为什么用 autoload.files 而不是 PSR-4？
PSR-4 只支持类、接口、trait 的自动加载，无法处理纯函数定义；而 autoload.files 本质是让 Composer 在生成的 vendor/autoload.php 中插入 require 语句，适合加载工具函数、常量定义、辅助配置等“副作用型”文件。
- 函数必须在文件顶层定义（不能包裹在
if或函数体内） - 多个文件会按数组顺序依次
require，注意依赖顺序 - 修改后必须运行
composer dump-autoload才生效（开发中可加-o优化）
如何在 composer.json 中配置
在 autoload 字段下添加 files 数组，路径为相对于 composer.json 的位置：
{
"autoload": {
"files": [
"src/helpers.php",
"src/constants.php"
]
}
}
配置完成后执行：
composer dump-autoload
之后只要引入 vendor/autoload.php，这两个文件就会立即执行，其中定义的函数即可全局调用。
常见错误：函数未定义或重复定义
典型现象是报错 Call to undefined function xxx() 或 Cannot redeclare xxx()，原因多为：
-
src/helpers.php路径写错，或文件实际不存在（Composer 不校验路径有效性） - 该文件又被其他地方手动
require或include，导致重复加载 - 函数定义前有
return、exit或条件分支提前终止执行 - 使用了短标签
而非完整<?php，且服务器未开启short_open_tag
进阶：仅在开发环境加载调试函数
Composer 本身不支持环境区分的 files 加载，但可通过间接方式实现：
- 在
autoload.files中只加载一个入口文件（如src/dev-loader.php） - 该文件内判断
$_ENV['APP_ENV'] === 'dev'或检查defined('PHPUNIT_RUNNING') - 条件性
require实际的调试函数文件
这样既保持 composer.json 简洁，又避免生产环境加载无关逻辑。
真正容易被忽略的是：一旦把函数文件加入 autoload.files，它就丧失了“按需”的可控性——哪怕只调用一个类，这些文件也会被执行。所以只放真正需要全局可用、无副作用、且加载开销小的代码。
