答案:报“does not match your platform”需先确认PHP CLI环境真实能力,用php -v和php -m | grep redis验证,再通过php --ini定位CLI加载的php.ini,检查extension=redis.so是否启用;虚拟包不下载文件,只做静态检查。

Composer 虚拟包(如 ext-redis、lib-curl、php:8.3)安装失败,90% 不是包本身问题,而是 Composer 无法验证本地环境是否满足声明的“平台要求”——它压根不下载任何文件,只做静态检查。关键看报错里有没有 Your requirements could not be resolved 或 does not match your platform。
报 “does not match your platform” 怎么快速定位真实缺失项
这类错误说明 Composer 在比对 composer.json 中的 require(比如 "ext-redis": "*")和你当前 PHP CLI 环境的实际能力,但没对上。
- 先确认你运行的是 CLI 环境,不是 Web:执行
php -v和php -m | grep redis;如果php -m没输出redis,但项目却 requireext-redis,就必然失败 - Windows 用户特别注意:WAMP/XAMPP 的 Web 界面(
phpinfo())和命令行(php -v)常指向不同php.ini,用php --ini查真正加载的配置路径 - 虚拟包名必须严格匹配:比如
ext-gd不能写成gd,php:8.3不能写成php >=8.3(后者是版本约束,不是平台包) - 某些扩展在 CLI 下默认禁用:例如 Ubuntu 的
php-redis包装完后还需手动启用:sudo phpenmod redis
composer install 卡在平台检查、不报错也不继续
这是 Composer v2.5+ 的静默行为升级:当它发现平台包不满足时,可能不抛明确错误,而是直接停在解析阶段。需加 -vvv 强制输出细节。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 运行
composer install -vvv 2>&1 | grep -A5 -B5 "platform",看日志中是否出现类似ext-redis is missing from your system的提示 - 若日志里有
Ignoring virtual package ext-redis,说明该包被跳过——通常因为你在config.platform里伪造了它(见下一点) - 检查项目
composer.json是否误配了"config": {"platform": {...}},比如写了"ext-redis": "8.0"但本地根本没装,这会让 Composer 认为你“假装有”,反而干扰真实检测
用 --ignore-platform-reqs 临时绕过,但别上线
这个参数强制跳过所有平台检查,能让 install 继续,但它不解决任何实际问题——只是把错误延后到运行时(比如 Class 'Redis' not found)。
- 仅限开发调试:例如你正在 CI 上测试多 PHP 版本兼容性,但某阶段不需要真跑 Redis 代码
- CI 场景下更稳妥的做法是显式安装扩展:GitHub Actions 可加
run: sudo apt-get install php-redis;Docker 则应在Dockerfile中RUN docker-php-ext-install redis - 绝对不要在生产部署脚本里带
--ignore-platform-reqs,它会掩盖真实环境缺陷,导致上线后崩溃
虚拟包的本质是“断言”,不是“安装指令”。排查重点永远在本地 PHP CLI 环境的真实能力,而不是 Composer 配置或网络。最容易被忽略的是:你以为自己装了 ext-redis,其实只装在 Apache 的 PHP 里,而 Composer 跑在 CLI 的另一个 PHP 实例上。

















