autoload-files 是 Composer 的预加载机制，会在引入 vendor/autoload.php 时无条件、立即执行指定 PHP 文件，适用于全局函数、常量等；通过 composer.json 的 autoload 或 autoload-dev 中 files 数组配置，运行 dump-autoload 后生效。
Composer 的 autoload-files 用于在每次 Composer 自动加载启动时，**无条件、提前载入指定的 PHP 文件**，适合放全局函数定义、常量声明或辅助工具函数等不依赖类结构的代码。
它怎么被触发？
当你执行 composer dump-autoload（或安装/更新时自动触发），Composer 会把 autoload-files 列表里的文件路径写进生成的 vendor/autoload.php 中。之后只要引入这个文件（比如 require 'vendor/autoload.php';），这些文件就会立即执行——**不是按需加载，而是“一劳永逸”式预加载**。
如何配置？
在 composer.json 的 autoload 或 autoload-dev 段里添加 files 数组：
{
"autoload": {
"files": [
"src/helpers.php",
"src/constants.php"
]
},
"autoload-dev": {
"files": [
"tests/test-helpers.php"
]
}
}
运行 composer dump-autoload 后，这些文件就纳入了自动加载流程。
注意事项和常见坑
这些文件会在所有自动加载场景中被执行，包括 CLI 脚本、Web 请求、测试环境等。所以要注意：
-
不能有重复定义：比如多次声明同名函数会报
Fatal error: Cannot redeclare xxx()；建议用function_exists()包裹 - 不要做耗时操作：比如连接数据库、读大文件——它在 autoload 初始化阶段就跑，影响所有请求启动速度
-
路径是相对于 composer.json 的：写错相对路径会导致文件找不到，但 Composer 不报错，只静默跳过（可加
die('loaded');快速验证是否生效） -
开发环境和生产环境可能不同：如果只放在
autoload-dev，线上部署时不会加载，要小心功能缺失
和普通类自动加载的区别
autoload-files 和 PSR-4/PSR-0 是两套机制：
- PSR-4 是“用到才加载”，靠命名空间映射路径，延迟且按需
-
files是“一开始就加载”，不管有没有调用，也不管命名空间，纯粹靠路径硬引入 - 两者互不干扰，可以共存：一个管类，一个管函数/常量
基本上就这些。不复杂但容易忽略细节，尤其是执行时机和作用域问题。
