composer的files配置不支持热加载，因其仅在引入vendor/autoload.php时无条件require_once指定文件，不监听文件变更、不触发重编译，修改后需重启php进程或重置opcache才能生效。

Composer 不支持任何文件类型的“热装载”——修改 helpers.php 或 constants.php 后，不会自动重新加载，也不会触发重编译或刷新映射。

为什么 files 配置不等于热加载

files 是一次性、无条件的 require_once，发生在 vendor/autoload.php 被引入的那一刻。它没有监听文件变更、不依赖 inotify 或 filemtime 检查，也不介入 PHP 请求生命周期之后的任何阶段。

• 修改 src/helpers.php 后，下次请求仍执行旧版本，除非重启 PHP 进程（如 CLI 脚本结束、FPM worker 重启）或手动重载 opcache
• composer dump-autoload 不扫描文件内容，只把路径写进 vendor/composer/autoload_files.php —— 这个文件本身不包含逻辑，只是列表
• 即使你用 opcache.preload 预热了这些文件，预加载后修改仍需 opcache_reset() 或重启 Web 服务器才能生效

常见误以为“热”的场景及真实原因

有些项目看起来“改完函数就生效”，其实靠的是外部机制，不是 Composer 本身：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 开发环境用 php -S 时，每次请求都重新启动进程，自然载入新文件 —— 这是 PHP 内置服务器行为，非 Composer 功能
• 使用 Laravel Mix / Vite 等前端工具配合 PHP 后端时，前端 HMR 与后端无关，容易混淆“页面刷新=PHP 重载”
• 某些 IDE（如 PHPStorm）在调试模式下会强制清空 opcache，造成“改完即见”的假象
• CI/CD 流水线中每次部署都 composer install --no-dev + 重启服务，掩盖了无热加载的事实

真需要热加载函数怎么办

只能绕过 Composer 的 files，自己控制加载时机：

• 把函数定义放进类里，用 PSR-4 加载，再通过单例或服务容器管理实例 —— 类可被替换，方法可重写
• 用 include 替代 require_once，并在关键入口处加 clearstatcache(); 和时间戳判断，但注意并发和性能损耗
• 开发期用 autoload-dev.files + 自定义脚本监听文件变更（如 inotifywait），触发 composer dump-autoload 并通知 FPM reload —— 复杂且仅限本地
• 接受现实：PHP 本质不支持运行时函数重定义，function_exists() 检查 + include 是最稳妥的兜底方案

真正容易被忽略的点：很多人把 files 当作“自动加载函数”的捷径，却没意识到它和 PSR-4 类加载一样，都是静态映射 —— 只不过一个是类名→文件，一个是路径→立即执行。两者都不感知源码变更，也不提供 hook。要动态，就得自己写 loader，或者换语言。