萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

ThinkPHP 驗證碼完整接入指南:控制器、模板、JS 刷新、路由配置

ThinkPHP 內置驗證碼功能基於 GD 庫,通過 Image::buildImageVerify() 生成。本文提供從控制器生成、模板展示、AJAX 無刷新切換、__PUBLIC__ 路徑配置到常見坑點的完整接入指南,基於 ThinkPHP 3.2+ 驗證,兼容 5.x/6.x 思想。

一、控制器生成驗證碼

<?php
namespace Home\Controller;
use Think\Controller;

class LoginController extends Controller
{
    public function verify()
    {
        // 1. 清空之前的輸出緩衝(關鍵!防止圖片輸出前有空白/錯誤信息導致圖片損壞)
        ob_clean();

        // 2. 導入 Image 類(ThinkPHP 內置擴展庫)
        // 實際路徑:ThinkPHP/Library/Think/Image.class.php
        // import('ORG.Util.Image'); // 3.1 寫法,3.2+ 建議用命名空間
        vendor('Think.Image'); // 或使用 Loader::import()

        // 3. 生成驗證碼
        // 參數:長度、模式(1數字2字母3混合)、類型、寬、高、session名
        \Think\Image::buildImageVerify([
            'length'   => 4,
            'mode'     => 3,        // 數字+字母混合
            'type'     => 'png',
            'width'    => 120,
            'height'   => 40,
            'verifyName' => 'verify', // session 存儲鍵名
            'fontSize' => 18,
            'useCurve' => true,     // 干擾曲線
            'useNoise' => true,     // 干擾點
        ]);
    }
}

二、模板頁面接入

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>後台登錄</title>
    <script src="__PUBLIC__/Js/jquery-1.12.4.min.js"></script>
    <script>
        // 換一張驗證碼
        function changeVerify(imgObj) {
            // 關鍵:加隨機參數防止瀏覽器緩存
            imgObj.src = "__URL__/verify/" + Math.random();
            return false;
        }
    </script>
</head>
<body>
    <form action="__URL__/login" method="post">
        用戶名:<input type="text" name="username" required><br>
        密碼:<input type="password" name="password" required><br>
        驗證碼:
        <input type="text" name="verify" size="10" required>
        <img src="__URL__/verify" id="verifyImg" style="cursor:pointer; vertical-align:middle;" onclick="changeVerify(this)" title="點擊刷新">
        <a href="javascript:;" onclick="changeVerify(document.getElementById('verifyImg'))">看不清?</a>
        <br>
        <input type="submit" value="登錄">
    </form>
</body>
</html>

三、__PUBLIC__ 常量配置詳解

__PUBLIC__ 是模板輸出時自動替換的模板變量,默認指向 /Public/(項目入口文件同級)。若需自定義:

方法 1:配置文件 (Application/Common/Conf/config.php)

<?php
return [
    // 模板輸出替換規則
    'TMPL_PARSE_STRING' => [
        '__PUBLIC__' => __ROOT__ . '/Public',  // 項目根目錄/Public
        // '__STATIC__' => __ROOT__ . '/Public/Static', // 可額外定義
    ],
];

方法 2:控制器動態賦值

$this->assign('__PUBLIC__', '/custom/public/path');

四、登錄驗證邏輯

public function login()
{
    if (!IS_POST) $this->display();

    $username = I('post.username');
    $password = I('post.password');
    $verify   = I('post.verify');

    // 1. 驗證碼校驗(不區分大小寫)
    if (!check_verify($verify)) {
        $this->error('驗證碼錯誤');
    }

    // 2. 用戶驗證...
    $user = M('User')->where(['username' => $username])->find();
    if ($user && password_verify($password, $user['password'])) {
        session('user_id', $user['id']);
        session('username', $user['username']);
        $this->success('登錄成功', U('Index/index'));
    } else {
        $this->error('用戶名或密碼錯誤');
    }
}

/** 驗證碼校驗輔助函數(可放 Common/function.php) */
function check_verify($code, $verifyName = 'verify')
{
    $verify = new \Think\Verify();
    return $verify->check($code, $verifyName);
}

五、常見坑點與解決

現象原因解決
圖片顯示「圖片無法顯示/損壞」驗證碼生成前有輸出(空白行、BOM、錯誤信息)生成前調用 ob_clean();確保 PHP 文件無 BOM、無前置輸出
點擊刷新不變瀏覽器緩存同 URL 圖片JS 中添加隨機參數 Math.random() 或時間戳
Session 驗證總是失敗session 未啟動、verifyName 不一致、session 存儲異常確認 session_start()、配置一致、檢查 session.save_path 權限
生產環境不顯示GD 库未安裝或 freetype 不支持php -m | grep gd,安裝 php-gd,確保配置 --with-freetype
偽靜態導致 .html 後綴路由規則添加了 .html 後綴驗證碼路由單獨配置無後綴,或 JS 中構造不帶後綴的 URL

六、安全加固建議

  1. 增加干擾: 開啟 useCurve、useNoise,設置 fontSize、imageW/imageH 適當增大。
  2. 限制嘗試次數: Session 記錄失敗次數,超過 5 次鎖定 15 分鐘或要求更強驗證(滑塊、短信)。
  3. 防止暴力破解: 登錄接口加入 IP 限流(Redis 計數器)。
  4. HTTPS 傳輸: 確保登錄頁面全站 HTTPS,防止驗證碼被中間人劫持。
  5. 考慮第三方: 高安全場景接入 Google reCAPTCHA v3、Geetest、阿里云驗證碼等行業成熟方案。

以上配置已在多個 ThinkPHP 3.2/5.0 項目驗證通過。核心原理通用:服務端生成圖片+存Session → 前端展示+隨機參數刷新 → 提交時校驗Session。掌握這條主線,任何框架都能快速接入。

copyright © 萬盛學電腦網 all rights reserved