使用PHP創(chuàng)建圖像驗證碼的示例代碼

更新時間：2026年04月01日 09:19:02 作者：我叫黑大帥

PHP?圖像驗證碼的實現(xiàn)完全基于GD?庫,它是?PHP?官方內(nèi)置的圖像處理擴(kuò)展,提供了畫布創(chuàng)建、顏色分配、文本繪制、圖形渲染、圖片輸出等全能力,下面小編就和大家詳細(xì)介紹一下具體如何實現(xiàn)的吧

Windows 環(huán)境：打開php.ini，去掉extension=gd前的分號注釋，重啟 Web 服務(wù)（Apache/Nginx/PHP-FPM）
Linux 環(huán)境：編譯 PHP 時添加--with-gd參數(shù)，或通過包管理器安裝php-gd擴(kuò)展（如yum install php-gd/apt install php-gd），重啟服務(wù)生效

生成驗證碼

第一步：開啟Session與配置

<?php
// 開啟Session，用于存儲驗證碼校驗值（必須在輸出前執(zhí)行，無任何前置空格）
session_start();
// 引入驗證碼配置
$captchaConfig = [
    // 基礎(chǔ)尺寸配置
    'width'       => 150,         // 驗證碼圖片寬度
    'height'      => 50,          // 驗證碼圖片高度
    // 字符配置
    'length'      => 4,           // 驗證碼字符長度，常用4-6位
    'charset'     => '23456789ABCDEFGHJKLMNPQRSTUVWXYZ', // 字符集：去掉易混淆的0/O、1/l，提升用戶體驗
    'font_size'   => 24,          // 字體字號
    'font_file'   => './fonts/arial.ttf', // TTF字體文件路徑，必須填寫正確，否則無法繪制文字
    // 干擾項配置（平衡安全性與識別度）
    'line_num'    => 6,           // 干擾線數(shù)量
    'pixel_num'   => 100,         // 噪點數(shù)量
    // 安全配置
    'expire'      => 300,         // 驗證碼有效期，單位秒，默認(rèn)5分鐘
    'session_key' => 'captcha_code', // Session存儲的key
];

第二步：創(chuàng)建畫布+分配基礎(chǔ)顏色

// 創(chuàng)建真彩色畫布
$img = imagecreatetruecolor($captchaConfig['width'], $captchaConfig['height']);
// 分配背景色：淺色系背景，提升文字辨識度（240-255區(qū)間）
$bgColor = imagecolorallocate($img, 245, 245, 245);
// 分配文字顏色：深色系，隨機(jī)生成避免固定色值被OCR識別
$textColor = imagecolorallocate($img, rand(10, 50), rand(10, 50), rand(10, 50));
// 填充畫布背景
imagefill($img, 0, 0, $bgColor);

API 函數(shù)	核心作用
`imagecreatetruecolor(int $width, int $height)`	創(chuàng)建真彩色的圖像畫布，是驗證碼的載體
`imagecolorallocate(resource $image, int $red, int $green, int $blue)`	為畫布分配 RGB 顏色，用于背景、文字、干擾項繪制
`imagefill(resource $image, int $x, int $y, int $color)`	為畫布填充背景色，從坐標(biāo) (x,y) 開始填充

第三步：生成隨機(jī)驗證碼字符串

$code = '';
$charsetLen = strlen($captchaConfig['charset']);
for ($i = 0; $i < $captchaConfig['length']; $i++) {
    // 從字符集中隨機(jī)取一個字符，拼接成最終驗證碼
    $code .= $captchaConfig['charset'][rand(0, $charsetLen - 1)];
}

第四步：繪制干擾元素（先畫干擾項，再畫文字，避免文字被遮擋）

// 繪制隨機(jī)干擾線
for ($i = 0; $i < $captchaConfig['line_num']; $i++) {
    // 隨機(jī)生成線條顏色（淺色系，不搶文字視覺）
    $lineColor = imagecolorallocate($img, rand(100, 200), rand(100, 200), rand(100, 200));
    // 隨機(jī)生成線條起點和終點，貫穿整個畫布
    imageline(
        $img,
        rand(0, $captchaConfig['width']),
        rand(0, $captchaConfig['height']),
        rand(0, $captchaConfig['width']),
        rand(0, $captchaConfig['height']),
        $lineColor
    );
}
// 繪制隨機(jī)噪點
for ($i = 0; $i < $captchaConfig['pixel_num']; $i++) {
    // 隨機(jī)生成噪點顏色
    $pixelColor = imagecolorallocate($img, rand(50, 150), rand(50, 150), rand(50, 150));
    // 隨機(jī)生成噪點位置
    imagesetpixel($img, rand(0, $captchaConfig['width']), rand(0, $captchaConfig['height']), $pixelColor);
}

imageline(resource $image, int $x1, int $y1, int $x2, int $y2, int $color) 繪制直線，多用于添加干擾線，增加機(jī)器自動識別難度
imagesetpixel(resource $image, int $x, int $y, int $color)繪制單個像素點，用來生成噪點干擾，強化驗證碼防破解效果

第五步：繪制驗證碼字符到畫布

