虚拟包(如ext-redis、php:8.2)需手动验证系统真实环境:运行php -m | grep redis、php -v或composer show --platform确认扩展与PHP版本存在,再用php -r调用典型函数(如new PDO())验证功能可用性,仅composer install成功不等于生效。

composer install 后怎么确认虚拟包已生效
虚拟包(如 ext-redis、lib-curl、php:8.2)不下载代码,只声明运行时约束。CI 中 composer install 成功不代表它们真存在——它只检查 composer.json 里写的是否“看起来合理”,不校验系统实际能力。
实操建议:
- 在
composer install后立即执行php -m | grep redis或php -v验证扩展/PHP 版本是否真实加载 - 用
composer show --platform列出当前平台包状态,但注意:它只读phpinfo()和get_loaded_extensions(),不验证功能(比如ext-redis存在 ≠ Redis 连接可用) - 若项目依赖
ext-gd,光有扩展名不够,还得跑php -r "var_dump(function_exists('imagecreate'));"确认函数可用 - CI 脚本中避免仅靠
composer validate --strict断言——它不检查平台包,只校验composer.json语法和字段逻辑
为什么 verify-checksums 对虚拟包完全无感
composer verify-checksums --strict 只扫描 vendor/ 下真实解压的包文件,而虚拟包根本不在 vendor/ 里,也不进 composer.lock 的 packages 数组——它们只出现在 platform 或 platform-dev 字段中,且无 dist.sha256 字段。
这意味着:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 即使你手动删掉
ext-xml,verify-checksums也绝不会报错或警告 - 它不会读
php.ini、不调extension_loaded()、不碰任何系统层配置 - 加
COMPOSER_EXPERIMENTAL=1也救不了它——这不是功能缺失,是设计使然
CI 中如何可靠拦截虚拟包缺失
不能等应用启动时报 Class 'Redis' not found 才发现,得在构建阶段就 fail。
推荐做法:
- 在 CI 脚本中写明依赖的 PHP 扩展和版本,例如:
php -m | grep -E '^(redis|mbstring|curl)$' && php -v | grep '8\.2'
- 对关键扩展做功能级探测:用
php -r调用典型函数,如php -r "new PDO('sqlite::memory:');"验证ext-pdo_sqlite - 如果使用 Docker,把验证逻辑放进
ENTRYPOINT或健康检查脚本,而非只靠composer install - 避免用
composer require --dev ext-redis——这会写进require-dev,但--no-dev构建时直接跳过,导致生产镜像缺失检查
虚拟包和私有源混用时的坑
当项目同时 require myorg/private-package 和 ext-apcu,且私有源配置了 "packagist.org": false,Composer 仍会尝试从 packagist.org 解析虚拟包——因为虚拟包解析不走仓库列表,而是硬编码匹配规则。
结果就是:
- 私有源不可达时,
composer install可能卡在 “Resolving packages…” 十几秒,最后报Could not find package ext-apcu,尽管它根本不需要下载 - 解决方法:确保全局或项目级配置中保留
"packagist.org": true,或显式在repositories中加一条{"type": "composer", "url": "https://packagist.org/"}并置顶 - 更稳的做法:CI 中先
composer config --global repo.packagist composer https://packagist.org/,再运行 install,别依赖项目repositories的 fallback 行为
composer.lock 里写着 "ext-imagick": "*",只要没在 CI 中跑一句 php -m | grep imagick,你就永远不知道那台机器到底有没有装。

















