ThinkPHP 3.2 验证码与分页功能实现详解

一、验证码功能实现

ThinkPHP 内置了图像验证码类 ORG.Util.Image，支持多种验证码类型。实现过程分为控制器生成图片、视图模板展示及后台校验三个部分。

第1步：准备验证码图片生成入口

目的：创建一个专门用于生成验证码图片的 Action，确保不输出其他 HTML 内容以免影响图片显示。

• 入口文件：CommonAction.class.php（或具体业务 Controller）
• 关键动作：引入 Image 类并调用生成方法。

<?php
class CommonAction extends Action{
  function verify(){    
    import('ORG.Util.Image');
    // 可选：英文验证码
    // Image::buildImageVerify(5,5,'gif',90,30,'verify');
    
    // 默认：中文验证码示例
    // 参数说明：长度4, png格式, 默认宽高, simhei.ttf字体, session名verify
    Image::GBVerify();
  }  
}

第2步：在视图中嵌入验证码组件

目的：在前端表单中显示验证码图片，并提供点击刷新功能。

• 模板路径：index.html
• 参数注意：img 标签的 src 需指向上述生成的 Action URL。

<!-- 输入框 -->
验证码：<input type="text" name="verify" />
<!-- 点击图片触发JS刷新 -->
<img src="__APP__/common/verify" onclick="show(this)" /><br />
<input type="submit" value="注册" />

<script type="text/javascript">
function show(obj){
  // 添加随机数防止浏览器缓存旧图片
  obj.src="__APP__/common/verify/random/"+Math.random();    
}
</script>

第3步：后端验证用户输入

目的：获取用户提交的验证码，并与 Session 中存储的正确值进行比对。

• 操作入口：表单提交对应的处理方法（如 UserAction.class.php）
• 校验逻辑：通常 ThinkPHP 会加密存储在 session 中的验证码，需使用 md5() 对接收到的 POST 数据进行哈希比对。

// 假设 $_POST['verify'] 为用户输入的字符串
if($_SESSION['verify']!=md5($_POST['verify'])){
  $this->error('验证码不正确');   
}

第4步：排查常见报错

如果页面无法显示验证码或出现白屏，请依次检查以下环境条件：

1. GD 库支持：确认 PHP 环境已安装并启用 GD 扩展。
2. BOM 头干扰：检查所有 PHP 文件是否保存为 UTF-8 无 BOM 格式，任何额外的空格或输出都会破坏图片流。
3. 类库路径：确认 ORG.Util.Image 类是否存在且正确导入。
4. 字体文件：若使用中文验证码，确保字体文件（如 simhei.ttf）存在于类库目录或指定绝对路径。

二、分页功能实现

利用 ThinkPHP 的 ORG.Util.Page 类可以大幅简化分页逻辑，实现自动统计总数、生成分页链接及处理 LIMIT 查询。

第1步：配置控制器分页逻辑

目的：在查询数据前计算总行数，构建 Page 对象，并将查询范围限制在当前页。

• 入口文件：UserAction.class.php
• 参数设置：$page = new Page($count, 每页条数)

function index(){
  import('ORG.Util.Page');// 引入分页类
  $user=M('user');
  
  // 1. 计算总记录数
  $count=$user->count();
  
  // 2. 初始化分页对象，每页显示5条（此处根据需求调整）
  $page=new Page($count,5);
  
  // 3. 自定义分页样式 (可选)
  $page->setConfig('header','条记录');
  $page->setConfig('prev','上一页');
  $page->setConfig('next','下一页');
  
  // 4. 获取分页SQL片段并执行查询
  // limit 的第一个参数是起始位置，第二个是每页条数
  $list=$user->field(array('id','username','createip'))-
            ->order('id desc')-
            ->limit($page->firstRow.','.$page->listRows)-
            ->select();
            
  // 5. 分配变量到模板
  $this->assign('alist',$list);
  $this->assign('page',$page->show());
  $this->display();
}

第2步：在模板中渲染列表与分页

目的：遍历当前页数据并输出分页导航栏。

• 模板文件：index.html

<volist name="alist" id="vo">
 <li>
   ID：{$vo['id']} | 
   用户名：{$vo['username']} | 
   注册IP：{$vo['createip']} | 
   <a href="__URL__/del/id/{$vo['id']}">删除</a> | 
   <a href="__URL__/edit/id/{$vo['id']}">编辑</a>
 </li>
</volist>

<!-- 输出分页导航 HTML -->
{$page}

以上就是 ThinkPHP 验证码和分页功能的详细内容，更多关于 ThinkPHP 实战开发的资料请关注本站其它相关文章！