Composer中的autoload-files是如何工作的？（加载全局函数库）

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 后，这些文件就纳入了自动加载流程。

标签： php js json composer 工具 区别 开发环境 作用域 red