XAMPP 默认已编译 GD 扩展，需在 php.ini 中取消注释 extension=gd 并重启 Apache；验证用 phpinfo() 确认 GD Support 为 enabled，且调用 imagecreate() 等函数不报错。
确认 XAMPP 自带的 GD 扩展是否已启用
XAMPP 默认已编译 GD 库（gd），但 PHP 配置中可能未启用。直接检查 php.ini 是否加载了 extension=gd —— 这是开启图片验证码功能的前提，否则调用 imagecreate()、imagestring() 等函数会报 Call to undefined function imagecreate() 错误。
操作步骤：
- 打开 XAMPP 控制面板 → 点击
Config→ 选择PHP (php.ini) - 搜索
;extension=gd（注意分号表示注释），将其改为extension=gd（Windows 下无需写.dll后缀） - 保存后重启 Apache（必须！仅改配置不重启无效）
- 新建一个
info.php文件，内容为<?php phpinfo(); ?>，浏览器访问确认页面中出现 gd 模块且GD Support显示enabled
验证 GD 是否支持中文验证码所需字体
GD 默认只支持基本英文字符；若验证码需显示中文（如汉字干扰码），imagettftext() 依赖系统级字体文件，而 XAMPP 自带的 PHP 不自带中文字体路径。常见现象是验证码显示为方框或空白，错误日志里没有报错，但图像渲染失败。
解决方法：
- 下载一个免版权中文字体（如
simhei.ttf或NotoSansCJKsc-Regular.otf），放到项目目录下（例如C:\xampp\htdocs\myapp\font\simhei.ttf） - 在验证码生成代码中，显式传入绝对路径或 Web 可读的相对路径：
imagettftext($im, 14, 0, 20, 30, $color, __DIR__ . '/font/simhei.ttf', $text) - 确保该字体文件有读取权限（Windows 下一般无问题；Linux 虚拟机或 WSL 中需检查
chmod 644）
Apache + PHP-FPM 场景下 GD 不生效的特殊情况
如果你在 XAMPP 中启用了 PHP-FPM（通过 httpd-xampp.conf 中的 ProxyPassMatch 规则），那么 php.ini 的修改可能只作用于 CLI 或 Apache 模块模式，而 PHP-FPM 使用的是独立的 php-fpm.ini 或另一份 php.ini（路径通常是 C:\xampp\php\php.ini，但 FPM 实际加载的是 C:\xampp\php\php-fpm.ini 中指定的配置文件）。
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
判断和修复：
- 在
info.php页面中查找Loaded Configuration File，确认当前生效的php.ini路径 - 如果显示的是
C:\xampp\php\php.ini，就改这个；如果显示的是其他路径（如带fpm字样），就去对应位置启用extension=gd - 修改后需同时重启 Apache 和 PHP-FPM 服务（XAMPP 控制面板中两个都要 Stop → Start）
GD 开启后仍无法生成 PNG/JPEG 验证码的典型原因
即使 gd 扩展启用、字体可用，验证码仍返回空白或 500 错误，大概率是输出控制或 MIME 类型问题。GD 函数本身不自动发送 HTTP 头，也不清空输出缓冲区。
关键检查点：
- 验证码脚本开头不能有任何输出（包括 UTF-8 BOM、空格、
echo、print），否则图像流被破坏 - 必须手动设置响应头：
header('Content-Type: image/png');（对应imagepng()）或imagejpeg()+image/gif同理 - 调用
imagepng($im)后建议加imagedestroy($im)释放内存，尤其在高并发测试时避免资源堆积 - 若使用
imagejpeg()却没传质量参数，旧版 GD 可能默认质量 75，但某些环境会因压缩失败回退为空白图；显式写成imagejpeg($im, null, 90)更稳妥
最易被忽略的是：GD 支持依赖底层图像库（libpng、libjpeg、freetype），XAMPP Windows 版本虽已静态链接，但若你手动替换了 php_gd2.dll 或混用不同 PHP 版本的扩展，会导致模块加载失败且无明确报错——此时应以 phpinfo() 中的 GD Version 和 libPNG Support 等字段为准，而非仅看“enabled”。
