ThinkPHP 6 模型动态构建查询条件详解-连界优站

内容目录

ThinkPHP 6 是一款高性能、低学习成本的 PHP 框架，广泛应用于企业级 Web 应用开发。在实际项目中，动态构建查询条件是非常常见的需求，可以帮助我们根据不同的业务逻辑灵活地查询数据。本文将详细介绍 ThinkPHP 6 中如何实现模型的动态构建查询条件，并提供一些常见问题的解决方案，帮助你快速上手这一强大的开发工具。

📚 模型动态构建查询条件简介 📚

1. 什么是模型动态构建查询条件？

模型动态构建查询条件是指在查询过程中，根据不同的条件动态地构建查询语句。这使得我们可以根据前端传来的参数或者业务逻辑的变化，灵活地调整查询条件，从而获取所需的数据。

2. 动态构建查询条件的主要用途

灵活性：根据不同的业务需求动态调整查询条件。
可维护性：代码更加清晰，易于维护和扩展。
性能优化：减少不必要的查询，提高查询效率。

🛠️ 实现模型动态构建查询条件 🛠️

1. 基本用法

示例代码

假设我们有一个用户表（user），表结构如下：

CREATE TABLE `user` (
    `id` INT(11) NOT NULL AUTO_INCREMENT,
    `username` VARCHAR(255) NOT NULL,
    `email` VARCHAR(255) NOT NULL,
    `age` INT(11) DEFAULT NULL,
    `status` TINYINT(1) DEFAULT 1,
    PRIMARY KEY (`id`)
);

我们在 application/model 目录下创建 User 模型。

namespace app\model;

use think\Model;

class User extends Model
{
    // 表名
    protected $table = 'user';
}

2. 动态构建查询条件

示例代码

namespace app\controller;

use think\Controller;
use app\model\User;

class UserController extends Controller
{
    public function searchUsers($params)
    {
        $query = User::where(function ($query) use ($params) {
            if (!empty($params['username'])) {
                $query->where('username', 'like', '%' . $params['username'] . '%');
            }
            if (!empty($params['email'])) {
                $query->where('email', 'like', '%' . $params['email'] . '%');
            }
            if (!empty($params['age'])) {
                $query->where('age', $params['age']);
            }
            if (isset($params['status'])) {
                $query->where('status', $params['status']);
            }
        });

        $users = $query->select();

        return json($users);
    }
}

3. 使用场景

示例场景

假设我们有一个用户管理页面，需要根据用户名、邮箱、年龄和状态动态查询用户。

// 假设这是前端传来的参数
$params = [
    'username' => '张三',
    'email' => 'example.com',
    'age' => 25,
    'status' => 1
];

// 调用控制器方法
$users = (new UserController())->searchUsers($params);

// 输出结果
echo json_encode($users);

4. 高级用法

使用闭包

你可以在 where 方法中使用闭包来构建更复杂的查询条件。

$query = User::where(function ($query) use ($params) {
    if (!empty($params['username'])) {
        $query->where('username', 'like', '%' . $params['username'] . '%');
    }
    if (!empty($params['email'])) {
        $query->where('email', 'like', '%' . $params['email'] . '%');
    }
    if (!empty($params['age'])) {
        $query->where('age', $params['age']);
    }
    if (isset($params['status'])) {
        $query->where('status', $params['status']);
    }
});

使用 `when` 方法

when 方法可以根据条件选择性地执行查询。

$query = User::when(!empty($params['username']), function ($query) use ($params) {
    $query->where('username', 'like', '%' . $params['username'] . '%');
})
->when(!empty($params['email']), function ($query) use ($params) {
    $query->where('email', 'like', '%' . $params['email'] . '%');
})
->when(!empty($params['age']), function ($query) use ($params) {
    $query->where('age', $params['age']);
})
->when(isset($params['status']), function ($query) use ($params) {
    $query->where('status', $params['status']);
});

$users = $query->select();