Composer 通过 autoload.files 可无条件自动加载指定 PHP 文件，需在 composer.json 中配置相对路径并运行 composer dump-autoload；文件仅初始化时加载一次，应仅含函数/常量定义，避免执行逻辑与语法错误。
Composer 可以通过 autoload.files 配置项自动加载指定的 PHP 文件（比如存放全局函数的 functions.php），这些文件会在每次 Composer 自动加载初始化时被无条件引入一次，适合放纯函数定义、常量或辅助代码。
在 composer.json 中配置 files autoload
编辑项目根目录下的 composer.json，在 autoload 字段中添加 files 数组，列出需自动加载的文件路径（相对于 composer.json 所在目录）：
{
"autoload": {
"files": [
"src/helpers/functions.php",
"src/constants.php"
]
}
}
修改后运行：
composer dump-autoload
这样每次执行 require 'vendor/autoload.php' 时，上述文件就会被立即执行并载入函数/常量。
注意路径和执行时机
files 列表中的路径必须是真实存在的 PHP 文件，且不能包含语法错误，否则整个自动加载会失败；它们只会在 Composer 的 autoloader 初始化时加载一次，不会按需加载（即不支持“懒加载”）。
- 路径推荐用相对路径，避免硬编码绝对路径
- 文件内不要写执行逻辑（如 echo、new 实例等），只放函数声明、const 定义等无副作用代码
- 如果文件依赖其他类或函数，确保其加载顺序合理（
files按数组顺序依次引入）
开发中调试是否生效
可临时在 functions.php 里加一句 echo "functions loaded\n";，然后运行一个简单脚本测试：
<?php require 'vendor/autoload.php'; // 若看到输出，说明 files 已生效 my_helper_function(); // 假设这是 functions.php 里定义的函数 ?>
若没输出或报错，检查路径是否拼写正确、是否执行了 dump-autoload、是否有 PHP 语法问题。
基本上就这些 —— 不复杂但容易忽略路径和执行时机这两个关键点。
