Laravel 5.5 Query Builder如何实现带复合条件的Raw ON关联？

我之前也踩过这个坑，折腾了好几种join()+DB::raw()的组合都没搞定，后来发现Laravel的Query Builder其实支持用闭包回调来定义复杂的JOIN ON条件，既能处理多字段复合表达式，还能安全绑定参数，完全不用硬拼SQL！

核心解决方案：使用join的闭包回调 #

Laravel的join()方法可以接收一个闭包参数，在这个闭包里你可以自由组合多个ON条件，包括字段相等、自定义表达式，还能自动处理参数绑定。

示例1：多字段相等+参数绑定

假设你要实现类似这样的SQL：

SELECT *
FROM orders
JOIN order_items
  ON orders.id = order_items.order_id
  AND orders.user_id = ?
  AND order_items.status = ?

对应的Query Builder写法：

$userId = 123;
$status = 'completed';

$results = DB::table('orders')
    ->join('order_items', function ($join) use ($userId, $status) {
        // 基础字段相等条件
        $join->on('orders.id', '=', 'order_items.order_id');
        // 带参数的条件，自动绑定，避免SQL注入
        $join->where('orders.user_id', '=', $userId);
        $join->where('order_items.status', '=', $status);
    })
    ->get();

这里要注意：在闭包里调用where()方法，Laravel会自动把这些条件追加到ON子句里，而不是WHERE子句，非常方便！

示例2：自定义复合表达式+参数绑定

如果你的ON子句里有更复杂的表达式（比如加减运算、函数调用），可以用onRaw()方法配合参数占位符：

SELECT *
FROM products
JOIN inventory
  ON products.sku = inventory.sku
  AND (products.stock + inventory.stock) >= ?

对应的Query Builder写法：

$minStock = 10;

$results = DB::table('products')
    ->join('inventory', function ($join) use ($minStock) {
        $join->on('products.sku', '=', 'inventory.sku');
        // 自定义表达式，用?作为占位符，第二个参数传绑定值数组
        $join->onRaw('(products.stock + inventory.stock) >= ?', [$minStock]);
    })
    ->get();

避坑提醒 #

• 不要直接把参数拼进DB::raw()里，一定要用占位符?或者命名占位符，然后传递参数数组，防止SQL注入。
• 闭包里的use()关键字要正确传递外部变量，确保参数能被正确绑定。

内容的提问来源于stack exchange，提问作者artfulrobot