PHP怎么生成验证码_gd库绘制验证码教程【教程】-php教程-PHP中文网

gd画布初始化失败典型表现为imagecreatetruecolor()返回false或imagecolorallocate()报image resource警告，主因是gd未启用、memory_limit过小（建议≥32m）或docker/alpine环境缺失php-gd包。

php怎么生成验证码_gd库绘制验证码教程【教程】

调用 imagecreatetruecolor() 返回 false，或者后续 imagecolorallocate() 报 Warning：“supplied argument is not a valid Image resource”，基本就是 GD 扩展没启用或内存不足。

先确认 php -m | grep gd 输出里有 gd，没输出就去 php.ini 开启 extension=gd（Windows 下是 php_gd2.dll）
如果已启用但画布仍创建失败，检查 memory_limit 是否太小——验证码图虽小，但 GD 在处理抗锯齿、字体渲染时临时内存开销可能翻倍，建议不低于 32M
某些 Docker 环境或精简版 PHP（如 alpine + php-cli）默认不带 GD，得手动装 php-gd 包，不是只改 ini 就行

用 imagefttext() 写字却一片空白，var_dump(file_exists($font_path)) 很可能返回 false——GD 不认相对路径，也不自动找系统字体目录。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

必须传绝对路径，比如 /var/www/fonts/arial.ttf，不能写 ./fonts/arial.ttf 或 fonts/arial.ttf
Linux 下注意 SELinux 或文件权限：web 用户（如 www-data）得有读取该 .ttf 文件的权限，chmod 644 是底线
Windows 下路径分隔符用正斜杠 / 更稳妥，C:\fonts\arial.ttf 容易因转义出问题，写成 C:/fonts/arial.ttf
字体文件本身要真实支持 ASCII 字符（验证码一般不用中文），有些免费下载的 .ttf 实际只含 emoji 或日文，试下 DejaVuSans.ttf 或 arial.ttf 这类通用字体

验证码生成脚本单独访问正常，但一嵌入表单页就报 “headers already sent”，本质是 session 在输出 HTML 前没启动，或启动前已有空格、BOM、echo 干扰。

验证码脚本（如 captcha.php）第一行必须是 <?php ，前面不能有任何字符，包括 UTF-8 BOM —— 用 VS Code 或 Notepad++ 检查并转成 “UTF-8 无 BOM” 编码
不要在 session_start() 前做任何输出：删掉调试用的 echo、print_r，也别 include 了带空行的配置文件
如果必须复用已有页面逻辑，可用 ob_start() 提前开启输出缓冲，但这是补救，不是设计常态；更干净的做法是让 captcha.php 纯负责生成和写 session，不掺 HTML

浏览器反复加载同一张图，F5 也不变，是因为服务端没禁用缓存，或前端 img 的 src 被代理/CDN 缓存了。

在验证码脚本开头加三行头：header('Cache-Control: no-store, no-cache, must-revalidate, max-age=0');、header('Pragma: no-cache');、header('Expires: 0');
前端 <img src="captcha.php"> 改成带时间戳参数：<img src="captcha.php?t=<?php%20echo%20time();%20?>">，防止代理层缓存
注意：加随机参数后，别忘了 session 里存的验证码值也要对应这次请求，否则校验永远失败——每次生成新图，就得 $_SESSION['captcha'] = $code 一次，且不能被其他并发请求覆盖

GD 绘图本身不难，真正卡住人的永远是环境链路：扩展有没有、字体找不找得到、session 启没启好、缓存清没清干净。少一个环节，整条验证码流程就断在看不见的地方。