深入探讨Composer镜像源同步时的软链接与目录重排逻辑-composer-PHP中文网

因为composer将vendor目录设计为完全受控区域，每次install/update都会清空重装，手动创建的软链接必然被删除；正确做法是用path仓库配合"options":{"symlink":true}由composer自动生成维护。

深入探讨composer镜像源同步时的软链接与目录重排逻辑

为什么 vendor 目录里的软链接总被 composer install 清掉

不是 Composer 出 bug，是它根本没打算留你手动建的软链接。vendor/ 被设计为完全受控区域，每次 composer install 或 composer update 都会先清空再重装——ln -s ../my-pkg vendor/my-vendor/my-pkg 这种操作，下次运行就没了。

常见错误现象：ls -l vendor/my-pkg 看着还在，但 composer install 后变成普通目录，或直接消失；更糟的是源路径被删了，后续报 No such file or directory。

别把软链接当持久化方案——它只是绕过安装流程的临时手段
真要本地调试包，必须用 path 仓库类型 + "dev-main" 版本声明，让 Composer 自己生成并维护软链接
若坚持手动 ln，得绑定到 post-install-cmd 钩子，且脚本里要判断源路径是否存在

path 仓库启用 symlink 的三个硬性条件

写错任意一条，vendor/ 里就是复制副本，改代码不生效，还不会报错。

repositories 中的 url 必须是相对路径（如 "../my-package"）或绝对路径（如 "/home/user/my-package"），不能带 file://，不能用 ~，Windows 下必须用正斜杠 / 或双反斜杠 \
本地包根目录下要有合法 composer.json，其中 name 字段（如 "acme/utils"）必须和主项目 require 里的完全一致（大小写、斜杠方向都不能差）
必须在 repositories 条目里显式写 "options": {"symlink": true}——只在本地包自己的 composer.json 里设没用

版本号不能写 * 或 ^1.0：path 仓库不走语义化版本解析，只认 dev-main、dev-develop 这类分支别名。写错就 fallback 到 Packagist。

Discussion Composer

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

下载

镜像同步延迟如何影响 symlink 行为

镜像不同步，会导致 composer install 根本拿不到元数据，连 symlink 的机会都没有——它卡在 Downloading provider-*.json 阶段就失败了。

新包发布后，阿里云镜像通常要 5–30 分钟才同步完成；期间 composer require acme/utils:dev-main 会报 Could not find package
验证是否同步：用 curl -I https://mirrors.aliyun.com/composer/p/acme/utils.json，HTTP 200 且 Last-Modified 接近当前时间才算到位
composer clear-cache 不管用——它只删 zip 缓存，元数据缓存存在 ~/.composer/cache/repo/https---mirrors.aliyun.com-composer 下，得手动 rm -rf

镜像 URL 少个 / 结尾，比如写成 https://mirrors.aliyun.com/composer，Composer 会拼出 /composerpackages.json 导致 404，然后 fallback 到官方源，整个 path 配置就失效了。