composer.lock不会自动适配PHP版本变更，它仅记录生成时的platform快照；install失败的根本原因是lock文件与当前PHP环境不匹配，而非lock本身错误。
composer.lock 不会自动适配 PHP 版本变更，它只记录生成时的 platform 信息；PHP 版本不一致导致 install 失败，根本原因不是 lock 文件本身错了，而是它和当前运行环境不匹配。
composer.lock 里的 platform 字段到底管不管用
它只在 composer update 阶段起作用——决定“选哪个包版本”。一旦 lock 文件生成完成，composer install 就不再校验 PHP 版本是否满足 require.php，而是直接按 lock 里写的 dist URL 和 SHA256 安装。所以：
• 如果 lock 是在 PHP 8.2 下生成的，里面可能含了只兼容 8.2+ 的包（比如用了 match 表达式），你拿它在 PHP 8.0 上 install，运行时才会报错，不是安装时报错
• config.platform.php 是给 update 用的“伪装开关”，写进 composer.json 后必须配合 composer update --lock 才会更新 lock 里的 platform 字段
• composer.lock 中的 platform 块（如 "php": "8.2.15"）只是快照记录，不构成强制约束
为什么本地能 install，CI 却报 “Your PHP version does not satisfy…”
常见于 CI 环境 PHP CLI 版本低于 composer.json 中声明的 require.php 范围，但更隐蔽的情况是：
• CI 脚本里没执行 php -v 校验，直接跑 composer install，结果因 lock 存在而跳过平台检查
• 项目有 config.platform.php，但值写成 "^8.1" 或 "8.1" —— 这两种写法会被 Composer 忽略，实际还是按系统 PHP 解析
• composer.json 里写了 "php": ">=8.1.0"，但 CI 用的是 PHP 8.0.30，且 lock 文件里没有该约束的校验上下文（因为 lock 生成时环境不同）
• 修复方法不是删 lock，而是先确认 CI 的 PHP 版本，再决定：改环境、改 require.php、或补全 config.platform.php 并重跑 composer update --lock
如何让 lock 文件真正“锁定 PHP 兼容性”
靠单个字段做不到，得组合动作：
• 在 composer.json 的 require 段明确写死最低 PHP 版本，例如 "php": ">=8.1.0"（不用 ^8.1，避免推到 9.0）
• 同时在 config.platform 里设完整小版本，例如 "php": "8.1.27"，确保 update 时选包逻辑稳定
• 每次调整 config.platform.php 后，必须运行 composer update --lock，否则 lock 文件里的 platform 字段不会更新
• CI 脚本中加前置检查：php -v | grep -q '8\.1\.' || exit 1，再执行 composer install
• 不要依赖 --ignore-platform-reqs 来绕过，它只是掩盖问题，不是解决
立即学习“PHP免费学习笔记（深入）”；
lock 文件损坏或 platform 不一致时怎么救
别手动编辑 lock，也别直接删了重 update：
• 先运行 composer install --dry-run，看是否提示 lock file is not up to date 或 Your requirements could not be resolved...
• 如果是 platform 不匹配，且确认 composer.json 正确，就删掉 composer.lock，再跑 composer update --lock（不带 --no-install，只重写 lock）
• 如果 composer update --lock 报错，说明 composer.json 和当前 PHP 环境存在真实冲突，此时得先调 PHP 版本或改 require.php
• 修复后立刻 git add composer.lock 并提交，否则下次 install 还是用旧 lock，问题复现
最易被忽略的一点：lock 文件里的 content-hash 是基于整个 composer.json 内容（含 config.platform）计算的，但 platform 字段本身只影响 update 行为；换言之，你改了 config.platform.php 却不跑 update --lock，lock 文件依然合法，只是它已无法反映你想要的兼容性目标。
