FrankenPHP 默认不内置 GD 扩展，需确认系统 PHP 是否编译支持 GD，Linux 安装 php-gd 包并重启 FrankenPHP，Windows/macOS 需配置 php.ini 启用 extension=gd 并验证实际 HTTP 运行时效果。
FrankenPHP 默认不内置 GD 扩展，它基于 SAPI（Server API）模型运行，与传统 Apache/Nginx + PHP-FPM 模式不同，扩展需显式启用且依赖底层 PHP 构建时是否包含 GD 支持。报错如 Call to undefined function imagecreate() 或 gd_info() not found，说明 GD 未加载或根本未编译进 PHP。
确认 FrankenPHP 使用的 PHP 是否含 GD 编译支持
FrankenPHP 运行时调用的是系统已安装的 PHP 可执行文件（通常是 php 命令），不是自带 PHP。因此第一步不是改配置，而是查这个 PHP 是否“原生支持 GD”：
- 在终端运行：
php -m | grep gd—— 若无输出，说明 GD 未安装或未启用 - 运行：
php -r "print_r(gd_info());"—— 若报错函数不存在，或返回false，说明 GD 未就绪 - 运行：
php -i | grep -i "gd support"—— 正常应显示GD Support => enabled
Linux 系统：安装 php-gd 包并确保与 FrankenPHP 调用的 PHP 版本匹配
FrankenPHP 不会自动加载系统包管理器安装的扩展；但它依赖你系统中 php 命令的行为。所以你要让这个命令背后的 PHP 支持 GD：
- Ubuntu/Debian：
sudo apt update && sudo apt install php-gd（自动匹配当前php版本，如 php8.2-gd） - CentOS/RHEL/Rocky/AlmaLinux：
sudo dnf install php-gd或sudo yum install php-gd - 安装后必须重启 FrankenPHP 进程（不是 Web 服务器），因为 FrankenPHP 启动时会缓存 PHP 扩展状态
- 验证：停止 FrankenPHP，再运行
php -m | grep gd确认出现gd，然后重新启动 FrankenPHP
Windows/macOS：检查 php.ini 并确认 extension_dir 和 DLL/so 路径正确
FrankenPHP 在这些平台仍调用本地 PHP 二进制，所以需手动配置：
立即学习“PHP免费学习笔记（深入）”；
- 找到 FrankenPHP 实际调用的
php可执行文件位置（可通过which php或where php查看） - 定位其对应的
php.ini（运行php --ini显示加载路径） - 编辑该 php.ini，确保以下两行存在且未注释：
-
extension_dir = "ext"（或绝对路径，如C:\php\ext） -
extension=gd（Windows 下可能是extension=php_gd2.dll，Linux/macOS 一般为extension=gd） - 确认
ext/目录下存在php_gd2.dll（Win）或gd.so（macOS/Linux） - 保存后，重启 FrankenPHP（kill 进程再启动，不要仅 reload）
验证 GD 是否真正可用（绕过缓存和环境干扰）
别只信 phpinfo() 页面——FrankenPHP 的 HTTP 请求可能走不同 SAPI 分支。最可靠方式是写一个最小测试脚本，在 FrankenPHP 服务下直接运行：
<?php
if (!extension_loaded('gd')) {
die('GD extension not loaded');
}
$info = gd_info();
if (!$info['gd_version']) {
die('GD loaded but no version info — likely broken build');
}
if (!$info['jpg_support'] || !$info['png_support']) {
echo "Warning: JPEG/PNG support missing — may affect image processing\n";
}
echo "GD OK. Version: {$info['gd_version']}\n";
?>
将此保存为 test-gd.php，通过 FrankenPHP 提供的 HTTP 路由访问（如 http://localhost/test-gd.php），结果才反映真实运行时状态。
