直接 composer require "captcha" 大概率失败，因无此通用包；应选 gregwar/captcha（轻量跨框架）或 mews/captcha（laravel 专用），并确保 gd 扩展启用、session 正确启动与管理。
为什么直接 composer require 一个叫 “captcha” 的包大概率失败
因为没有名为 captcha 的通用标准库——Composer 上真正可用、维护活跃的图形验证码方案只有几个，主流是 gregwar/captcha 和 mews/captcha（Laravel 生态常用）。前者轻量、无框架依赖；后者封装了 Laravel 服务提供者和路由，但底层仍是 Gregwar。装错包会导致 Class not found 或路由无法响应。
- 运行
composer require gregwar/captcha（推荐，PHP 7.4+ 支持，文档清晰） - 避免
composer require captcha或composer require simple-captcha（已废弃或不兼容 PHP 8） - 若用 Laravel，可选
composer require mews/captcha，但注意它会自动发布配置，而gregwar/captcha需手动实例化
生成验证码图片时提示 Call to undefined function imagecreate()
这是 GD 扩展未启用的典型错误，不是代码问题。Captcha 库依赖 GD 或 Imagick 生成图像，PHP 默认可能关闭 GD。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查
php -m | grep gd，无输出则需启用：Ubuntu 下运行sudo apt install php-gd，然后重启 PHP-FPM 或 Apache - Windows 用户确认
php.ini中取消注释extension=gd，并确保extension_dir指向正确的 ext 目录 - 若服务器禁用 GD（如某些共享主机），只能换方案——改用字符验证码（
gregwar/captcha提供CaptchaBuilder::getPhrase()+ 前端渲染）或迁移到前端 JS 生成（如easy-captcha）
表单提交后验证失败，但输入明明正确
根本原因通常是 session 未启动或验证码值未正确存储/读取。Gregwar 默认把验证码 phrase 存在 $_SESSION，但很多项目（尤其 CLI 或 API 场景）没开 session，或中间件覆盖了 session 生命周期。
- 确保在生成验证码前调用
session_start()（非 Laravel 项目必须显式写） - 验证时用
$captcha->check($_POST['captcha'])，而非直接比对 session 值——check()方法会自动清理 session 中的旧值，防止重复使用 - Laravel 用户注意：
mews/captcha的Captcha::check()依赖 Laravel 的 session 驱动，若用了 database 或 redis 驱动，需确认 session 连接正常；若用php artisan serve测试，浏览器 cookie 路径可能不匹配，导致 session 丢失
验证码图片返回 500 或空白，但日志没报错
常见于输出前已有内容（比如 BOM、空格、echo），破坏了图片的二进制响应头。PHP 输出缓冲和错误报告设置也会掩盖真实问题。
- 生成图片的脚本里，**不能有任何 echo/print/var_dump**，也不能包含带 UTF-8 BOM 的 PHP 文件
- 临时加一句
error_reporting(E_ALL); ini_set('display_errors', '1');在入口顶部，看是否报headers already sent - 用
file_get_contents('data:image/png;base64,' . base64_encode($captcha->inline()))替代直接输出，可绕过 header 冲突，适合嵌入模板中 - 如果部署在 Nginx，确认
fastcgi_buffering off;或添加fastcgi_max_temp_file_size 0;，避免缓存干扰图片流
