Composer不安装PHP扩展，但会在install/update时检查ext-xxx依赖是否满足，通过extension_loaded()验证；缺失则报错中断流程，不生成autoload.php。
Composer 本身不安装或启用 PHP 扩展，但它会在 composer install 或 composer update 时严格检查当前 PHP 环境是否满足项目所声明的 ext-xxx 依赖（如 "ext-mbstring": "*"），这是 Composer 内置的环境兼容性校验机制。
依赖声明方式：在 require 中写 ext-xxx
PHP 扩展依赖需显式写在 composer.json 的 require（或 require-dev）字段中，格式为 "ext-扩展名": "版本约束"。例如：
-
"ext-curl": "^7.0"—— 要求 cURL 扩展已加载，且 PHP 版本 ≥7.0（注意：这里版本号实际指 PHP 版本，不是 cURL 库版本） -
"ext-redis": "*"—— 要求 redis 扩展存在，不限定 PHP 版本 -
"ext-gd": ">=8.0"—— 要求 GD 扩展可用，且运行于 PHP 8.0 或更高版本
⚠️ 注意：ext-xxx 的版本约束只用于匹配 PHP 主版本号（如 7.4、8.1、8.3），不是扩展本身的版本号。Composer 不解析扩展的内部版本（如 redis 5.3.7），仅检查扩展是否被 extension_loaded('xxx') 返回 true。
检查时机与失败表现
Composer 在以下环节执行扩展检查：
立即学习“PHP免费学习笔记（深入）”；
- 解析依赖树前（
composer update） - 安装包前（
composer install，尤其是首次安装或 lock 文件变更后） - 运行
composer check-platform-reqs手动触发（推荐用于 CI/CD 或部署前验证）
若缺失必需扩展，Composer 会中断流程并报错，例如：
- Root composer.json requires ext-imagick *, but it is not installed.
此时不会生成 vendor/autoload.php，也不会下载任何包。
跳过检查的风险与替代方案
可通过 --ignore-platform-req=ext-xxx 或 --ignore-platform-reqs 强制跳过，但不推荐用于生产环境：
- 跳过检查 ≠ 扩展自动启用 —— 运行时仍会因
Class 'Imagick' not found等致命错误崩溃 - CI 流水线中跳过可能导致“本地能跑、线上挂掉”的问题
- 更稳妥的做法是：用
platform配置伪造环境（仅用于构建阶段模拟），例如：
该配置仅影响依赖解析（让 Composer 认为扩展存在），不改变实际运行环境，适合交叉构建场景。
如何确认扩展是否真正可用？
Composer 的检查基于 extension_loaded()，所以最终取决于 PHP 的配置：
- Linux/macOS：检查
php.ini中是否有extension=gd.so（或extension=gd）且路径正确 - Windows：检查
php.ini中是否有extension=php_gd2.dll - 使用
php -m | grep gd或php -i | grep -A5 "gd"快速验证 - Docker 用户：确保基础镜像已安装对应系统包（如
libgd-dev+php-gd）并启用扩展
Composer 只读取当前 CLI PHP 的配置（php --ini 显示的路径），与 Web 服务器（如 Apache/Nginx）使用的 php.ini 可能不同 —— 这也是本地命令行能装、Web 页面报错的常见原因。
