Eloquent 查询构建器变量的克隆与隔离操作-php教程-PHP中文网

Eloquent 查询构建器变量的克隆与隔离操作

在 laravel 中，eloquent 查询构建器是链式调用且可变的对象，直接复用同一实例进行多次 where() 会导致原始查询被持续修改；需通过 clone 创建独立副本，确保各查询逻辑互不干扰。

在 laravel 中，eloquent 查询构建器是链式调用且可变的对象，直接复用同一实例进行多次 where() 会导致原始查询被持续修改；需通过 clone 创建独立副本，确保各查询逻辑互不干扰。

Eloquent 的查询构建器（如 Order::query() 或 (new Order)->query()）本质上是一个可变对象（mutable object），其内部维护着查询条件、排序、分页等状态。当你执行：

$orders = (new Order)->where('placed_by', '=', 'client');

此时 $orders 是一个尚未执行的查询构建器实例。而后续调用：

$totalPrice100 = $orders->where('total_price', '=', '100');
$totalPrice10  = $orders->where('total_price', '=', '10');

⚠️ 问题就在这里：$orders->where(...) 并非返回全新查询，而是原地修改 $orders 并返回自身引用（即 Fluent Interface 设计），因此两次调用后，$orders 内部已累积两个 WHERE 条件（placed_by = 'client' AND total_price = '100' AND total_price = '10'），这显然不符合预期，且 $totalPrice100 和 $totalPrice10 实际指向同一个（已被污染的）构建器。

✅ 正确做法是：对原始构建器使用 clone 创建独立副本。Laravel 的查询构建器实现了 PHP 的 __clone() 方法，能安全复制查询状态（包括绑定参数、连接配置、where 子句等）：

// 基础查询（不执行）
$baseQuery = Order::where('placed_by', 'client');

// 克隆出两个完全独立的查询实例
$query100 = clone $baseQuery;
$query10  = clone $baseQuery;

// 各自添加不同条件，互不影响
$result100 = $query100->where('total_price', 100)->get();
$result10  = $query10->where('total_price', 10)->get();

// 验证：原始 $baseQuery 未被修改
dd($baseQuery->toSql()); // "select * from `orders` where `placed_by` = ?"

? 小贴士：