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/(項目入口文件同級)。若需自定義:
<?php
return [
// 模板輸出替換規則
'TMPL_PARSE_STRING' => [
'__PUBLIC__' => __ROOT__ . '/Public', // 項目根目錄/Public
// '__STATIC__' => __ROOT__ . '/Public/Static', // 可額外定義
],
];
$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 |
useCurve、useNoise,設置 fontSize、imageW/imageH 適當增大。以上配置已在多個 ThinkPHP 3.2/5.0 項目驗證通過。核心原理通用:服務端生成圖片+存Session → 前端展示+隨機參數刷新 → 提交時校驗Session。掌握這條主線,任何框架都能快速接入。