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.<a style="color:#f60; text-decoration:underline;" title="php" href="https://www.php.cn/zt/15714.html" target="_blank">php</a>", "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是“一开始就加载”，不管有没有调用，也不管命名空间，纯粹靠路径硬引入 - 两者互不干扰，可以共存：一个管类，一个管函数 / 常量
基本上就这些。不复杂但容易忽略细节，尤其是执行时机和 作用域 问题。
以上就是 Composer 中的 autoload-files 是如何工作的？（加载全局函数库）的详细内容，更多请关注 php 中文网其它相关文章！
