本文旨在解决 laravel 中如何根据“has one of many”关系定义的最新关联模型对主模型进行排序的问题。通过详细分析直接联接的局限性，文章将重点介绍并演示使用子查询联接（`joinsub`）作为一种高效且优雅的解决方案，以确保准确地按最新关联数据对父模型进行排序，避免重复记录，并提供清晰的代码示例和实现步骤。
理解“Has One Of Many”关系与排序挑战
在 Laravel 应用开发中，我们经常会遇到需要从多个相关联的子模型中选择“最新”或“最旧”的那一个，并将其作为父模型的一个属性来访问。Laravel 提供的“Has One Of Many”关系正是为此而生。例如，一个 Customer（客户）模型可能拥有多个 Contact（联系记录），我们希望能够轻松获取每个客户的最新联系记录。
模型定义示例：
// app/Models/Customer.php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class Customer extends Model
{
use HasFactory;
public function contacts()
{
return $this->hasMany(Contact::class);
}
public function latestContact()
{
// 定义“Has One Of Many”关系，获取每个客户最新联系时间（contacted_at）的联系记录
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',
];
public function customer()
{
return $this->belongsTo(Customer::class);
}
}迁移文件（contacts 表）：
// database/migrations/..._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 方法并尝试 orderBy('contacts.contacted_at') 通常会导致每个客户出现多条记录，因为 join 会将所有匹配的联系记录都连接到客户上，这不是我们期望的结果。我们需要的是每个客户只对应一条最新的联系记录，并基于此进行排序。
解决方案：利用子查询联接（Subquery Joins）
Laravel 的查询构建器提供了 joinSub 方法，它允许我们将一个查询结果作为子查询，并将其联接到主查询中。这是解决上述问题的最简洁和高效的方法。
核心思路是：
- 首先，创建一个子查询来找出每个客户的最新联系时间。
- 然后，将这个子查询的结果联接到 customers 表上。
- 最后，根据联接后的最新联系时间进行排序。
具体实现步骤与代码：
use Illuminate\Support\Facades\DB;
use App\Models\Customer;
use App\Models\Contact;
// 1. 构建子查询：找出每个客户的最新联系时间
$latestContactsSubquery = Contact::select('customer_id', DB::raw('MAX(contacted_at) as latest_contact'))
->groupBy('customer_id');
// 2. 将子查询联接到 Customer 模型上，并根据最新联系时间排序
$customers = Customer::select('customers.*', 'latest_contacts.latest_contact')
->joinSub($latestContactsSubquery, 'latest_contacts', function ($join) {
$join->on('customers.id', '=', 'latest_contacts.customer_id');
})
->orderBy('latest_contacts.latest_contact', 'desc') // 降序排列，最新联系的客户在前
->get();
// $customers 现在包含了按最新联系时间排序的客户列表，每个客户都带有一个 latest_contact 字段
foreach ($customers as $customer) {
echo "客户ID: {$customer->id}, 最新联系时间: {$customer->latest_contact}\n";
// 也可以通过预加载来访问 latestContact 关系
// $customer->load('latestContact');
// echo "最新联系人类型: " . $customer->latestContact->type . "\n";
}代码解析：
-
$latestContactsSubquery = Contact::select('customer_id', DB::raw('MAX(contacted_at) as latest_contact'))->groupBy('customer_id');
- 这部分构建了一个子查询。它从 contacts 表中选择 customer_id 和每个 customer_id 对应的最大 contacted_at 值。
- DB::raw('MAX(contacted_at) as latest_contact') 用于在 SQL 中执行聚合函数 MAX()，并将其结果命名为 latest_contact。
- groupBy('customer_id') 确保了我们为每个客户只获取一个（最新的）联系时间。
-
*`Customer::select('customers.', 'latest_contacts.latest_contact')`**
- 主查询从 customers 表中选择所有列 (customers.*)，同时选择子查询结果中的 latest_contact 列。
-
->joinSub($latestContactsSubquery, 'latest_contacts', function ($join) { $join->on('customers.id', '=', 'latest_contacts.customer_id'); })
- joinSub 方法将 $latestContactsSubquery 作为子查询联接到主查询中。
- 'latest_contacts' 是给这个子查询结果起的别名，方便在 on 子句中引用。
- function ($join) { ... } 定义了联接条件，即 customers.id 必须等于子查询结果中的 customer_id。
-
->orderBy('latest_contacts.latest_contact', 'desc')
- 最后，我们根据子查询提供的 latest_contact 字段对结果进行排序。这里使用了降序 (desc)，意味着最新联系的客户会排在前面。
核心优势与注意事项
- 数据准确性： 这种方法确保每个客户只根据其唯一的最新联系时间进行排序，避免了传统 join 可能导致的重复客户记录问题。
- 代码清晰度： 使用 joinSub 使得逻辑意图非常明确，易于理解和维护。
- 性能考量： 对于大型数据集，数据库会优化子查询的执行。这种方法通常比在 PHP 中手动处理所有联系记录然后排序更高效。然而，如果 contacts 表非常庞大，确保 contacted_at 和 customer_id 字段上有适当的索引至关重要，以优化子查询的性能。
- 兼容性： joinSub 方法在 Laravel 5.6 及更高版本中可用。
总结
通过利用 Laravel 强大的查询构建器中的 joinSub 方法，我们可以优雅且高效地解决根据“Has One Of Many”关系定义的最新关联模型对父模型进行排序的问题。这种模式不仅保证了数据结果的准确性，也提升了代码的可读性和维护性，是处理此类复杂排序场景的推荐方法。在实际应用中，结合数据库索引优化，可以进一步提升查询性能。
