PHP项目Composer依赖管理：镜像优化方案-composer-PHP中文网

composer install卡在downloading或超时，主因是镜像配置错误导致静默回退官方源：必须严格满足三条件——键名repo.packagist（单数小写）、第二参数显式写composer（type值）、url为https且末尾带/；验证需看config输出是否为完整json，并用-vvv日志确认真实请求域名。

php项目composer依赖管理：镜像优化方案

国内 PHP 项目跑 composer install 卡在 Downloading 或直接超时，不是网络差，是根本没走镜像——90% 的配置命令写错，导致静默 fallback 到 packagist.org。

composer config -g repo.packagist 命令必须写对这三处

这条命令不报错，但写错任意一处就完全无效：

repo.packagist 不能拼成 repos.packagist（多一个 s 就失效）
中间必须带 composer 这个 type 参数：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉就当没配
URL 必须是 HTTPS + 末尾带 /：https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌（缺斜杠会 404 或回退）

验证是否生效：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍是 https://packagist.org，说明没写进去。

项目级配置比全局更可靠，但别用命令覆盖 repositories

执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）会**全量替换** composer.json 中的 repositories 字段，不是追加。

已有私有源？别跑这条命令。手动编辑 composer.json，在 repositories 数组里加一项：

"packagist": {
  "type": "composer",
  "url": "https://mirrors.aliyun.com/composer/"
}

同时确保根节点写上 "packagist.org": false（注意：不在 repositories 内部），否则 Composer 3.x+ 仍会绕过镜像查官方元数据。

改完后必须运行 composer update --lock，让 composer.lock 记录新源地址，否则 CI 构建时依然走旧路径。

Discussion Composer

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

下载

Docker 构建中镜像配置必须显式写进 Dockerfile

宿主机配的全局镜像，对容器内 composer install 完全无效——构建阶段是全新上下文，不读 ~/.composer/config.json。

三种真正生效的做法：

在 RUN composer install 前插入：RUN composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/
COPY 预配置好的 config.json 进镜像（路径：/root/.composer/config.json）
最推荐：RUN composer install --repository=https://mirrors.aliyun.com/composer/，参数直连，语义清晰且不依赖环境

别忘了分层缓存：把 COPY composer.json composer.lock ./ 放在 RUN composer install 之前，且位置尽量靠前；否则任何代码改动都会让依赖安装层失效，镜像再快也没用。

换镜像后还卡在 Resolving dependencies？那和镜像无关

镜像只加速元数据请求（如 packages.json）和 dist 包下载，不影响依赖解析逻辑。

常见真实瓶颈：

PHP 内存不足：默认 128M 不够，临时设 COMPOSER_MEMORY_LIMIT=-1
Xdebug 启用中：会让解析慢 5–10 倍，用 php -d xdebug.mode=off $(which composer) install 临时禁用
composer.lock 里锁了已下线包或 Git 仓库地址：这类依赖会绕过镜像直连 GitHub，必须单独处理
platform 配置与实际 PHP 版本不匹配：比如 "php": "7.4" 却在 PHP 8.5.5 上运行，触发降级查找

验证是否真走镜像：加 -vvv 运行，盯紧日志里出现的域名——看到 GET https://mirrors.aliyun.com/composer/ 才算生效；如果还看到 packagist.org 或长时间停在 Resolving dependencies，就得排查上面这些点。