使用 --prefer-lowest 可验证 PHP 包在最低依赖版本下的兼容性，确保代码真正支持声明的旧版本，避免因未测试导致的兼容性问题。

当你在开发一个 PHP 包或库时，确保它能在不同版本的依赖下正常工作非常重要。这就是 composer --prefer-lowest 选项发挥作用的地方。

什么是 --prefer-lowest？

这个选项告诉 Composer 在安装依赖时，尽可能选择 composer.json 中定义的最低兼容版本，而不是默认安装最新版本。

例如，如果你的 composer.json 中声明了 "symfony/http-foundation": "^5.0 || ^6.0"，使用 --prefer-lowest 会让 Composer 安装 Symfony 5.0（如果满足约束的最低版本），而不是最新的 6.x 版本。

为什么在测试中使用 --prefer-lowest？

它的主要用途是验证你的代码是否真正支持你声明的最低依赖版本。以下是几个关键原因：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 暴露版本兼容性问题：有些代码可能无意中使用了较新版本才有的功能，但你的版本约束却允许旧版本。这种情况下，不跑最低版本测试就很难发现这类问题。
• 验证版本约束的准确性：你写的 ^5.0 真的意味着从 5.0 开始都支持吗？通过安装 5.0 并运行测试，可以确认这一点。
• 防止“虚假兼容”声明：如果没有测试最低版本，你可能会错误地声称支持某个旧版本，而实际上并不兼容。

如何在 CI 或本地测试中使用？

通常结合 composer update 使用，比如：

composer update --prefer-lowest --prefer-stable

然后运行你的测试套件。这样能确保在最保守的依赖环境下，代码依然能通过所有测试。

很多开源项目会在 CI 配置中设置两组测试：一组用默认依赖（最新兼容版），另一组用 --prefer-lowest，以覆盖更广的兼容性场景。

基本上就这些。用好 --prefer-lowest 能帮你写出更健壮、真正兼容多版本依赖的 PHP 包。