Composer可管理PHP扩展依赖，通过在composer.json的require中声明ext-*扩展（如ext-curl、ext-pdo），确保环境兼容性；安装时检查扩展是否存在及版本是否满足，缺失则报错。
Composer 主要管理 PHP 的类库依赖，比如第三方包（如 Guzzle、Symfony 组件等），但它也支持声明对 PHP 扩展（ext-*）的依赖。这些扩展指的是编译进 PHP 或通过 PECL 安装的原生扩展，例如 ext-curl、ext-pdo、ext-mbstring 等。
1. 在 composer.json 中声明扩展依赖
你可以在 composer.json 的 require 字段中直接添加对 PHP 扩展的依赖：
{
"require": {
"php": "^8.1",
"ext-curl": "*",
"ext-pdo": "^1.0",
"ext-json": "*",
"monolog/monolog": "^2.0"
}
}
上面的例子表示：
- 需要 PHP 版本不低于 8.1
- 必须安装并启用
curl扩展（版本不限） - 需要
PDO扩展，且版本不低于 1.0（大多数核心扩展版本为 1.x） - 需要
json扩展（PHP 5.2+ 内置，但仍可声明）
2. Composer 如何处理 ext 依赖
当你运行 composer install 或 composer update 时，Composer 会：
立即学习“PHP免费学习笔记（深入）”；
- 检查当前 PHP 环境中是否已加载所声明的扩展
- 验证扩展的版本是否满足约束条件
- 如果缺少某个扩展或版本不满足，会中断安装并提示错误
例如，若系统未启用 ext-curl，你会看到类似提示：
DolphinPHP
下载
一个基于ThinkPHP5.0开发的开源PHP快速开发框架，秉承极简、极速、极致的开发理念，为开发集成了基于数据-角色的权限管理机制，集成多种灵活快速构建工具，可方便快速扩展的模块、插件、钩子、数据包，统一了模块、插件、钩子、数据包之间的版本和依赖关系，进一步降低了代码和数据的沉余，以方便开发者快速构建自己的应用。
Problem 1
- Root composer.json requires ext-curl * -> it is missing from your system.
Install or enable PHP's curl extension.
3. 可选扩展的处理：使用 require-dev 或建议（suggest）
有些扩展不是必需的，仅用于增强功能（如 ext-gd 用于图像处理）。你可以将它们放在 require-dev 中，或用 suggest 提示用户：
{
"require": {
"php": "^8.1"
},
"require-dev": {
"ext-gd": "*"
},
"suggest": {
"ext-gd": "Needed for image manipulation"
}
}
suggest 不会影响安装流程，只是友好提示。而 require-dev 中的扩展只在运行 composer install --dev 时检查。
4. 常见 ext-* 名称示例
一些常见的 PHP 扩展在 Composer 中的写法：
-
ext-dom– DOM 文档处理 -
ext-pdo_mysql– MySQL PDO 驱动 -
ext-redis– Redis 扩展（需 PECL 安装） -
ext-sodium– 加密支持（PHP 7.2+） -
ext-zip– ZIP 压缩支持
注意：扩展名是 php -m 命令输出的名称，前面加上 ext- 前缀即可。
基本上就这些。Composer 不会自动安装 PHP 扩展（那是系统或 PECL 的职责），但它能有效阻止在不兼容环境中部署代码，提升项目的稳定性。
