ThinkPHP 驗證碼與分頁功能完整實作指南

ThinkPHP 驗證碼與分頁功能完整實作指南

驗證碼與分頁是 Web 專案中最基礎也最常用的兩大功能。本文將詳細說明如何在 ThinkPHP 中實作英文/中文驗證碼，以及靈活客製化的分頁顯示，提供可直接複製套用的完整程式碼。

一、驗證碼實作

核心類別與方法

ThinkPHP 內建 ORG.Util.Image 類別提供驗證碼生成功能：

• 英文/數字驗證碼：buildImageVerify($length, $mode, $type, $width, $height, $verifyName)
• 中文驗證碼：GBVerify($length, $type, $width, $height, $fontface, $verifyName)

參數說明

控制器實作

<?php
class CommonAction extends Action {
    public function verify() {
        import('ORG.Util.Image');
        // 英文驗證碼範例：5碼混合模式、gif格式、90x30
        // Image::buildImageVerify(5, 5, 'gif', 90, 30, 'verify');
        // 中文驗證碼（使用預設參數）
        Image::GBVerify();
    }
}
?>

視圖模板

<form action="" method="post">
    驗證碼：<input type="text" name="verify" />
    <img src="__APP__/Common/verify" onclick="show(this)" style="cursor:pointer; vertical-align:middle;" /><br />
    <input type="submit" value="註冊" />
</form>

<script type="text/javascript">
function show(obj) {
    // 點擊圖片更新驗證碼，加入隨機參數防快取
    obj.src = "__APP__/Common/verify/random/" + Math.random();
}
</script>

控制器驗證邏輯

<?php
// 在處理表單的 Action 中
if ($_SESSION['verify'] != md5($_POST['verify'])) {
    $this->error('驗證碼錯誤');
}
?>

常見問題排查

1. 確認 PHP 已安裝 GD 函式庫並支援 FreeType（中文驗證碼需求）。
2. 檢查輸出前是否有任何輸出（含 UTF-8 BOM），會導致圖片無法顯示。
3. 中文驗證碼需將字體檔 simhei.ttf 複製到 ORG/Util/ 目錄下。
4. Image 類別是否正確導入：import('ORG.Util.Image');

二、分頁功能實作

控制器實作

<?php
class UserAction extends Action {
    public function index() {
        import('ORG.Util.Page'); // 導入分頁類別
        $user = M('user');
        $count = $user->count(); // 總筆數
        $page = new Page($count, 3); // 每頁 3 筆
        
        // 客製化分頁樣式
        $page->setConfig('theme', '<div>總共：%totalRow% %header% %nowPage%/%totalPage% 頁 %first% %upPage% %prePage% %linkPage% %nextPage% %downPage% %end%</div>');
        
        $show = $page->show(); // 取得分頁 HTML
        $list = $user->field(array('id', 'username', 'createip'))
                    ->order('id desc')
                    ->limit($page->firstRow . ',' . $page->listRows)
                    ->select();
        
        $this->assign('alist', $list);
        $this->assign('page', $show);
        $this->display();
    }
}
?>

視圖模板

<volist name="alist" id="vo">
    <li>
        <span>ID：</span>{$vo['id']}
        <span>用戶名：</span>{$vo['username']}
        <span>註冊IP：</span>{$vo['createip']}
        <a href="__URL__/del/id/{$vo['id']}">刪除</a>
        <a href="__URL__/edit/id/{$vo['id']}">編輯</a>
    </li>
</volist>
{$page}

進階分頁客製化技巧

1. 使用圖片作為上/下頁按鈕

<?php
$page->setConfig('prev', '<img id="prev" src="/Public/img/prev.png" />');
$page->setConfig('next', '<img id="next" src="/Public/img/next.png" />');
$page->setConfig('theme', '%upPage% %downPage%'); // 僅顯示上下頁
?>

2. 封裝通用分頁方法（推薦放入基礎控制器）

<?php
protected function _list($map, $model, $limit = 9, $order = 'add_time') {
    $p = empty($_GET['p']) ? 1 : (int)$_GET['p'];
    $list = $model->where($map)->order($order)->page($p . ',' . $limit)->select();
    
    import('ORG.Util.Page');
    $count = $model->where($map)->count();
    $Page = new Page($count, $limit);
    $Page->rollPage = 3; // 顯示頁碼數量
    $Page->setConfig('theme', " %upPage% %linkPage% %downPage% <li style='width:50px'><a href='javascript:void(0)'>%nowPage%/%totalPage% 頁</a></li>");
    
    return array('list' => $list, 'page' => $Page->show());
}
?>

總結

驗證碼與分頁是 ThinkPHP 專案的基石功能。掌握 Image 類別的多種驗證碼模式與 Page 類別的靈活客製化，能大幅提升開發效率。建議將常用分頁邏輯封裝至基礎控制器，實現程式碼複用。