// 計算單個字符的寬度，均勻分布在畫布上
$singleWidth = $captchaConfig['width'] / $captchaConfig['length'];
for ($i = 0; $i < $captchaConfig['length']; $i++) {
    // 每個字符隨機(jī)旋轉(zhuǎn)-10到10度，防止機(jī)器識別
    $angle = rand(-10, 10);
    // 計算字符的x坐標(biāo)，左右留邊距，均勻分布
    $x = $singleWidth * $i + rand(5, 10);
    // 計算字符的y坐標(biāo)，垂直居中（基線對齊，避免文字下沉）
    $y = $captchaConfig['height'] / 2 + $captchaConfig['font_size'] / 3;
    // 寫入單個字符到畫布
    imagettftext(
        $img,
        $captchaConfig['font_size'],
        $angle,
        $x,
        $y,
        $textColor,
        $captchaConfig['font_file'],
        $code[$i]
    );
}

imagettftext(resource $image, float $size, float $angle, int $x, int $y, int $color, string $font_file, string $text)寫入 TrueType 字體文本，是繪制驗證碼字符的核心，支持自定義字體、字號、文字旋轉(zhuǎn)角度

第六步：存儲驗證碼到Session，完成服務(wù)端持久化

// 存儲加密后的驗證碼+過期時間，生產(chǎn)環(huán)境建議加密存儲，避免Session泄露
$_SESSION[$captchaConfig['session_key']] = [
    'code' => strtolower($code), // 轉(zhuǎn)小寫，實現(xiàn)不區(qū)分大小寫校驗，提升用戶體驗
    'expire_time' => time() + $captchaConfig['expire'] // 過期時間戳
];

第七步：輸出圖片到瀏覽器

// 聲明響應(yīng)頭為PNG圖片，禁止瀏覽器緩存
header('Content-Type: image/png');
header('Cache-Control: no-cache, no-store, must-revalidate');
header('Pragma: no-cache');
// 輸出圖片
imagepng($img);
// 銷毀畫布資源，釋放內(nèi)存
imagedestroy($img);

imagepng(resource $image) 以 PNG 格式輸出圖像，可直接推送到瀏覽器，也能保存為圖片文件
imagedestroy(resource $image) 銷毀畫布圖像資源，釋放服務(wù)器內(nèi)存，是代碼收尾必備操作
header(string $header) 設(shè)置 HTTP 響應(yīng)頭，告知瀏覽器返回內(nèi)容為圖片格式，避免頁面出現(xiàn)亂碼

校驗驗證碼

<?php
// 1. 開啟Session，與生成端保持一致
session_start();
// 2. 配置項，必須與生成端保持一致
$captchaConfig = [
    'session_key' => 'captcha_code',
];
// 3. 封裝校驗函數(shù)，可全局復(fù)用
function checkCaptcha(string $userInput): array
{
    global $captchaConfig;
    // 3.1 先判斷用戶是否輸入了驗證碼
    if (empty($userInput)) {
        return ['status' => false, 'msg' => '請輸入驗證碼'];
    }
    // 3.2 判斷服務(wù)端是否存在驗證碼Session
    if (!isset($_SESSION[$captchaConfig['session_key']])) {
        return ['status' => false, 'msg' => '驗證碼已過期，請刷新重試'];
    }
    // 3.3 取出Session中的驗證碼數(shù)據(jù)
    $captchaData = $_SESSION[$captchaConfig['session_key']];
    // 3.4 校驗驗證碼是否過期
    if (time() > $captchaData['expire_time']) {
        // 過期后立即銷毀，防止復(fù)用
        unset($_SESSION[$captchaConfig['session_key']]);
        return ['status' => false, 'msg' => '驗證碼已過期，請刷新重試'];
    }
    // 3.5 校驗驗證碼是否正確（統(tǒng)一轉(zhuǎn)小寫，不區(qū)分大小寫）
    if (strtolower(trim($userInput)) !== $captchaData['code']) {
        // 校驗失敗立即銷毀，防止破解
        unset($_SESSION[$captchaConfig['session_key']]);
        return ['status' => false, 'msg' => '驗證碼錯誤，請刷新重試'];
    }
    // 3.6 校驗成功，立即銷毀當(dāng)前驗證碼，防止重放攻擊（單次有效）
    unset($_SESSION[$captchaConfig['session_key']]);
    return ['status' => true, 'msg' => '驗證碼校驗通過'];
}
// 4. 調(diào)用示例（用戶POST提交表單時）
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // 獲取用戶輸入的驗證碼
    $userCaptcha = $_POST['captcha'] ?? '';
    // 執(zhí)行校驗
    $checkResult = checkCaptcha($userCaptcha);
    if (!$checkResult['status']) {
        // 校驗失敗，返回錯誤信息
        echo json_encode(['code' => 400, 'msg' => $checkResult['msg']]);
        exit;
    }
    // 校驗通過，執(zhí)行后續(xù)業(yè)務(wù)邏輯（登錄、注冊、發(fā)送短信等）
    echo json_encode(['code' => 200, 'msg' => '操作成功']);
    exit;
}