phpenv管理的PHP 8.2默认不带GD支持，必须在编译安装阶段通过预装libpng-dev、libjpeg-dev等依赖并执行phpenv install 8.2.27集成，不可后期通过php.ini启用；验证需确认gd_info()返回JPEG/PNG/WebP支持均为true且关键函数存在。
phpenv 管理的 PHP 8.2 默认不带 GD 支持，必须在编译安装阶段就集成，不是装完再开个扩展就行。
检查当前 PHP 8.2 是否已启用 GD
运行命令：php -i | grep "GD Support"
如果无输出，或显示 GD Support => disabled，说明未启用。此时调用 gd_info() 会报错 Call to undefined function gd_info()，所有图像函数（如 imagecreatetruecolor()）均不可用。
Ubuntu/Debian 下用 phpenv 安装带 GD 的 PHP 8.2
你不能靠 sudo apt install php8.2-gd 让 phpenv 的 PHP 生效——二者路径、二进制、扩展目录完全隔离。
必须确保编译前系统已装齐依赖：
-
libpng-dev（PNG 支持必需） -
libjpeg-dev（JPEG 支持必需） -
libfreetype6-dev（字体渲染必需） -
libwebp-dev（若需 WebP 支持）
然后执行：phpenv install 8.2.27
该命令会自动检测上述 dev 包并启用 GD —— 前提是它们已存在且版本兼容。
macOS 上 phpenv 编译 PHP 8.2 的 GD 常见失败点
Homebrew 安装的依赖默认不在 configure 默认搜索路径，configure 会静默跳过 GD，导致 gd_info() 返回全 false。
必须显式指定路径，例如：CONFIGURE_OPTS="--with-gd --with-png-dir=/opt/homebrew --with-jpeg-dir=/opt/homebrew --with-freetype-dir=/opt/homebrew" phpenv install 8.2.27
若用 Intel Mac，路径可能是 /usr/local；若 freetype 版本 ≥ 2.13，某些 PHP 8.2.x 小版本会因 FT_Property_Get 符号缺失而编译失败，可降级 freetype 或换用 8.2.25+ 补丁版。
验证 GD 功能是否完整可用
仅 gd_info()["GD Support"] === true 不够。必须检查关键格式支持：
-
gd_info()["JPEG Support"]应为true -
gd_info()["PNG Support"]应为true -
gd_info()["WebP Support"]（如有装libwebp-dev） -
function_exists("imagecreatefromjpeg")和function_exists("imagecreatetruecolor")都应返回true
漏掉任一格式，后续 imagecreatefromjpeg() 或 imagepng() 就会直接 fatal error。
GD 的编译集成点非常靠前，一旦 phpenv install 完成，就无法“热加”——重装是唯一可靠路径。很多人卡在以为改 php.ini 加 extension=gd 就行，其实那只是给预编译包用的，对源码编译的 PHP 完全无效。
立即学习“PHP免费学习笔记（深入）”；
