在Laravel的Eloquent查询构造器中,当我们需要把多个查询的结果集合并,并且希望保留所有重复的记录时,就需要使用union all方法,而不是默认的union方法。默认的union会自动对合并后的结果进行去重处理,而union all不会做去重,会直接把多个查询的结果依次拼接起来。

Eloquent union all基础用法
union all的使用方式很简单,先构建第一个查询,然后通过union_all方法拼接后续查询即可。下面是一个基础的示例,假设我们有两个用户表相关的查询,需要合并结果保留重复数据。
<?php
// 第一个查询:获取状态为1的用户
$query1 = DB::table('users')->where('status', 1);
// 第二个查询:获取类型为2的用户,可能存在和第一个查询重复的记录
$query2 = DB::table('users')->where('type', 2);
// 使用union_all合并,保留重复结果
$result = $query1->union_all($query2)->get();
// 输出合并后的结果
foreach ($result as $item) {
echo $item->id . ':' . $item->name . PHP_EOL;
}
?>
Model模型中使用union all
如果是基于Eloquent Model进行查询,用法和查询构造器类似,直接调用union_all方法即可。以下是User模型的使用示例:
<?php
namespace AppModels;
use IlluminateDatabaseEloquentModel;
class User extends Model
{
// 获取合并后的用户数据,保留重复记录
public static function getUnionAllUsers()
{
// 第一个查询:年龄大于20的用户
$query1 = self::where('age', '>', 20);
// 第二个查询:注册时间在最近30天的用户
$query2 = self::where('created_at', '>=', now()->subDays(30));
// 合并查询
return $query1->union_all($query2)->get();
}
}
?>
union all结合排序和分页
使用union all合并查询后,也可以正常结合排序、分页等操作,不过需要注意排序和分页要放在最后一个查询之后,而不是中间的单个查询上。
<?php
// 合并查询后排序并分页
$query1 = DB::table('users')->where('status', 1);
$query2 = DB::table('users')->where('type', 2);
$result = $query1->union_all($query2)
->orderBy('created_at', 'desc') // 按创建时间倒序
->paginate(10); // 每页10条数据
?>
union all和union的区别
很多开发者会混淆这两个方法,以下是两者的核心差异:
| 对比项 | union | union all |
|---|---|---|
| 去重处理 | 会自动对合并后的结果去重 | 不会去重,保留所有重复记录 |
| 执行效率 | 相对较低,需要额外的去重运算 | 相对较高,不需要去重运算 |
| 适用场景 | 需要合并后结果唯一时 | 需要保留所有重复结果时 |
注意事项
- 使用union all合并的多个查询,字段数量和字段类型需要保持一致,否则可能会出现数据错乱或者报错。
- 如果是跨表查询,两个表的对应字段含义需要匹配,避免合并后出现无意义的数据。
- union all生成的SQL语句是直接拼接多个查询,不会自动添加括号,如果单个查询有复杂的where条件,建议先构建好单个查询再合并。
注意:union all只是数据库层面的结果合并,并不会对Eloquent模型的关系、访问器等额外功能做特殊处理,如果合并的查询涉及模型关联,需要提前处理好关联逻辑。