直接在composer.json的"files"中写相对于该文件的路径并运行composer dump-autoload即可全局调用函数；路径错误、未执行命令或文件含副作用会导致静默失效。
直接把函数文件路径写进 composer.json 的 "files" 数组，再运行 composer dump-autoload，函数就能在任何地方直接调用——但路径写错、没执行命令、或文件里有副作用，都会让它静默失效。
files 配置必须用相对于 composer.json 的路径
Composer 不会帮你猜路径。"files" 里的每个字符串，都是从 composer.json 所在目录开始算的绝对路径（相对路径）。比如你的 composer.json 在项目根目录，函数文件放在 src/functions.php，那就得写 "src/functions.php"，不能写 "functions.php" 或 "./src/functions.php"。
- 错误示例：
"functions.php"→ Composer 会在根目录找，找不到就跳过，不报错 - 正确写法：
"src/functions.php"（假设文件真实存在该位置） - 多个文件按需列出：
"files": ["src/helpers.php", "config/constants.php"]
改完 composer.json 后必须手动运行 dump-autoload
Composer 不监听文件变化。你改了 composer.json 的 "files"，不运行命令，vendor/autoload.php 就完全不知道这回事——它只认 vendor/composer/autoload_files.php 里已生成的列表。
- 开发时执行：
composer dump-autoload - 生产环境可加优化参数：
composer dump-autoload --optimize（会合并进autoload_files.php，但调试阶段建议不用） - 验证是否生效：在任意 PHP 文件中调用你的函数，比如
helper_now()；如果报Call to undefined function，大概率是没跑命令，或路径不对
files 文件里不能有运行时副作用
"files" 列表中的每个 PHP 文件，会在每次加载 vendor/autoload.php 时被 require_once 执行一次。这意味着：它不是“按需加载”，而是“无条件加载”。
- ✅ 允许：定义函数、
define()常量、声明class_alias - ❌ 禁止：直接
echo、new实例、file_get_contents、连接数据库等——这些逻辑会在框架启动、CLI 命令、甚至单元测试初始化时就被触发 - ⚠️ 注意：多个
files按数组顺序执行，后加载的文件能覆盖前面定义的同名函数（除非加function_exists()防护）
别和 psr-4/classmap 混用时指望“优先级”
"files" 不参与类加载流程，它只是全局脚本注入点。它的执行时机在所有类加载器注册之后、首次类访问之前，但它本身不决定“哪个类该从哪加载”。
- PSR-4 和 classmap 解决的是
class_exists()或new Xxx的路径问题；files解决的是函数/常量可用性问题 - 如果你在
files里require了一个类文件，又在 psr-4 里也映射了同一个类，PHP 会报Cannot declare class Xxx—— 因为files是无条件先执行的 - 想让辅助函数支持命名空间或依赖注入？别硬塞进
files，改用独立的类 + PSR-4 加载更可控
最容易被忽略的一点：当项目用了多个 Composer 包（比如私有 repo 或 monorepo），且各自都配置了 "files"，它们的加载顺序由 Composer 内部决定，不可控。有强依赖关系时，宁可合并成一个文件，或改用 classmap + 显式调用。
