Laravel Eloquent 高级查询：联接、关联与字段选择的最佳实践-php教程-PHP中文网

Laravel Eloquent 高级查询：联接、关联与字段选择的最佳实践

DDD

发布： 2025-09-21 22:45:17

原创

646人浏览过

laravel eloquent 高级查询：联接、关联与字段选择的最佳实践

本文深入探讨了在 Laravel Eloquent 中进行多表联接时，如何高效地从主表和关联表中选择特定字段。我们将详细讲解 with 预加载与 join 联接的差异与应用场景，并提供通过 leftJoin 结合子查询来获取一对多关系中最新关联记录的实践方法，同时解决常见的查询构建错误。

在 Laravel 应用中，构建复杂的数据库查询是常见需求。当涉及到多表联接（join）并同时需要预加载关联数据（with）时，如何精确控制 select 语句以获取所需字段，尤其是在字段名冲突和需要获取一对多关系中的特定（如最新）记录时，是一个常见的挑战。

理解 Eloquent 的 with 与 join

在深入解决方案之前，首先需要明确 Eloquent 中 with 和 join 的核心区别和适用场景。

with (Eager Loading) 预加载

作用： with 用于解决“N+1 查询”问题，它会在执行主查询之后，再单独执行一个或多个查询来获取关联模型的数据，并将这些数据绑定到主模型实例上。
特点： with 不会修改主查询的 SELECT 语句。关联数据作为模型属性（通常是集合或单个模型）存在，例如 $manualTicket->manual_ticket_log。因此，你不能直接在主查询的 SELECT 语句中引用通过 with 预加载的关联表的字段。
示例： ->with('manual_ticket_log') 会在获取 ManualTicket 记录后，再执行一次查询获取所有相关的 manual_ticket_log 记录。

join (SQL Join) 联接

作用： join 将两个或多个表在数据库层面进行物理联接，生成一个临时的结果集。
特点： 允许在主查询的 SELECT 语句中直接引用所有联接表的字段，并且可以在 WHERE、ORDER BY 等子句中直接使用这些字段进行过滤或排序。
示例： ->leftJoin('users as u', 'u.id', '=', 'manual_tickets.user_id') 允许在 select 语句中使用 u.name。

通过 join 语句选择关联字段

当需要将关联表的字段直接包含在主查询的结果集中，或者需要在 WHERE 子句中直接过滤关联表的字段时，join 是首选方法。

场景一：选择常规关联字段

为了从关联表中选择字段，你需要使用 join 方法将该表联接到主查询中。在 select 语句中，务必使用表别名（如果定义了）和字段名来明确指定要选择的字段，以避免字段名冲突。

例如，如果你需要从 manual_ticket_logs 表中选择字段，即使你已经使用了 with('manual_ticket_log')，也需要额外 join 该表：

use Illuminate\Support\Facades\DB;

$display_tickets = ManualTicket::select(
        'u.name as user_name',
        'i.name as initiator_name',
        'manual_tickets.status',
        'manual_tickets.description',
        'manual_tickets.location',
        'manual_tickets.created_at',
        'manual_tickets.initiator_id',
        'manual_tickets.id as manual_ticket_id',
        // 从联接的 manual_ticket_logs 表中选择字段
        'mtl.id as manual_ticket_log_id',
        'mtl.message as manual_ticket_log_message' // 假设 manual_ticket_logs 表有 message 字段
    )
    ->leftJoin('users as u', 'u.id', '=', 'manual_tickets.user_id')
    ->leftJoin('users as i', 'i.id', '=', 'manual_tickets.initiator_id')
    // 联接 manual_ticket_logs 表，并为其设置别名 mtl
    ->leftJoin('manual_ticket_logs as mtl', 'mtl.manual_ticket_id', '=', 'manual_tickets.id')
    ->where(function ($checkClients) use($target_client_id){
        $checkClients->where('u.client_id', '=', $target_client_id)
            ->orWhere('i.client_id', '=', $target_client_id);
    })
    ->whereBetween('manual_tickets.created_at', [$start_date->toDateString(), $end_date->addDays(1)->toDateString()])
    // ->with('manual_ticket_log') // 如果还需要通过模型属性访问所有日志，可以保留
    ->orderBy("created_at", "DESC")
    ->get();

登录后复制

场景二：获取一对多关系中的最新记录

在某些情况下，manual_tickets 与 manual_ticket_logs 之间可能是一对多关系，你可能只希望获取每张工单的最新一条日志的特定字段。这时，普通的 join 会返回多条记录（如果有多条日志），或者需要更复杂的联接条件。

