Laravel中如何通过外键获取关联表数据并实现客户名搜索

你的问题核心在于：当前代码仅通过with('customer')预加载了客户数据，但搜索条件只针对订单表的customer_id和orderNumber字段，并未对关联客户表的姓名字段做查询匹配。下面提供两种可行的解决方法：

方法一：使用Eloquent关联查询whereHas（推荐） #

利用whereHas可以针对关联模型的字段添加搜索条件，同时保持Order模型的结构不变：

public function render()
{
    $search = $this->searchTerm;
    $data = Order::with('customer')
        ->where('user_id', Auth::id())
        ->where(function ($query) use ($search) {
            $query->where('orderNumber', 'like', '%' . $search . '%')
                ->orWhere('customer_id', 'like', '%' . $search . '%')
                // 添加客户姓名的搜索条件
                ->orWhereHas('customer', function ($customerQuery) use ($search) {
                    $customerQuery->where('name', 'like', '%' . $search . '%');
                });
        })
        ->orderBy('id', $this->sortDirection)
        ->paginate(9);

    return view('livewire.dashboard.orders.list-order', compact('data'));
}

注意：确保你的Order模型中已经正确定义了customer关联：

// app/Models/Order.php
public function customer()
{
    return $this->belongsTo(Customer::class);
}

方法二：使用表连接join #

直接通过SQL连接订单表和客户表，然后对客户表的姓名字段进行搜索：

public function render()
{
    $search = $this->searchTerm;
    $data = Order::with('customer')
        ->join('customers', 'orders.customer_id', '=', 'customers.id')
        ->where('orders.user_id', Auth::id())
        ->select('orders.*') // 只选择订单表字段，避免字段冲突
        ->where(function ($query) use ($search) {
            $query->where('orders.orderNumber', 'like', '%' . $search . '%')
                ->orWhere('orders.customer_id', 'like', '%' . $search . '%')
                ->orWhere('customers.name', 'like', '%' . $search . '%');
        })
        ->orderBy('orders.id', $this->sortDirection)
        ->paginate(9);

    return view('livewire.dashboard.orders.list-order', compact('data'));
}

两种方法的区别 #

• whereHas：更符合Eloquent的关联设计，不会改变返回的Order模型结构，适合只需要检查关联模型条件的场景。
• join：直接操作SQL表连接，性能上和whereHas相近，但如果需要同时获取客户表的多个字段，这种方式更直接，不过要注意字段名冲突（比如两个表都有id字段时，必须指定表前缀）。

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