homebrew安装php后gd扩展需单独执行brew install gd并手动在php.ini中添加extension=gd.so启用，否则imagettftext()等函数报错或返回null；必须确保cli与web环境均调用同一homebrew php版本及配置文件，并验证底层依赖（freetype、jpeg、libpng）已预装且gd已重编译链接。
Homebrew安装的PHP默认不带GD扩展，必须单独安装gd并手动启用extension=gd.so，否则imagettftext()、imagecreatefrompng()等函数会报错或返回null。
确认当前PHP版本和路径是否正确
很多人执行php -v看到的是系统自带的旧版（/usr/bin/php），但Web服务器却调用了Homebrew安装的新版——或者反过来。这会导致CLI能用GD而Web环境报Call to undefined function imagettftext()。
- 运行
which php，输出应为/opt/homebrew/bin/php（Apple Silicon）或/usr/local/bin/php（Intel）；如果不是，需把Homebrew的bin加到$PATH开头，并source ~/.zshrc - 运行
php --ini，确认加载的php.ini路径是/opt/homebrew/etc/php/8.3/php.ini这类Homebrew路径，而非/etc/php.ini - 在Web环境里访问
phpinfo()，搜索“Loaded Configuration File”，确保它和CLI中php --ini显示的一致
安装gd扩展并启用so文件
Homebrew的php主包不包含gd.so，必须显式安装gd formula，它会为当前PHP版本编译适配的动态库。
- 先运行
brew install gd（不是php-gd，也不是php@8.3-gd——Homebrew已统一为gd） - 安装完成后，检查扩展文件是否存在：
ls /opt/homebrew/lib/php/20230831/gd.so（目录名20230831对应PHP 8.3的API编号，不同版本略有差异） - 编辑
php.ini（用php --ini查到的路径），添加一行：extension=gd.so；不要写extension=gd（无后缀会失败） - 如果同时需要FreeType支持（如验证码字体渲染），
brew install freetype是必需的——gdformula依赖它，但不会自动拉取；缺它时imagettftext()直接不可用
验证GD是否真正生效
只看php -m | grep gd成功还不够，GD依赖图像解码器（PNG/JPEG/WebP等），这些底层库可能缺失或版本不匹配，导致函数静默失败。
- CLI验证：运行
php -r "var_dump(gd_info()['PNG Support']);"，应输出bool(true)；若为false，说明libpng未被gd链接上 - Web验证：创建
test-gd.php，内容为<?php echo function_exists('imagecreatefrompng') ? 'OK' : 'MISSING'; ?>，浏览器访问——比phpinfo()更直接暴露函数可用性 - 常见静默故障：
imagecreatefromjpeg()返回false但无错误提示，大概率是libjpeg未被gd编译时识别；可重装brew reinstall jpeg && brew reinstall gd强制重建链接
Apache/Nginx实际调用的PHP模块是否同步
即使CLI和phpinfo()都显示GD已启用，Web服务器仍可能加载旧版libphp.so或完全绕过Homebrew PHP。
- Apache用户：检查
/etc/apache2/httpd.conf中LoadModule php_module指向的路径，应为/opt/homebrew/opt/php/lib/httpd/modules/libphp.so；旧路径如/usr/libexec/apache2/libphp7.so必须替换 - Nginx + PHP-FPM用户：确认
php-fpm进程启动时用的是Homebrew的配置，运行ps aux | grep php-fpm，看命令行参数中的-y是否指向/opt/homebrew/etc/php/8.3/php-fpm.d/www.conf - 重启服务后，务必用
curl http://localhost/info.php | grep -A5 'GD Support'确认Web响应里的GD状态，而不是只信本地终端
最易被忽略的一点：Homebrew安装的gd扩展依赖freetype、jpeg、libpng、webp四个底层库，它们必须在gd编译时就存在；如果先装gd再装freetype，gd.so不会自动重编译——得brew reinstall gd才行。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
