Laravel 查询构建器中使用 whereIn 的正确数组语法-php教程-PHP中文网

Laravel 查询构建器中使用 whereIn 的正确数组语法

在 Laravel 查询构建器中，若需通过数组形式的 where() 调用实现 whereIn 逻辑（而非改用 whereIn() 方法或 whereRaw），需采用三元组 [字段, 操作符, 值] 的扩展语法，并将操作符设为 'in'（小写），且确保 $clientId 是一维数组。

在 laravel 查询构建器中，若需通过数组形式的 `where()` 调用实现 `wherein` 逻辑（而非改用 `wherein()` 方法或 `whereraw`），需采用三元组 `[字段, 操作符, 值]` 的扩展语法，并将操作符设为 `'in'`（小写），且确保 `$clientid` 是一维数组。

Laravel 的 where($array) 方法支持一种紧凑的数组语法：[column, operator, value]。当操作符为 'in'（注意必须为小写字符串 'in'，而非大写的 'IN'）时，查询构建器会自动将其解析为 SQL 的 IN 子句——这正是你所需的 whereIn 行为，且无需修改方法调用形式。

✅ 正确写法如下：

$clientId = [1, 5, 12]; // 必须是一维索引数组（如从 request()->array('ids') 或 DB 查询获取）

$where = [['Participants.Client_Id', 'in', $clientId]];

$results = DB::table('Participants')->where($where)->get();

⚠️ 注意事项：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

操作符必须是小写 'in'；'IN'、'In' 或 'IN '（含空格）均不被识别，会导致 SQL 错误或意外全表扫描；
$clientId 必须为非空数组，且元素应为可安全绑定的标量值（整型/字符串）。若可能为空，请提前判断并跳过该条件，例如：
```
$where = [];
if (!empty($clientId)) {
    $where[] = ['Participants.Client_Id', 'in', $clientId];
}
$results = DB::table('Participants')->where($where)->get();
```
字段名建议统一使用不含表前缀的格式（如 'Client_Id'），除非存在多表同名字段冲突；Laravel 会原样传递至 SQL，因此 Participants.Client_Id 在部分数据库（如 MySQL 严格模式）下可能因反引号缺失引发语法错误，推荐写作 'Client_Id' 并配合 ->from('Participants as p') 显式别名管理。