Composer在混合多端开发场景中保持开发机与服务器配置完全对齐-composer-PHP中文网

必须提交composer.lock文件——它是php应用项目依赖一致性的强制契约，确保开发、测试、生产环境安装完全相同的依赖版本；被.gitignore拦截、未同步提交或ci误用composer update均会导致环境不一致故障。

composer在混合多端开发场景中保持开发机与服务器配置完全对齐

composer.lock 必须提交，且每次部署前强制校验

开发机和服务器依赖不一致，90% 的根源是 composer.lock 没提交、被忽略、或 CI 跑了 composer update 却没提交新 lock。它不是“辅助文件”，而是唯一能保证两端安装完全相同包树的契约。

所有 Git 仓库必须把 composer.lock 加入版本控制，禁止在 .gitignore 中屏蔽
CI 脚本开头加 git checkout -- composer.lock，防止本地误改未提交导致线上拉取旧 lock
部署后立刻执行 composer show monolog/monolog，输出版本号必须和 composer.lock 里 "version" 字段一字不差（含小版本）
若用 Docker 构建，COPY composer.lock . 必须在 COPY composer.json . 之后、composer install 之前，顺序错就失效

config.platform 写错位置或格式 = 白写

config.platform 是让开发机模拟服务器 PHP 环境的关键开关，但写在 extra 或用 ^8.1 这种范围写法，它就完全不生效——Composer 解析时直接跳过。

必须放在 composer.json 根级 config 对象下，例如："config": {"platform": {"php": "8.1.10"}}
PHP 版本必须写死完整小版本号（如 "8.1.10"），不能写 "8.1" 或 "^8.1"
改完 config.platform 后，必须删掉 vendor/ 和旧 composer.lock，再跑 composer install，否则旧 lock 仍按原平台解析
验证是否生效：运行 composer show --platform，输出里 php 行应显示你指定的版本，而非本地实际 PHP 版本

镜像源混用导致元数据不一致

混合云场景（比如开发在阿里云 VPC、CI 在 AWS）下，不同镜像节点同步延迟不同，同一时刻查到的可用版本可能不一致——这不是 Composer 错，是索引文件（如 provider-*.json）还没拉齐。

Discussion Composer

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

下载

项目级 repositories 配置会完全屏蔽全局镜像，所以不要在 composer.json 里留空 "repositories": []，要么删掉，要么填真实地址
CI 脚本开头加 composer config --global --unset repos.packagist，防止全局镜像覆盖项目配置
验证镜像是否同步：用 curl -I https://mirrors.aliyun.com/composer/p2/guzzlehttp/guzzle/7.9.0.json 对比官网地址，HTTP 200 vs 404 即可确认
URL 必须以 / 结尾，https://mirrors.cloud.tencent.com/composer 会拼成 /composerpackages.json → 404

post-install-cmd 调用前端工具时路径和执行环境错位

全栈项目里，composer install 后自动跑 yarn build 失败，往往不是脚本写错，而是命令默认在项目根目录执行，而 yarn 实际只在 frontend/ 目录下才有效。

别写 cd frontend && yarn build —— && 在 Windows cmd.exe 下不生效；改用封装脚本 bash scripts/build-frontend.sh，开头加 #!/usr/bin/env bash
调用 yarn 优先用 ./frontend/node_modules/.bin/yarn，避免依赖全局安装，CI 环境常没装全局 yarn
CI 必须先 npm install -g corepack，再 corepack enable，否则 yarn 版本和 .yarnrc.yml 不一致
post-install-cmd 执行失败不会中断 composer install，要加 || exit 1 强制失败退出，否则你以为构建成功了