FrankenPHP 1.2 默认不内置 GD 扩展，仅动态构建版或自定义环境可启用；静态二进制（如 frankenphp_1.2.0_linux_amd64）基于 NTS PHP 且不支持运行时加载 gd.so，必须从构建源头集成 GD（如修改构建参数加 --with-gd），否则硬加载会导致启动失败或崩溃。
FrankenPHP 1.2 默认不内置 GD 扩展，需手动启用，但关键前提：你用的不是官方预编译的静态二进制（如 frankenphp_1.2.0_linux_amd64），而是动态构建版或自定义安装环境——因为静态二进制基于 NTS PHP 构建，且**不支持运行时加载外部扩展**（包括 GD）。
确认当前环境是否支持加载扩展
运行以下命令判断基础条件：
-
frankenphp php-cli -i | grep "Thread Safety"→ 若显示 disabled，说明是 NTS 环境，可尝试加载 NTS 版 GD -
frankenphp php-cli -m | grep gd→ 若无输出，说明 GD 尚未启用 -
frankenphp php-cli -r "var_dump(extension_loaded('gd'));"→ 返回bool(false)即未加载
启用 GD 的两种可行路径
路径一：使用 FrankenPHP 官方 Docker 镜像（推荐）
直接拉取带 GD 的镜像，省去编译烦恼：
-
docker run --rm -v $(pwd):/app -w /app dunglas/frankenphp:static-builder-gnu php -m | grep gd→ 该镜像已预装 NTS 版 GD - 在项目中通过
extension=gd.so启用（确保php.ini中该行未被注释）
路径二：自行构建含 GD 的 FrankenPHP
适用于需要控制 PHP 源码或扩展版本的场景：
立即学习“PHP免费学习笔记（深入）”；
- 克隆
frankenphp仓库，修改构建脚本（如.github/workflows/build.yml）中的 PHP 配置参数，加入--with-gd --with-freetype --with-jpeg - 确保系统已安装开发依赖：
libfreetype6-dev libjpeg-dev libpng-dev（Debian/Ubuntu） - 执行
make build-static或make build-dynamic，生成带 GD 的二进制
验证 GD 是否真正可用
别只看 php -m，要实测函数调用：
-
frankenphp php-cli -r "var_dump(function_exists('imagecreate'));"→ 应返回bool(true) -
frankenphp php-cli -r "echo gd_info()['GD Version'];"→ 输出类似bundled (2.3.3) - 若报错
Call to undefined function imagecreate()，说明扩展虽加载但函数未注册，常见于 GD 编译时缺失字体库或配置不全
静态二进制下硬塞 gd.so 会导致启动失败或运行时崩溃，这不是配置问题，而是 ABI 不兼容。真正能跑 GD 的 FrankenPHP，必须从构建源头就集成它。
