Composer本地包如何通过Path仓库实现热重载-composer-PHP中文网

必须启用符号链接并执行composer update acme/utils，禁用classmap权威模式和opcache，windows需管理员权限；否则默认复制或缓存导致修改不生效。

composer本地包如何通过path仓库实现热重载

Composer 本地包本身不提供热重载能力，但通过 path 类型仓库 + 符号链接 + 正确的自动加载配置，可以实现「改完即生效」的开发体验——前提是 PHP 进程每次请求都重新解析类文件，而不是固化映射。

为什么改了本地包代码，主项目里没反应

常见错误现象是：你改了 ../my-package/src/Helper.php，但在主项目中调用 new Helper() 仍是旧逻辑。根本原因不是 Composer 没“看见”改动，而是：

默认 composer install 对 path 包走的是复制（copy）模式，改源目录 ≠ 改 vendor 目录
即使启用了符号链接（symlink），如果用了 composer dump-autoload -o，类路径被写死进 vendor/composer/autoload_classmap.php，新类或修改后的方法不会自动识别
OPcache 或 APCu 缓存了已加载的类定义，PHP 不会重新读取文件
某些框架（如 Laravel Octane、Swoole）常驻内存，autoload.php 只在启动时加载一次

必须启用 symlink 并执行 update 才能生效

path 仓库默认不自动创建符号链接；它只在 composer require 或 composer update 时按需生成。且 composer install 不会刷新已有链接的目标路径——哪怕你改了本地包的 Git 分支或文件内容。

Discussion Composer

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

下载

在主项目 composer.json 的 repositories 条目中加 "options": {"symlink": true}
确保本地包目录下有合法 composer.json，且 name（如 "acme/utils"）与 require 中完全一致
版本约束必须用 dev-main、dev-develop 等分支名，不能写 1.0.0
执行 composer update acme/utils（不是 install 或 dump-autoload）才会重建 symlink
验证是否成功：ls -la vendor/acme/utils 应显示 -> ../my-package（Linux/macOS）；Windows 用户用 dir vendor\acme\utils 看是否为“快捷方式”类型

autoload 配置必须禁用 classmap 权威模式

热重载依赖 PSR-4 的动态路径查找机制。一旦启用 -o（optimize）或 -a（classmap-authoritative），Composer 就把所有类路径固化成静态数组，后续文件变更完全无效。

开发期不要运行 composer dump-autoload -o 或 composer dump-autoload -a
确保 vendor/autoload.php 加载的 $loader 实例未开启权威模式：$loader->setClassMapAuthoritative(false)
如有 APCu 缓存，禁用前缀：$loader->setApcuPrefix(null)
若用 OPcache，需配合 opcache_invalidate() 或设置 opcache.revalidate_freq=0（仅开发环境）