PHP生成验证码图片代码示例

本文深入解析了PHP生成图形验证码时图片空白的常见原因，重点指出问题往往源于HTTP头未正确设置或输出被空格、UTF-8 BOM等不可见字符干扰；强调脚本必须是纯PHP文件（无HTML、无空行、无BOM），且首行必须调用`header('Content-Type: image/png');`，并指导开发者如何在VS Code或PhpStorm中确保文件保存为UTF-8无BOM格式，提供切实可行的排错与实操方案。

PHP 用 imagecreate() 生成基础图形验证码时为什么图片空白？

常见原因是没设置正确的 HTTP 头或输出被空格/UTF-8 BOM 干扰。生成验证码的 PHP 脚本必须是纯代码文件（无 HTML、无空行、无 UTF-8 BOM），且开头就要调用 header('Content-Type: image/png');。

实操建议：

• 保存文件为 UTF-8 无 BOM 格式（VS Code / PhpStorm 右下角可切换）
• 脚本第一行就是 ，前面不能有任何字符（包括空格和换行）
• 生成后直接 imagepng($img); imagedestroy($img);，不要 echo 或 print
• 浏览器直接访问该 PHP 文件（如 /captcha.php），不是嵌在 HTML 里执行

如何让 $_SESSION['captcha'] 和图形内容一致？

核心是先生成验证码字符串，再存入 session，最后画图。顺序错会导致表单校验永远失败。

典型错误写法：imagestring() 画完图才去生成随机字符串并塞进 session —— 这时字符串根本没参与绘图，图形和 session 值天然不一致。

正确流程：

• 用 str_shuffle('23456789ABCDEFGHJKLMNPQRSTUVWXYZ') 截取 4–6 位，避免易混淆字符
• 立即存入 $_SESSION['captcha'] = $code;（确保 session 已启动）
• 再用 imagestring() 或逐个字符 imagechar() 绘制到图像上
• 若开启 session_start() 太晚（比如在绘图之后），$_SESSION 写入会失败

验证码加干扰线/噪点后反而识别率下降？

不是加得越多越好。过度扭曲或密集噪点会让 GD 库渲染模糊，OCR 或人眼都难辨认，还可能触发某些浏览器的图像拦截策略。

轻量抗干扰更实用：

• 用 imageline($img, rand(0, $width), rand(0, $height), rand(0, $width), rand(0, $height), $line_color) 画 3–5 条浅灰线
• 用 imagesetpixel() 随机打 20–50 个噪点，颜色接近背景色（如背景白，噪点用 rgb(230, 230, 230)）
• 避免使用 imagefill() 全图填充噪点，这会严重破坏文字边缘
• 字体大小建议 16–20px，用真字体（imagettftext()）比位图字体更清晰，但需确保 .ttf 路径正确

为什么本地能显示，上线后提示“Headers already sent”？

绝大多数是 Web 服务器（如 Nginx + PHP-FPM）配置或部署方式导致输出缓冲未生效，或者 error_log 写入触发了隐式输出。

排查重点：

• 检查是否有 error_reporting(E_ALL); ini_set('display_errors', '1'); 开着 —— 错误信息会提前输出，破坏 header
• 确认 PHP 是否启用了 output_buffering = On（php.ini 中），或在脚本开头加 ob_start();
• Apache 下常见于 .htaccess 插入了额外输出；Nginx 下注意是否启用了 fastcgi_buffering 或 gzip 压缩干扰
• 用 headers_sent($file, $line) 定位哪行提前输出，常是日志函数、warning 或 include 的文件带 BOM

GD 扩展是否启用、字体文件路径是否存在、session 存储目录是否可写——这些看似基础的点，在跨环境部署时最容易被忽略。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。