6.2.3 实现模糊查询-Yii2框架从入门到精通(上)

当前位置:　首页>> 技术小册>> Yii2框架从入门到精通(上)

6.2.3 实现模糊查询

在Web开发中，模糊查询是一种常见的需求，它允许用户通过输入部分关键字来搜索匹配的数据记录，从而在不精确知道完整信息的情况下也能找到相关结果。Yii2框架作为PHP的一个高效、安全的Web开发框架，提供了丰富的数据库操作方法，包括实现模糊查询的功能。本章节将详细介绍在Yii2中如何实现模糊查询，包括使用ActiveRecord、DbQuery以及原生SQL语句等多种方式。

6.2.3.1 理解模糊查询的基本概念

模糊查询，又称作通配符查询或模式匹配查询，主要依赖于SQL中的LIKE操作符。LIKE操作符用于在WHERE子句中搜索列中的指定模式。在SQL中，%代表任意数量的字符（包括零个字符），而_代表一个字符。通过组合这些通配符与关键字，可以构建出灵活的搜索条件。

6.2.3.2 使用ActiveRecord实现模糊查询

Yii2的ActiveRecord是ORM（对象关系映射）的一种实现方式，它允许你将数据库表映射为PHP类，并通过这些类的方法直接操作数据库。使用ActiveRecord实现模糊查询，主要是通过在查询条件中嵌入LIKE表达式。

示例：搜索用户表中的用户名

假设我们有一个用户表user，其中包含字段username，现在我们想搜索所有用户名中包含”john”的记录。

use app\models\User; // 假设User是对应user表的ActiveRecord类
// 使用find()方法创建查询
$query = User::find();
// 添加模糊查询条件
// 注意：在Yii2中，可以使用orFilterWhere和andFilterWhere方法来处理带有通配符的模糊查询
// 这里使用andFilterWhere，表示“并且”满足条件
$query->andFilterWhere(['like', 'username', 'john']);
// 执行查询并获取结果
$users = $query->all();
// 遍历结果
foreach ($users as $user) {
    echo $user->username . "<br>";
}

在上面的例子中，andFilterWhere方法接收三个参数：第一个参数是条件类型（这里是'like'），第二个参数是字段名（这里是'username'），第三个参数是匹配的模式（这里是'john'）。Yii2会自动在'john'前后添加%通配符，形成完整的LIKE条件'username' LIKE '%john%'。

6.2.3.3 使用DbQuery实现模糊查询

除了ActiveRecord，Yii2还提供了DbQuery组件，允许你以更灵活的方式构建SQL查询。当需要执行更复杂的查询或操作非ActiveRecord映射的表时，DbQuery是一个很好的选择。

示例：使用DbQuery搜索用户

use Yii;
use yii\db\Query;
// 创建一个Query对象
$query = new Query();
// 选择`user`表
$query->select('*')
      ->from('user')
      // 添加模糊查询条件
      ->where(['like', 'username', 'john']);
// 执行查询并获取结果
$command = $query->createCommand();
$users = $command->queryAll();
// 遍历结果
foreach ($users as $user) {
    echo $user['username'] . "<br>";
}

在这个例子中，我们直接通过Query类构建了查询，并使用了where方法来添加LIKE条件。注意，虽然这里也是where方法，但内部实现会根据传递的参数类型（数组且第一个元素为'like'）自动构建出相应的SQL条件。

6.2.3.4 使用原生SQL实现模糊查询

在某些情况下，为了性能优化或执行特别复杂的查询，你可能需要直接使用原生SQL语句。Yii2提供了createCommand方法来允许你执行原生SQL语句。

示例：使用原生SQL搜索用户

use Yii;
// 构建SQL语句
$sql = "SELECT * FROM user WHERE username LIKE '%john%'";
// 创建命令并执行查询
$command = Yii::$app->db->createCommand($sql);
$users = $command->queryAll();
// 遍历结果
foreach ($users as $user) {
    echo $user['username'] . "<br>";
}