低配云服务器上 Composer 安装卡顿的根源是直连 packagist.org 导致物理链路不通，必须一步到位配置阿里云镜像并验证 JSON 输出；随后清缓存、设并发为 6–10、内网可关 secure-http；安装时用 --prefer-dist --no-autoloader --no-scripts 减负，完成后单独 dump-autoload；CI/CD 中须用 COMPOSER_HOME 隔离配置，禁用 COPY vendor。
镜像配置必须一步到位，否则所有优化都白搭
低配云服务器（比如 512MB 内存、1 核 CPU）上 composer install 卡在 Loading composer repositories 或 Downloading，根本不是网速或内存问题，而是默认直连 packagist.org 导致 DNS 解析失败、TLS 握手超时、CDN 路由绕行——物理链路不通，调任何参数都没用。
唯一可靠命令是：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
这个命令漏一个字符就静默失效，常见错误包括：
-
repo.packagist写成repos.packagist（多 s）或packagist.org - 中间的
composer是 type 值，不能省略、不能替换为composer2或留空 -
https://mirrors.aliyun.com/composer/少了末尾/→ 返回 404 - 没加
-g→ 只改当前目录，换项目/换用户就失效
配完立刻验证：
composer config -g repo.packagist
输出必须是完整 JSON：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。空、null、或仍显示 packagist.org，说明根本没写进去。
清缓存 + 设并发 + 关签名验证，三步压低资源占用
镜像配对了，但旧缓存还在读海外索引，composer install 依然慢甚至失败。必须执行：
composer clear-cache
然后设并发下载数（parallel-downloads）为 10：
composer config -g parallel-downloads 10
超过 15 容易触发临时文件冲突（file_put_contents(/tmp/): failed to open stream），某些企业网络或低配 VPS 降为 6～8 更稳。
内网可信环境可关 HTTPS 强制校验（避免小内存机器反复做证书验证 OOM）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config -g secure-http false
注意：仅限内网，生产环境对外服务请勿关闭。
部署命令要带 --prefer-dist --no-autoloader --no-scripts
低配服务器最耗资源的环节不是下载，而是 install 后自动执行 autoload dump 和各种 post-install-cmd 脚本。这些操作吃内存、占 CPU、还容易因扩展缺失报错。
实操建议用这组参数一次性拉包解压：
composer install --prefer-dist --no-autoloader --no-scripts --no-progress
其中：
-
--prefer-dist强制走压缩包（sparse archive 已启用），跳过 git clone，体积更小、解压更快 -
--no-autoloader跳过生成 autoload_classmap.php 和 vendor/autoload.php -
--no-scripts跳过所有 post-install-cmd，比如前端构建、配置生成等 -
--no-progress减少日志输出，避免 systemd 或 Jenkins 日志缓冲区撑爆
安装完再单独跑：
composer dump-autoload --optimize
它生成的 autoload_classmap.php 比默认方式更快且省内存。
CI/CD 和 Docker 构建别碰全局配置
在 Jenkins、GitLab CI 或 Docker 构建中，并发 job 共享 ~/.composer/config.json 会导致镜像错乱。正确做法是临时指定独立路径：
COMPOSER_HOME=/tmp/composer-home-$$ composer config repo.packagist composer https://mirrors.aliyun.com/composer/ && composer install --no-dev --optimize-autoloader --prefer-dist
关键点：
- 用
COMPOSER_HOME隔离，不污染宿主机配置 - 项目级配置（写进
composer.json的repositories）比全局更可靠，且不会被其他 job 干扰 - 千万别直接
COPY vendor/进镜像——宿主机 PHP 版本、扩展、权限都可能不一致，必然出错
如果已有 composer.lock 是用国外源生成的，切镜像后可能出现哈希校验失败。这不是镜像问题，而是 content-hash 不匹配；此时应删掉 composer.lock 重生成，或先 composer update --lock 再 install。
