找不到Composer虚拟包怎么办？源仓库排查技巧-composer-PHP中文网

根本原因是composer不通过packagist或repositories解析虚拟包（如ext-redis），而依赖本地php扩展加载状态或config.platform显式声明；若php -m未列出或platform版本不匹配，就会报“could not find package”。

找不到composer虚拟包怎么办？源仓库排查技巧

找不到 Composer 虚拟包（比如 ext-redis、phpunit/phpunit 这类不对应真实 Git 仓库的“伪包”），根本原因不是网络或权限，而是 Composer 默认不解析它们的元数据——它只在明确启用虚拟包支持、且配置了正确源类型时才尝试匹配。

为什么 `composer require ext-redis` 直接报 “Could not find package”

Composer 对虚拟包（ext-*、lib-*、php 等）的处理逻辑和普通包完全不同：它不查 Packagist，也不走 repositories 数组，而是依赖本地 PHP 环境 + composer.json 中的 provide 声明 + 全局 platform 配置。一旦缺失任一环节，就静默跳过，直接报“not found”。

常见错误现象：

运行 composer require ext-redis 报错，但 php -m | grep redis 显示已加载
composer show 列不出任何 ext-* 包，哪怕扩展已启用
私有项目里 require 了 phpunit/phpunit，却提示找不到，而实际安装的是 phpunit/phpunit 的某个子包（如 phpunit/php-code-coverage）

关键点：

虚拟包不能靠 repositories 声明来“添加”，它们必须由当前 PHP 环境或 config.platform 显式提供
ext-redis 这类包名是硬编码规则，大小写敏感，ext-Redis 或 ext_redis 都无效
Composer 2.5+ 开始，php 版本也被当作虚拟包处理，若 composer.json 中写了 "php": "^8.1"，但本地是 8.0，也会导致依赖解析失败（看似“not found”，实为平台不兼容）

`composer.json` 里怎么正确声明虚拟包依赖

虚拟包只能通过 require 字段引用，但必须配合 config.platform 或确保扩展真实可用。不能用 repositories 或 minimum-stability 控制它们。

实操建议：

Workflow Decomposer

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

下载

确认扩展已加载：php -m | grep redis（Linux/macOS）或 php --ri redis（更准确）
如果是在 CI 或容器环境，PHP 扩展可能未安装，需先执行 docker-php-ext-install redis 类命令
若想绕过本地检查（例如开发机没装 redis，但 CI 有），在 composer.json 的 config 下加：
```
"platform": {
  "ext-redis": "5.3.7"
}
```
注意版本号必须是真实扩展的版本（可用 php --ri redis | grep Version 查），填 * 或留空会失效
不要在 repositories 里加 {"type":"package",...} 去“模拟”虚拟包——Composer 不识别这种写法，会静默忽略

为什么 `composer search ext-redis` 搜不到，但 `composer show` 又能列出？

composer search 只查 Packagist 元数据索引，而虚拟包根本不在 Packagist 上注册；composer show 显示的是当前环境已满足的 provide 条目（来自 platform 或已安装扩展），二者查询路径完全隔离。

所以：

composer search ext-* 永远为空，这是正常行为，不是 bug
composer show -p（带 -p 参数）才能列出所有已提供的虚拟包，包括 ext-*、lib-*、php
若 composer show -p 里没有你要的 ext-xxx，说明要么扩展没启用，要么 platform 没配对，别指望换源或清缓存解决

CI/CD 中虚拟包“突然找不到”的排查顺序

这类问题多发生在部署环境与本地不一致时，重点不是改配置，而是对齐环境。

按优先级检查：

确认 PHP CLI 版本和扩展是否与 composer.json 中 require.php 和 config.platform 完全匹配（版本号精确到小数点后一位）
检查 CI 镜像是否用了 php:alpine 这类精简版——它默认不带 ext-zip、ext-gd 等，需显式安装
运行 composer diagnose，它会明确告诉你哪些 ext-* 缺失，比报错信息更直接
避免在 composer.json 中混用 config.platform.php 和 require.php：前者是“假装有”，后者是“必须满足”，冲突时 Composer 优先按 require 校验