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.php",
      "src/constants.php"
    ]
  },
  "autoload-dev": {
    "files": [
      "tests/test-helpers.php"
    ]
  }
}

运行 composer dump-autoload 后，这些文件就纳入了自动加载流程。

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

注意事项和常见坑

这些文件会在所有自动加载场景中被执行，包括 CLI 脚本、Web 请求、测试环境等。所以要注意：

• 不能有重复定义：比如多次声明同名函数会报 Fatal error: Cannot redeclare xxx()；建议用 function_exists() 包裹
• 不要做耗时操作：比如连接数据库、读大文件——它在 autoload 初始化阶段就跑，影响所有请求启动速度
• 路径是相对于 composer.json 的：写错相对路径会导致文件找不到，但 Composer 不报错，只静默跳过（可加 die('loaded'); 快速验证是否生效）
• 开发环境和生产环境可能不同：如果只放在 autoload-dev，线上部署时不会加载，要小心功能缺失

和普通类自动加载的区别

autoload-files 和 PSR-4/PSR-0 是两套机制：

• PSR-4 是“用到才加载”，靠命名空间映射路径，延迟且按需
• files 是“一开始就加载”，不管有没有调用，也不管命名空间，纯粹靠路径硬引入
• 两者互不干扰，可以共存：一个管类，一个管函数/常量

基本上就这些。不复杂但容易忽略细节，尤其是执行时机和作用域问题。