Composer 仅支持通过 autoload.files 加载全局函数文件，需在 composer.json 的 autoload 对象下配置 files 数组，路径相对项目根目录，仅支持具体文件或 glob 通配符；修改后须运行 composer dump-autoload 生效，且文件仅允许定义函数、常量等无副作用逻辑。
Composer 只能通过 autoload.files 加载全局函数文件，没有其他官方支持方式；写错路径、漏跑命令、文件含副作用，都会导致函数“找不到”且不报错。
composer.json 里怎么写 files 配置
必须放在 autoload 对象下，键名是 files（不是 autoload.files，后者根本无效）：
{
"autoload": {
"files": [
"src/functions.php",
"src/Helpers/str.php",
"config/constants.php"
]
}
}
- 路径是相对于
composer.json所在目录的，不能写functions.php或./src/functions.php—— 前者被当成当前工作目录，后者多余点斜杠，都不可靠 - 不支持目录，只支持具体 PHP 文件；通配符如
"src/Helpers/*.php"可用，但必须用双引号包裹，且依赖系统glob()支持 - 多个文件按数组顺序加载，后面文件里同名函数会覆盖前面的（PHP 不允许重复定义，所以会直接
Fatal error: Cannot redeclare）
为什么改了 composer.json 函数还是 undefined
因为 Composer 不监听文件变化，vendor/autoload.php 不会自动更新。你必须手动触发生成逻辑：
- 运行
composer dump-autoload（开发调试时推荐） - 或
composer install/composer update（也会顺带执行） - 加
-o参数可生成优化版映射（composer dump-autoload -o），但调试阶段建议不用，否则错误不易暴露
验证是否生效：在任意 PHP 脚本中加一句 var_dump(get_included_files());，看输出里有没有你的函数文件路径；或者在函数文件开头加 echo "loaded\n";，然后执行 php -r "require 'vendor/autoload.php';" 看是否输出。
函数文件里能写什么、不能写什么
它会在每次 require 'vendor/autoload.php' 时被 require_once 执行一次 —— 这不是“按需加载”，而是“无条件加载”：
- ✅ 允许：定义函数、
define()常量、class_alias() - ❌ 禁止：
echo、file_get_contents()、new实例、数据库连接、HTTP 请求等副作用逻辑——这些会在 CLI 命令、单元测试、甚至框架启动时就执行，极易出错或拖慢所有请求 - ⚠️ 注意：文件权限、大小写敏感（Linux 下
Helpers.php≠helpers.php）、语法错误（一个Parse error就会让整个 autoload 中断，连类都加载不了）
什么时候该停用 files、转用类封装
当函数开始需要依赖注入、条件加载、或出现职责交叉（比如某个函数要读配置、发 HTTP、再处理数据），说明它已超出“纯工具函数”范畴：
- 继续塞在
files里会导致副作用难以收敛、测试困难、环境耦合加重 - 应重构为服务类，用 PSR-4 自动加载，通过容器管理生命周期和依赖
-
files的定位很窄：只适合无状态、无依赖、无副作用的辅助函数（如str_slug()、array_only()）
最常被忽略的不是语法，而是加载时机和作用域污染——它不是“函数自动加载器”，而是“全局脚本注入点”。
