Laravel模型通过“一对多中的一个”关系进行复杂排序的实践指南

admin 百科 2025-12-13 10

本教程将深入探讨在laravel框架中，如何优雅地对主模型（如`customer`）进行排序，其排序依据是其“一对多中的一个”关联模型（如`latestcontact`）的特定属性。我们将重点介绍如何利用laravel的子查询关联（`joinsub`）功能，通过构建高效的数据库查询来解决直接关联导致的重复数据问题，从而实现基于最新关联记录的精确排序。

在Laravel应用开发中，我们经常会遇到需要根据关联模型的属性来排序主模型的需求。一个典型的场景是，我们有一个Customer模型，它拥有多个Contact记录，并且我们希望根据每个客户的“最新联系记录”（latestContact）的时间来对客户列表进行排序。Laravel的“Has One Of Many”关系提供了一种便捷的方式来定义这种“一对多中的一个”关联，但直接利用此关系进行数据库层面的排序却并非直观。

理解“Has One Of Many”关系

首先，我们来看一下如何定义Customer和Contact模型以及它们之间的“Has One Of Many”关系。这种关系允许我们轻松获取每个客户的最新联系记录。

模型定义示例：

// app/Models/Customer.php
namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Customer extends Model
{
    use HasFactory;

    /**
     * 定义与Contact模型的一对多关系。
     */
    public function contacts()
    {
        return $this->hasMany(Contact::class);
    }

    /**
     * 定义获取最新联系记录的“Has One Of Many”关系。
     * 它将根据 'contacted_at' 字段的最大值来获取每个客户的最新联系。
     */
    public function latestContact()
    {
        return $this->hasOne(Contact::class)->ofMany('contacted_at', 'max')->withDefault();
    }
}

登录后复制

// app/Models/Contact.php
namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;

class Contact extends Model
{
    use HasFactory, SoftDeletes;

    protected $casts = [
        'contacted_at' => 'datetime',
    ];

    /**
     * 定义与Customer模型的多对一关系。
     */
    public function customer()
    {
        return $this->belongsTo(Customer::class);
    }
}

登录后复制

迁移文件（contacts表）示例：

Laravel模型通过“一对多中的一个”关系进行复杂排序的实践指南-第2张图片-佛山资讯网

// database/migrations/xxxx_xx_xx_xxxxxx_create_contacts_table.php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateContactsTable extends Migration
{
    public function up()
    {
        Schema::create('contacts', function (Blueprint $table) {
            $table->id();
            $table->timestamps();
            $table->softDeletes();

            $table->foreignId('customer_id')->constrained()->onDelete('cascade');
            $table->string('type');
            $table->dateTime('contacted_at');
        });
    }

    public function down()
    {
        Schema::dropIfExists('contacts');
    }
}

登录后复制

排序挑战：避免重复数据

当我们需要根据latestContact的contacted_at字段对Customer列表进行排序时，一个常见的尝试是使用join方法。然而，直接的join操作会导致每个客户有多条联系记录时，结果集中出现重复的客户条目，这并非我们所期望的。

// 错误的尝试：会导致客户重复
$query = Customer::select('customers.*', 'contacts.contacted_at as contacted_at')
    ->join('contacts', 'customers.id', '=', 'contacts.customer_id')
    ->orderBy('contacts.contacted_at')
    ->with('latestContact'); // 即使with了，join本身也已造成重复

登录后复制

上述查询会为每个联系记录都返回一个客户，而不是每个客户只返回一次并按其最新联系排序。