PHP生成验证码：合并文件后调用函数设img src遇黑屏问题

你遇到的黑屏问题，核心是把直接输出图片的函数放到了img的src属性里，这违背了HTTP请求的基本逻辑：

• 原来的captcha.php是一个独立的请求端点，当浏览器加载<img src="captcha.php">时，会单独向这个URL发请求，captcha.php返回的是完整的图片HTTP头+二进制数据，浏览器能正确解析为图片。
• 但现在你把generateCaptcha()直接写到src里调用时，这个函数会直接向当前页面的输出流写入图片头和二进制数据——而你的主页面已经在输出HTML内容了：
  1. HTTP头必须在任何页面内容（包括HTML标签、空格）之前发送，函数里的header()会因为已有输出而报错，导致图片无法正确生成。
  2. 就算头能发送，函数输出的二进制图片数据会被当作字符串塞进src属性里，这完全不是浏览器期待的URL格式，自然会显示黑屏/损坏的图片。

方案1：保留独立文件（推荐） #

这是最稳妥且符合规范的方式，只是把验证码逻辑封装到函数里，放到captcha.php中：

captcha.php内容：

<?php
function generateCaptcha() {
    // 你的验证码生成逻辑，比如创建画布、绘制验证码文字等
    $Immagine = imagecreatetruecolor(100, 30);
    // ... 其他验证码绘制代码 ...

    header("Content-type: image/png");
    imagepng($Immagine);
    imagedestroy($Immagine);
}

// 调用函数输出图片
generateCaptcha();
?>

主页面依然用原来的方式调用：

<img src="captcha.php">

方案2：转为Data URI嵌入（适合小图片） #

如果一定要把代码合并到同一个文件，可以让generateCaptcha()返回Data URI格式的字符串，而不是直接输出图片。Data URI允许把图片二进制数据转为base64编码的字符串，直接作为src的值：

修改后的generateCaptcha()函数：

function generateCaptcha() {
    // 你的验证码生成逻辑，比如创建画布、绘制文字
    $Immagine = imagecreatetruecolor(100, 30);
    $bgColor = imagecolorallocate($Immagine, 255, 255, 255);
    $textColor = imagecolorallocate($Immagine, 0, 0, 0);
    imagefill($Immagine, 0, 0, $bgColor);
    imagestring($Immagine, 5, 30, 8, rand(1000,9999), $textColor);
    // ... 其他验证码逻辑 ...

    // 开启输出缓冲，捕获图片内容
    ob_start();
    imagepng($Immagine);
    // 获取缓冲的二进制数据并清理缓冲
    $imageBinary = ob_get_clean();
    imagedestroy($Immagine);

    // 转为base64并返回Data URI
    return 'data:image/png;base64,' . base64_encode($imageBinary);
}

然后主页面可以直接调用：

<img src="<?php echo generateCaptcha(); ?>">

注意：这种方式的图片无法被浏览器缓存，每次刷新页面都会重新生成，适合验证码这种不需要缓存的场景，但如果图片较大可能会增加页面体积。

内容的提问来源于stack exchange，提问作者Sbrebbaz