autoload-files用于加载非类文件，如函数库、常量定义或初始化代码。在composer.json中通过"files"键指定需自动加载的文件，如src/helpers.php和src/constants.php。配置后运行composer dump-autoload，Composer会将其注册到自动加载流程中，确保这些文件在每次请求时被包含。典型用途包括加载全局函数、定义常量、注册错误处理器等。由于这些文件每次都会执行，应避免直接输出或耗时操作，防止性能问题或函数重定义错误。Composer具备去重机制，但仍需合理组织文件内容以减少副作用。总之，当需要在项目启动时引入非类PHP文件时，autoload-files是最佳选择。
autoload-files 是 Composer 中用于自动加载全局函数或执行特定 PHP 文件的一种机制。它不属于类的自动加载（那是 autoload-classmap 或 autoload-psr4 的职责），而是专门用来加载那些包含函数定义、常量声明或需要在项目启动时运行的代码片段。
作用：确保函数和初始化代码可用
在现代 PHP 项目中，除了类之外，还常常会定义一些辅助函数（如 helpers.php），或者需要提前注册某些行为（比如错误处理器、框架引导）。这些文件不会被类自动加载机制触发，因为它们不对应某个类名。
通过 autoload-files，你可以告诉 Composer 在每次 Composer 自动加载生效时（例如调用 vendor/autoload.php 时），一并包含这些指定的文件。
如何配置 autoload-files
在 composer.json 中，使用 "files" 键来指定要自动加载的文件：
{ "autoload": { "files": ["src/helpers.php", "src/constants.php"] } }
配置完成后，运行 composer dump-autoload，Composer 会生成相应的加载逻辑，将这些文件注册到自动加载流程中。
典型使用场景
- 加载全局函数库（如
helpers.php中的str_contains()等自定义函数） - 定义全局常量或配置项
- 注册事件监听、错误处理、中间件等初始化逻辑
- 兼容旧代码中非类结构的代码组织方式
注意事项
被 files 加载的文件会在每次请求时无条件执行，因此应避免写入直接输出或耗时操作。同时，重复加载可能导致函数重定义错误，所以确保每个文件只被引入一次。
Composer 会通过内部去重机制防止重复加载，但开发者仍需合理组织文件内容，避免副作用。
基本上就这些。只要你想让某个 PHP 文件在项目启动时就被包含进来，而且它又不是类文件，autoload-files 就是正确选择。