ThinkPHP中如何实现带条件查询的分页功能？

题目

ThinkPHP中如何实现带条件查询的分页功能？

信息

• 类型：问答
• 难度：⭐⭐

考点

查询构造器使用,分页功能实现,条件查询构建,模型操作

快速回答

在ThinkPHP中实现带条件查询的分页功能需要以下步骤：

1. 使用where()方法构建动态查询条件
2. 通过paginate()方法实现分页
3. 在模板中使用分页渲染方法render()
4. 处理表单提交的查询参数并保持分页状态

1. 功能需求说明

在实际项目中经常需要实现：根据用户输入的条件（如商品名称、分类）筛选数据，并将结果分页展示，同时分页链接需要保留查询条件。

2. 核心实现步骤

2.1 控制器代码示例

// 应用/controller/Product.php
public function index()
{
    // 接收查询参数
    $name = input('get.name/s', '');
    $categoryId = input('get.category_id/d', 0);

    // 构建查询条件
    $where = [];
    if (!empty($name)) {
        $where[] = ['name', 'like', "%{$name}%"]; 
    }
    if ($categoryId > 0) {
        $where[] = ['category_id', '=', $categoryId];
    }

    // 带条件的分页查询
    $list = ProductModel::where($where)
                ->order('create_time', 'desc')
                ->paginate([
                    'list_rows' => 10,  // 每页数量
                    'query'     => input('get.') // 保留GET参数
                ]);

    // 渲染模板
    return view('index', [
        'list' => $list,
        'name' => $name,
        'categoryId' => $categoryId
    ]);
}

2.2 模板文件示例（index.html）

<!-- 查询表单 -->
<form method="get" action="">
    <input type="text" name="name" value="{$name}" placeholder="商品名称">
    <select name="category_id">
        <option value="0">所有分类</option>
        {volist name="categories" id="vo"}
        <option value="{$vo.id}" {$vo.id==$categoryId?'selected':''}>
            {$vo.name}
        </option>
        {/volist}
    </select>
    <button type="submit">搜索</button>
</form>

<!-- 数据列表 -->
<table>
    {volist name="list" id="product"}
    <tr>
        <td>{$product.name}</td>
        <td>{$product.price}</td>
    </tr>
    {/volist}
</table>

<!-- 分页输出 -->
<div class="page">{$list|raw}</div>

3. 关键原理说明

• paginate()方法：ThinkPHP内置的分页方法，会自动处理limit和count查询
• query参数：paginate()的query选项用于保持URL参数，确保翻页时查询条件不丢失
• 条件构建：使用where()方法链式操作，支持数组方式传入动态条件
• 模板渲染：{$list|raw}中的raw过滤器防止分页HTML被转义

4. 最佳实践

• 参数过滤：使用input('get.name/s')中的类型声明进行安全过滤
• 查询优化：对高频查询字段添加数据库索引
• 分页配置：在config/paginate.php中设置全局分页参数
• 模型分层：复杂查询建议在模型中封装查询作用域

5. 常见错误

• 条件丢失：忘记在paginate()中传递query参数导致翻页后条件丢失
• SQL注入：直接拼接查询条件而未使用参数绑定
• 性能问题：在大数据表分页时未优化limit查询（应避免使用select count(*)）
• 模板错误：未使用|raw过滤器导致分页链接显示为HTML代码

6. 扩展知识

• 高性能分页：百万级数据可使用->page()->limit()配合前端分页控件
• AJAX分页：监听分页链接点击事件，通过API获取分页数据
• 查询作用域：在模型中封装常用查询条件
  示例：

  // 模型内定义作用域
  public function scopeSearch($query, $name)
  {
      $query->where('name', 'like', "%$name%");
  }
  
  // 控制器调用
  ProductModel::scopeSearch($name)->paginate();

• 关联模型分页：使用->withJoin()->paginate()处理关联表分页