微软文字转语音

微软文本转语音，支持选择多种语音风格，可调节语速。

查看详情

解决方案是在 leftJoin 的 on 子句中使用子查询来筛选出每个 manual_ticket 对应的最新 manual_ticket_log。

use Illuminate\Support\Facades\DB; // 确保引入 DB facade

$display_tickets = ManualTicket::select(
        'u.name as user_name',
        'i.name as initiator_name',
        'manual_tickets.status',
        'manual_tickets.description',
        'manual_tickets.location',
        'manual_tickets.created_at',
        'manual_tickets.initiator_id',
        'manual_tickets.id as manual_ticket_id',
        // 从联接的最新日志表中选择 ID 和 description
        'mtl.id as latest_manual_ticket_log_id',
        'mtl.description as latest_manual_ticket_log_description'
    )
    ->leftJoin('users as u', 'u.id', '=', 'manual_tickets.user_id')
    ->leftJoin('users as i', 'i.id', '=', 'manual_tickets.initiator_id')
    // 关键：使用子查询联接最新的一条 manual_ticket_log
    ->leftJoin('manual_ticket_logs as mtl', function ($join) {
        $join->on('mtl.manual_ticket_id', '=', 'manual_tickets.id')
             // 子查询找到每张工单的最大（最新）日志ID
             ->on('mtl.id', '=', DB::raw("(SELECT MAX(id) FROM manual_ticket_logs WHERE manual_ticket_logs.manual_ticket_id = manual_tickets.id)"));
    })
    ->where(function ($checkClients) use($target_client_id){
        $checkClients->where('u.client_id', '=', $target_client_id)
            ->orWhere('i.client_id', '=', $target_client_id);
    })
    ->whereBetween('manual_tickets.created_at', [$start_date->toDateString(), $end_date->addDays(1)->toDateString()])
    // 如果只需要最新日志的字段，且不需要预加载所有日志，可以移除 with
    // ->with('manual_ticket_log')
    ->orderBy("created_at", "DESC")
    ->get();

登录后复制

在这个例子中，DB::raw() 用于插入原生的 SQL 表达式。子查询 (SELECT MAX(id) FROM manual_ticket_logs WHERE manual_ticket_logs.manual_ticket_id = manual_tickets.id) 会为每张工单找到其对应的最新日志记录的 id，从而确保 leftJoin 只匹配到最新的那条日志。

解决 strtolower() 错误：正确使用 whereHas 与 orWhere

在复杂的条件查询中，尤其当 whereHas 与 orWhere 结合使用时，可能会遇到 strtolower() expects parameter 1 to be string, object given 的错误。这通常是因为 orWhere 期望一个闭包或简单的条件，但却接收到一个 Eloquent 查询构建器实例。

错误原因分析： 在以下代码中：

->orWhere($checkClients->whereHas('initiator', function ($checkClient2) use($target_client_id){
    $checkClient2->where('client_id', '=', $target_client_id);
}))

登录后复制

$checkClients->whereHas(...) 会立即执行并返回一个查询构建器对象。orWhere 方法试图将这个对象作为其参数进行处理，但它期待的是一个字符串（列名）或一个闭包，因此导致了 strtolower() 错误。

正确用法： 当 orWhere 内部包含复杂的条件（如另一个 whereHas）时，你需要将这些复杂条件封装在一个新的闭包中，并将其传递给 orWhere。

use Illuminate\Support\Facades\DB;

// ... 假设 $start_date, $end_date, $target_client_id 已定义

$display_tickets = ManualTicket::select('*') // 简化 select 以突出 whereHas 逻辑
    ->with('user')
    ->with('initiator')
    ->with('manual_ticket_log')
    ->where(function ($checkClients) use($target_client_id){
        $checkClients->whereHas('user', function ($checkClient) use($target_client_id){
            $checkClient->where('client_id', '=', $target_client_id);
        })
        // 关键：orWhere 内部的条件也需要封装在一个闭包中
        ->orWhere(function ($query) use($target_client_id){
            $query->whereHas('initiator', function ($checkClient2) use($target_client_id){
                $checkClient2->where('client_id', '=', $target_client_id);
            });
        });
    })
    ->whereBetween('manual_tickets.created_at', [$start_date->toDateString(), $end_date->addDays(1)->toDateString()])
    ->orderBy("created_at", "DESC")
    ->get();

登录后复制

通过将 orWhere 的复杂条件放入一个新的闭包 `$

以上就是Laravel Eloquent 高级查询：联接、关联与字段选择的最佳实践的详细内容，更多请关注php中文网其它相关文章！