composer clear-cache必须在换镜像前执行，因其仅清除全局缓存中repo/等子目录的旧源元数据（如packagist.org/packages.json），若不清除，composer仍按旧规则解析，即使镜像配置正确也会404或拉错源。
composer clear-cache 为什么必须在换源后立即执行
换镜像源后不清理缓存，Composer 仍会读取旧的 packages.json 元数据——这些元数据里记录的是 packagist.org 的包路径、校验和与发布时间，哪怕你已配好阿里云镜像，它也会尝试回源验证，导致卡在 Reading packages.json from cache 后无响应。这不是“缓存没用”，而是缓存内容与新镜像 URL 不匹配。
执行 composer clear-cache 后，下次 composer install 会强制从新镜像拉取最新元数据，跳过所有过期校验逻辑。注意：该命令只清本地缓存，不影响全局配置或 composer.lock 文件。
- CI 构建中建议每轮都加这句，尤其当镜像源可能被环境变量覆盖时
- 若
~/.composer/cache挂载在 NFS 或低 I/O 磁盘上，clear-cache本身会变慢，可提前用composer config cache-dir /dev/shm/composer-cache指向内存盘 - 别信“缓存自动更新”——Composer 不会主动刷新过期元数据，只会在 checksum 不匹配或
--force时才重拉
parallel-downloads 设多少才不翻车
parallel-downloads 是 Composer 2.2+ 原生支持的并发下载参数，但它不是线程数，而是 cURL multi handle 并发请求数。设太高会导致临时文件竞争、磁盘 I/O 阻塞，甚至触发 file_put_contents(/tmp/): failed to open stream 错误。
推荐值是 6～10，具体取决于部署节点的 CPU 核心数与磁盘类型：
- 单核 VPS 或 CI 限核环境，设
6更稳；SSD + 4 核以上服务器可设10 - 值设为
20在多数生产环境会失败，错误日志里常伴随Failed to extract或corrupted zip - 该参数对
composer update几乎无效，只加速install阶段的 ZIP 包下载 - 确认生效方式：
composer config -g parallel-downloads输出应为数字，不是null或空字符串
镜像源 URL 结尾必须带斜杠
写成 https://mirrors.aliyun.com/composer（缺末尾 /）会导致 Composer 拼出 https://mirrors.aliyun.com/composerpackages.json，直接返回 404。这不是 DNS 或网络问题，是字符串拼接硬伤。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
所有主流镜像源（阿里云、腾讯云、华为云）都要求 URL 以 / 结尾，且必须显式声明 type 为 composer：
- 正确写法：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 错写成
repos.packagist或repositories.packagist.org会静默失败，composer config -g repo.packagist输出为空 - Docker 构建中不能靠 COPY
~/.composer/config.json，必须在 RUN 步骤里显式执行该命令 - 宝塔、Jenkins 等后台任务若以
www用户运行，而你用root配的镜像，www根本读不到/root/.composer/config.json
缓存目录挂载到 /dev/shm 能扛住大促流量
Composer 默认缓存放在 ~/.composer/cache，如果该路径位于机械硬盘或网络存储（如 NFS），高峰期大量并发 install 会因磁盘争用导致超时或解压失败。把缓存移到内存盘，能绕过 I/O 瓶颈。
实操命令：
composer config -g cache-dir /dev/shm/composer-cache
但要注意三点：
-
/dev/shm默认大小通常只有 64MB，Composer 缓存峰值可能超 200MB，需提前扩容：mount -o remount,size=512M /dev/shm - 容器环境中
/dev/shm可能未启用，Docker 启动时要加--shm-size=512m - 该设置仅影响包文件缓存（ZIP、TAR），不影响
composer.lock解析或依赖图计算——后者仍吃 CPU 和内存
真正决定高峰期是否掉链子的，从来不是“镜像快不快”，而是缓存路径是否抗压、URL 是否拼对、composer.lock 是否被 COPY 进构建上下文——漏掉任意一个，流量一上来就卡在 downloading。
