要强制使用特定版本的依赖包，可在 composer.json 中精确指定版本号或使用别名。例如，设 "monolog/monolog": "2.9.0" 可锁定该版本；用 "dev-main as 6.4.99" 可将开发分支伪装成指定稳定版本以满足依赖要求。

在使用 Composer 管理 PHP 项目依赖时，有时需要强制使用某个特定版本的依赖包，避免因自动解析导致版本不一致或兼容性问题。这可以通过在 composer.json 中精确指定版本号或使用别名来实现。

直接指定精确版本号

最简单的方式是在 require 或 require-dev 中写明依赖包的完整版本号，而不是使用版本范围或通配符。

示例：

你想强制使用 monolog/monolog 的 2.9.0 版本：

{
    "require": {
        "monolog/monolog": "2.9.0"
    }
}

这样 Composer 在安装或更新时会严格使用这个版本，不会选择其他版本，除非存在冲突。

使用版本约束锁定大版本中的小版本

如果你不能确定具体的小版本，但想锁定在某个范围内（例如 v2 的最新补丁），可以使用更严格的约束。

常见写法包括：

• "^2.9.0"：允许 2.9.0 到 3.0.0 之前的版本（推荐用于语义化版本）
• "~2.9.0"：允许 2.9.0 到 2.9.9 之间的版本
• "2.9.*"：匹配 2.9 开头的所有版本

若要完全避免升级风险，仍建议使用固定版本如 2.9.0。

Expanso json-flatten

通过 CLI 或 MCP 服务器，使用 Expanso Edge 管道扁平化嵌套 JSON 对象。

下载

通过别名强制满足版本要求

有时候你希望使用一个开发分支（如 dev-main），但某个依赖要求的是稳定版本。这时可以用 版本别名（alias） 来“伪装”成所需版本。

示例：

你正在使用一个 fork 的库，它基于 symfony/http-foundation 的主干开发，但另一个组件要求 ^6.4，而你的 dev 分支没有打标签。可以在 composer.json 中添加：

{
    "require": {
        "symfony/http-foundation": "dev-main as 6.4.99"
    }
}

这表示使用 dev-main 分支，并将其“伪装”为 6.4.99 版本，从而满足依赖约束。

防止其他包覆盖指定版本

即使你指定了版本，其他依赖包可能仍会引入不同版本的同一库（尤其是并行依赖）。可通过以下方式加强控制：

• 运行 composer depends 查看哪些包引用了该依赖
• 使用 platform 配置或 conflict 规则 排除不兼容版本
• 提交 composer.lock 文件，确保团队成员和部署环境使用相同版本

必要时可手动编辑 composer.lock 并锁定版本（不推荐长期手动修改）。

基本上就这些。通过指定精确版本号或使用 as 别名，你可以有效控制 Composer 安装的依赖版本，提升项目的稳定性与可预测性。