composer install是唯一能还原一致依赖的命令，因它严格按composer.lock快照安装指定版本、哈希与子依赖；而composer update会重解析composer.json并跳过lock，导致多机环境必然不一致。
composer install 为什么必须用，而不能用 composer update
部署和多机同步时，composer install 是唯一能还原一致依赖的命令；composer update 会重新解析 composer.json，跳过 composer.lock，结果必然不一致。
常见错误现象：CI 构建成功，但某台机器上 composer install 报错或装出不同版本 —— 往往是因为有人在本地执行了 composer update，又没提交新生成的 composer.lock。
-
composer install --dry-run输出含Installing dependencies from lock file才表示 lock 有效；若出现Resolving dependencies，说明 lock 已失效，需人工干预 - CI/CD 脚本、Dockerfile 中必须写
composer install --no-dev --optimize-autoloader --no-interaction，缺一不可 - 看到
composer update出现在部署流程里，立刻删掉 —— 它和--no-dev无关，本质仍是重算依赖树
镜像源（如阿里云）到底管不管版本
镜像源只是下载加速器，完全不参与版本求解。换源不会让 monolog/monolog 从 2.9.1 变成 3.0.0，也不会修复因 PHP 版本差异导致的 lock 解析问题。
真正决定装什么版本的，是 composer.json 的约束 + composer.lock 快照 + config.platform 声明的运行环境能力。
- 项目级镜像配置必须写进
composer.json的repositories数组，且首项必须是{"packagist.org": false} - 镜像
url末尾必须带/，否则请求会 404（如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌） - 所有人必须清掉全局配置：
composer config --global --unset repos.packagist，否则部分包走全局、部分走项目，行为不可预测
config.platform 怎么写才生效
config.platform 不是可选项，是跨机器一致性的核心开关。它不控制“装什么”，而是约束“能装什么”——比如团队统一用 PHP 8.1.10，那即使某台机器装了 8.2，composer install 也会按 8.1.10 的兼容性去选包。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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
Docker 构建中 vendor 目录怎么处理才安全
容器内构建时，vendor/ 必须在 RUN 指令中安装进镜像层，不能挂载宿主机 vendor/ 或在启动时再装 —— 否则构建环境与运行环境 PHP 版本/扩展不一致，会导致 autoloader 异常或类加载失败。
多阶段构建尤其要注意 builder 和 runner 镜像对齐：
- builder 阶段必须用和最终运行镜像同源的 PHP 版本、SAPI 类型、关键扩展（如
ext-zip、ext-mbstring） - Alpine 镜像需提前
RUN apk add --no-cache ca-certificates git unzip，否则 SSL 或 git clone 失败 - final 阶段只
COPY --from=builder /app/vendor /app/vendor，别复制composer.phar或构建工具 -
COPY顺序必须是：先COPY composer.lock .，再COPY composer.json .，最后RUN composer install；否则会退化成update，破坏可重现性
最易被忽略的是 platform 锁定和 COPY 顺序 —— 这两点一旦出错，镜像看起来能跑，但上线后某天突然报 ParseError 或找不到类，根本查不到源头。
