frankenphp macos或docker官方镜像中gd扩展需手动启用：官方镜像用install-php-extensions gd并验证gd_info()；非官方镜像或二进制版需brew install gd、修改php.ini添加extension=gd.so，并通过test-gd.php验证function_exists('imagecreatefrompng')返回true。
macOS上安装FrankenPHP v1.4后，GD扩展不会自动启用，因为FrankenPHP官方镜像默认不预装图像处理类扩展，必须手动触发安装流程并确认其在运行时被PHP加载。这一步遗漏会导致imagecreatefrompng、imagejpeg等函数报错“Call to undefined function”。
确认FrankenPHP是否为官方Docker镜像
FrankenPHP的install-php-extensions命令仅存在于官方镜像dunglas/frankenphp中。若你使用的是自建Alpine镜像、static-builder或从源码编译的二进制，则该命令根本不存在——此时需改用多阶段构建或本地CLI方式处理。
执行：docker exec -it your-frankenphp-container which install-php-extensions
若返回空或command not found，说明你不在官方镜像环境中，跳过本节后续步骤，直接进入「本地CLI方式启用GD」部分。
容器内启用GD扩展（官方镜像适用）
方法一：一键安装并验证
进入容器后直接运行：install-php-extensions gd
安装完成后，立即验证CLI环境：php -r "var_dump(gd_info()['GD Version']);"。若输出类似string(26) "bundled (2.3.3 compatible)"，说明GD已就绪；若报错Call to undefined function gd_info()，说明扩展未加载，继续下一步。
方法二：强制重载配置并重启服务
FrankenPHP容器内PHP配置由/usr/local/etc/php/conf.d/docker-php-ext-gd.ini控制，但该文件可能未被自动创建。手动补全：echo "extension=gd.so" > /usr/local/etc/php/conf.d/docker-php-ext-gd.ini
【关键】执行前确认so文件真实存在：运行find /usr/lib/php/extensions/ -name "gd.so" 2>/dev/null，若无任何输出，说明install-php-extensions未成功编译GD，需检查容器内是否已安装libpng-dev、jpeg-dev等系统依赖。
重启容器使新ini生效：exit退出后执行docker restart your-frankenphp-container。
本地CLI方式启用GD（非Docker或二进制部署场景）
第一步：确认Homebrew PHP与FrankenPHP共用同一套扩展路径
FrankenPHP macOS二进制版（如通过brew install dunglas/tap/frankenphp安装）底层仍调用Homebrew管理的PHP运行时。先查FrankenPHP实际使用的PHP路径：frankenphp --version会显示类似PHP 8.3.12 (cli)，再运行which php确认是否指向/opt/homebrew/bin/php。若不是，需先执行brew unlink php && brew link php@8.3切换版本。
第二步：安装GD扩展并写入php.ini
执行：brew install gd → 自动为当前PHP版本编译gd.so到/opt/homebrew/lib/php/pecl/20230831/gd.so
打开FrankenPHP读取的php.ini位置：php --ini | grep "Loaded Configuration File"，通常为/opt/homebrew/etc/php/8.3/php.ini
在该php.ini末尾追加一行：extension=gd.so
第三步：验证FrankenPHP是否识别该扩展
FrankenPHP CLI模式会继承系统PHP配置，但Web模式需额外确认。新建test-gd.php，内容为<?php var_dump(function_exists('imagecreatefrompng'));，然后用FrankenPHP启动服务：frankenphp server --document-root .，访问http://localhost/test-gd.php。输出bool(true)即成功。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
