ThinkPHP项目中Composer报“platform requirements not met”错误时，需在composer.json的config.platform中声明PHP版本及扩展，或通过命令行、环境变量配置platform，必要时可临时忽略检查。
如果您在 ThinkPHP 项目中需要引入 PHP 扩展、系统工具类或底层平台级依赖（如 ext-redis、ext-curl、php >= 8.1），但 Composer 报错提示“platform requirements not met”或“Your requirements could not be resolved”，则问题通常源于 platform 包未在 composer.json 中显式声明。以下是配置 Composer 平台包的几种方法：
一、在 composer.json 的 config.platform 中声明平台依赖
该方式用于模拟目标生产环境的 PHP 版本和扩展，避免本地开发环境与部署环境不一致导致的依赖解析失败。Composer 将依据此配置进行依赖版本推导，而非读取当前 PHP 实际环境。
1、打开项目根目录下的 composer.json 文件。
2、在顶层键中添加 "config" 对象（若不存在），并在其下嵌套 "platform" 子对象。
立即学习“PHP免费学习笔记（深入）”；
3、在 "platform" 中写入所需平台约束，例如：
"config": {
"platform": {
"php": "8.1.10",
"ext-redis": "5.3.7",
"ext-gd": "*"
}
}
4、保存文件后执行 composer update --lock，强制重新解析依赖并锁定符合 platform 约束的版本。
二、使用命令行全局设置 platform 配置
该方式适用于多项目共用同一套平台策略，或临时覆盖当前项目的 platform 声明，无需手动编辑 JSON 文件。
1、在项目根目录下运行命令：composer config platform.php 8.1.10。
2、为扩展添加 platform 条目：composer config platform.ext-redis 5.3.7。
3、查看当前生效的 platform 设置：composer config platform，确认输出包含预期键值对。
4、执行 composer update --with-dependencies，确保所有依赖均按新 platform 约束重算。
三、通过环境变量临时覆盖 platform 检查
该方式用于 CI/CD 流水线或容器化部署场景，在不修改项目源码的前提下强制指定平台环境，避免因构建机 PHP 版本过高或缺失扩展导致 install 失败。
1、在执行 composer install 前，设置环境变量：COMPOSER_PLATFORM_CHECK=0 可跳过全部 platform 校验（慎用）。
2、更安全的方式是精确覆盖：COMPOSER_PLATFORM_CHECK=1 PHP_VERSION=8.1.10 EXT_REDIS_VERSION=5.3.7 composer install。
3、验证是否生效：运行 composer show --platform，输出应显示被环境变量注入的 platform 条目。
4、注意该方式仅影响当前命令生命周期，不会写入 composer.json 或 config 文件。
四、禁用 platform 检查以绕过限制（仅限调试）
当明确知晓平台差异不影响运行，且需快速验证功能时，可临时关闭 platform 强制检查机制。此操作会跳过所有 ext-* 和 php 版本校验，但可能掩盖真实兼容性风险。
1、执行 composer install --ignore-platform-reqs，跳过全部 platform 要求。
2、若只需忽略特定项，例如仅跳过 redis 扩展检查：composer install --ignore-platform-req=ext-redis。
3、也可同时忽略多个：composer install --ignore-platform-req=php --ignore-platform-req=ext-gd。
4、该参数不可用于 composer update，仅适用于 install 场景；生产环境严禁使用。
