composer install 是多机同步唯一可靠入口，必须严格使用且配合已提交的 composer.lock；禁止在部署中使用 composer update；需配置 config.platform 精确控制 PHP 小版本；镜像源仅加速不控版本；离线环境须打包 vendor/ 和 lock 文件。

composer install 是多机同步的唯一可靠入口

多台机器装出不同依赖，根本不是镜像源或网络问题，而是有人在某台机器上误用了 composer update，又没提交新 composer.lock。只要所有机器都严格执行 composer install（且 composer.lock 已提交），结果就必然一致——Composer 不会“猜”，它只还原快照。

• CI/CD 脚本、Dockerfile、Ansible 任务里，必须写 composer install --no-dev --optimize-autoloader --no-interaction，缺一不可
• 看到 composer update 出现在部署流程中，立刻删掉；它和 --no-dev 无关，本质仍是重算依赖树
• 运行 composer install --dry-run，输出含 Installing dependencies from lock file 才表示 lock 有效；若出现 Resolving dependencies...，说明 composer.json 和 composer.lock 已脱钩，需人工干预

config.platform 必须写死小版本号，否则形同虚设

config.platform 是控制跨机器一致性最关键的开关，但写错位置或格式就完全失效。它不解决“装什么”，而是约束“能装什么”——比如团队统一用 PHP 8.1.10，那即使某台机器装了 8.2，composer install 也会按 8.1.10 的兼容性去选包。

Discussion Composer

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

下载

• 必须放在 composer.json 根级 config 对象下，键名严格为 platform，不能是 platform.php 或嵌套在 extra 里
• 值必须是对象，且版本号精确到小版本：写 "php": "8.1.10" 有效；写 "^8.1"、"8.1" 或 "8.1.0"（末尾缺零）都会被忽略
• 改完后必须删掉旧 vendor/ 和 composer.lock，再跑 composer install —— 否则旧 lock 仍按原平台解析，不会自动刷新
• 验证是否生效：运行 composer show php，输出应为 version : 8.1.10；再看 composer install --dry-run 日志里是否有 Platform configuration: php 8.1.10

镜像源只是加速器，不是版本控制器

换阿里云镜像不会让 monolog/monolog 从 2.9.1 变成 3.0.0，也不会修复因 PHP 版本不一致导致的 lock 解析差异。镜像只缓存 packagist.org 的内容，不参与版本求解。

• 项目级镜像配置必须显式写进 composer.json 的 repositories，例如：

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

• 所有人必须清掉全局镜像设置：composer config --global --unset repos.packagist；检查残留用 composer config --global repo.packagist，输出应为空或 https://packagist.org
• CI 脚本开头加一句 composer config --global --unset repos.packagist，防止构建节点被历史配置污染
• 镜像再快，如果 composer.lock 里记录的是基于 PHP 8.2 解出的依赖，而某台机器是 PHP 8.1，composer install 就会失败或跳过某些包

离线环境同步必须打包 vendor/ + lock，不能只传 lock

空气间隙（air-gapped）系统无法联网，所以关键不是“怎么装”，而是“怎么让每台机器在无网时也能还原完全一致的依赖”。仅靠 composer.lock 不够——Composer 离线安装时仍会尝试访问网络获取包 zip/tar。

• 有网机器上对每个项目执行 composer update --with-all-dependencies，确保 composer.lock 中每个 dist 条目都有 url 和 shasum
• 把整个 vendor/ 目录 + composer.lock 打包进离线介质；不要只传 .zip 包，除非你已配置 artifact 仓库（且该配置只对顶层包生效，对递归依赖无效）
• 打包前运行 composer install --no-dev --optimize-autoloader，减少体积并排除 dev-only 包
• 目标机若 PHP 版本或扩展缺失（如缺 ext-redis），可用 composer install --ignore-platform-reqs 绕过平台检查，但这只是临时手段，长期应统一基础环境

真正的难点不在命令本身，而在所有人是否真的删掉了 vendor/ 再跑 composer install，以及是否真把 composer.lock 提交到了 Git —— 这两个动作漏掉任何一个，集群同步就只剩表面一致。