Composer虚拟包是ext-、lib-或php开头的抽象标识，不对应真实包，仅用于环境兼容性校验，如ext-redis表示需启用PHP redis扩展。
Composer 虚拟包（virtual packages）是什么
Composer 本身不提供“虚拟包”的安装能力，它只是识别并满足 composer.json 中声明的依赖约束。所谓“虚拟包”，是某些包在 require 或 provide 字段里用字符串形式声明的、并不存在真实发布包的占位符名称，比如 ext-zip、php、ext-mbstring。它们不是可下载的包，而是 Composer 用来做环境兼容性校验的抽象标识。
当你看到错误提示 Your requirements could not be resolved to an installable set of packages 并伴随 ext-redis 不满足时，实际意思是：当前 PHP 环境没启用 redis 扩展，而某个依赖（如 laravel/framework）在 composer.json 的 require 里写了 "ext-redis": "*" —— 这个 ext-redis 就是典型的虚拟包。
- 虚拟包名全部以
ext-、lib-或php开头，不对应 Packagist 上的真实仓库 - Composer 在解析阶段会检查本地 PHP 是否加载了对应扩展（通过
extension_loaded()），或是否满足 PHP 版本（通过PHP_VERSION_ID） - 你无法运行
composer require ext-xml，那会报错 “Could not find a matching version” - 它们只出现在其他包的
require或provide字段中，用于表达运行时前提条件
常用 PHP 系统扩展虚拟包清单
以下是在主流框架（Laravel、CI4、Symfony、Drupal 10）和组件中高频出现的虚拟包，按是否「默认启用」和「常被忽略」分类：
-
ext-mbstring：几乎所有现代 PHP 框架都强制要求，处理多字节字符串（如中文路径、JSON 编码）。Windows 下 WampServer 默认关闭，需手动勾选；Ubuntu 用sudo apt install php-mbstring -
ext-openssl：Composer 自身依赖它下载包，Laravel 的加密、API 请求、HTTPS 流也依赖它。WampServer 8.1+ 默认开启，但某些精简版 PHP 可能未编译进内核 -
ext-pdo+ext-pdo_mysql（或ext-pdo_pgsql）：数据库驱动基础。注意：仅装pdo不够，必须装对应数据库的 PDO 驱动扩展 -
ext-intl：CodeIgniter 4 和 Symfony 的国际化（i18n）组件强依赖。Ubuntu 下叫php-intl，WampServer 需单独启用，且有时需复制icu*.dll到 PHP 目录 -
ext-xml：DOM、SimpleXML、SOAP 等模块的基础。Drupal 10 模块安装、Laravel 的 Artisan 命令生成 XML 报告都绕不开它 -
ext-zip：Composer 安装插件、Laravel 的php artisan storage:link、CI4 的spark命令解压资源时用到。Windows 下容易因 DLL 缺失报Class 'ZipArchive' not found -
php:>=8.1：这不是扩展，但它是最高频的虚拟约束。Composer 会比对PHP_VERSION_ID，而不是看php -v输出的字符串——所以别信终端里显示的 “PHP 8.2.0RC1”，它可能被判定为不满足>=8.1
为什么 composer install 成功了却报扩展未加载
这是最易被忽略的环节：Composer 只校验「安装时」的环境，不保证「运行时」一致。典型场景包括：
- 你在 CLI 模式下执行
composer install（使用 CLI 的 php.ini），但 Web 服务器（Apache/Nginx）加载的是另一份 php.ini（如 WampServer 的 Apache 模块版），导致扩展启用状态不一致 - Docker 容器里
php -m | grep mbstring有输出，但 Nginx + PHP-FPM 配置里没把php-fpm.conf或www.conf中的clear_env = no设为 false，导致环境变量丢失，扩展加载失败 - 你用
composer create-project初始化项目时用了 PHP 8.2，但部署到生产服务器是 PHP 8.0，虽然composer install --no-dev没报错，运行时却因缺少str_contains()等函数直接 fatal error - 某些扩展（如
ext-redis）需额外配置redis.so路径或extension=redis行写在正确 php.ini 里，而 Composer 完全不干预这个过程
验证方式永远是：在目标运行环境下执行 php -m（CLI）或新建一个 info.php 放在 Web 根目录里调用 phpinfo()，对照扩展列表逐项确认。
