通过配置composer.json中的config.platform.php可锁定依赖解析时的PHP版本，例如设为"8.1.0"后，即使本地运行PHP 8.3，Composer也会按PHP 8.1环境安装兼容包，避免因本地与生产环境PHP版本不一致导致的兼容问题；建议设置该值为生产环境实际PHP版本，并可扩展固定ext-gd等扩展版本，团队协作时能减少“在我机器上能跑”问题，提升部署稳定性。

在本地开发时，为了确保依赖包的安装与生产环境保持一致，可以通过 composer.json 中的 config.platform 配置项来固定 PHP 版本。这样 Composer 在解析依赖时会基于你指定的 PHP 版本，而不是当前本地实际运行的版本。

配置 config.platform 指定 PHP 版本

在 composer.json 文件中添加 config 字段，并设置 platform 下的 php 键为你生产环境的 PHP 版本：

{
    "config": {
        "platform": {
            "php": "8.1.0"
        }
    }
}

例如，如果你的生产环境使用的是 PHP 8.1.0，即使你在本地使用的是 PHP 8.3，Composer 也会按照 PHP 8.1 的环境来选择兼容的依赖版本。

为什么需要 platform 配置？

Composer 默认使用本地 PHP 版本来分析依赖关系。这可能导致安装了仅适用于高版本 PHP 的扩展包，而这些包在低版本的生产环境中无法运行。

通过 platform 设置，你可以锁定模拟的环境版本，避免因本地和线上 PHP 版本不一致导致的兼容性问题。

常见用途和建议

• 将 config.platform.php 设置为生产服务器的实际 PHP 版本（如 "7.4.33" 或 "8.2.12"）
• 团队协作时，统一该配置可减少“在我机器上能跑”的问题
• 可以同时固定其他扩展，比如：
  "ext-gd": "enabled" 或 "ext-mbstring": "1.3.2"
• 若想临时忽略 platform 设置，可用命令行参数：
  composer install --ignore-platform-reqs