CLI 和 Web 环境 PHP 配置不同导致 gd 扩展缺失；需确认 php --ini 路径、安装对应系统 gd 包及依赖库（libpng/jpeg/webp），并验证 gd_info() 中具体格式支持。
php -m 里没 gd，但 phpinfo() 里有
这说明 CLI 和 Web 环境用了不同 PHP 配置。Composer 调用的是 php 命令，也就是 CLI 模式，它不看 Apache/Nginx 加载的 php.ini。
先执行：which php、php -v、php --ini，确认 CLI 实际加载的配置路径；再运行 php -m | grep gd —— 如果没输出，问题就出在这里。
- Ubuntu/Debian：运行
sudo apt install php-gd（或带版本号如php8.2-gd） - macOS + Homebrew：
brew reinstall php@8.2（确保 libpng/jpeg/webp 已装，否则重装会漏掉 gd） - Windows（XAMPP/WAMP）：打开
php --ini显示的 Loaded Configuration File，取消;extension=gd前的分号 - Docker：在
Dockerfile中加docker-php-ext-install gd，别只改php.ini
安装完还是报 ext-gd 缺失，检查 extension_dir 和依赖库
GD 扩展不是纯 PHP 代码，它依赖系统级图像库（libpng、libjpeg、libwebp）。即使 extension=gd 写对了，缺少底层库也会导致扩展加载失败，且 php -m 不报错、也不显示 gd。
验证方式：php -v 如果输出里带警告（如 “PHP Warning: Unable to load dynamic library 'gd.so'”），就是加载失败。
- Ubuntu/Debian：补装
sudo apt install libpng-dev libjpeg-dev libwebp-dev，再重装php-gd - Alpine Linux（Docker）：加
apk add jpeg-dev zlib-dev libpng-dev libwebp-dev，再docker-php-ext-install gd - macOS + Homebrew：确保已运行
brew install libpng jpeg webp，再brew reinstall php@8.2 - 手动编译 PHP 时：configure 阶段要带
--with-gd --with-jpeg-dir=/opt/homebrew/opt/jpeg --with-png-dir=/opt/homebrew/opt/libpng等路径
intervention/image 装上了却 imagecreatefromstring() 报错
这不是 Composer 的问题，是 GD 扩展功能不全。比如 WebP 支持需要 PHP ≥ 8.1 且 GD 编译时启用了 libwebp —— 即使 php -m | grep gd 成功，gd_info() 里 "webp support" => false 也会让 intervention/image 在处理 WebP 时静默失败或抛出模糊异常。
- 运行
php -r "print_r(gd_info());"，重点看webp support、avif support、jpeg support是否为true - Ubuntu 上启用 WebP：需装
libwebp-dev后重装php-gd；macOS 上重装前必须brew install webp - 别依赖
config.platform伪造"ext-gd": "*"，它骗不过gd_info()运行时检测 - 临时绕过：用
imagecreatefromjpeg()替代通用函数，但得自己校验文件头和 MIME 类型
CI/CD 或离线环境怎么跳过 ext-gd 检查
--ignore-platform-reqs 是唯一能绕过 Composer 安装阶段校验的方式，但它不解决运行时问题。你得清楚自己在跳什么。
- 只跳单个扩展：
composer install --ignore-platform-req=ext-gd - 跳多个：
composer install --ignore-platform-req=ext-gd --ignore-platform-req=ext-mbstring - 离线部署时，优先复制完整
vendor/目录（来自有网环境），而非依赖--ignore-platform-reqs重装 - Docker 场景下，
--ignore-platform-reqs可用，但 CI 流程中必须额外加一步：docker run myapp php -m | grep gd，确保容器内真有扩展
最常被忽略的一点：GD 扩展是否支持你要处理的图像格式，和它“是否存在”是两回事。报错消失 ≠ 功能可用，gd_info() 的输出比 php -m 更值得信任。
