Laravel Eloquent 模型关联速查表

发表于 更新于 分类于

Laravel Eloquent 模型关联速查表

一张 Laravel 的 Eloquent ORM 5.5 速查表

一对一关联

细节展示

在这个展示中，我们有 2 个模型（所有者和汽车）及两张表 （所有者和汽车）。

商业逻辑：

一个所有者可以拥有一台车。
一台车可以属于一个所有者。

关联图：

![](/images/blog/Untitled 1-20261027142052-f3twjtz.png)

关联细节：

汽车表必须储存所有者 ID。

Eloquent模型：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
class Owner
{
    public function car()
    {
       return $this->hasOne(Car::class);
    }
}
class Car
{
    public function owner()
    {
        return $this->belongsTo(Owner::class);
    }
}

数据库迁移：

1
2
3
4
5
6
7
8
9
10
Schema::create('owners', function (Blueprint $table) {
    $table->increments('id');
    $table->string('name');
});
Schema::create('cars', function (Blueprint $table) {
    $table->increments('id');
    $table->string('name');
    $table->integer('owner_id')->unsigned()->index()->nullable();
    $table->foreign('owner_id')->references('id')->on('owners');
});

储存记录

1
2
3
4
// 在 Owner 及 Car 之间建立关联
$owner->car()->save($car);
// 在 Car 及 Owner 之間建立关联
$car->owner()->associate($owner)->save();

获取记录

1
2
3
4
// 获取 Owner Car
$owner->car;
// 获取 Car Owner
$car->owner;

一对多关联

示例细节：

在此示例中，我们有两个模型：Thief（小偷）和 Car（车），和两张表：
thieves 和 cars。

业务规则：

小偷可以投走多辆车。
车只能被一个小偷偷走。

关系图：

![](/images/blog/Untitled 2-20261027142052-kwjhrnh.png)

关系细节：

车辆表应该储存小偷的 ID。

Eloquent 模型：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
class Thief
{
    public function cars()
    {
       return $this->hasMany(Car::class);
    }
}
class Car
{
    public function thief()
    {
        return $this->belongsTo(Thief::class);
    }
}

数据迁移：

1
2
3
4
5
6
7
8
9
10
Schema::create('thieves', function (Blueprint $table) {
    $table->increments('id');
    $table->string('name');
});
Schema::create('cars', function (Blueprint $table) {
    $table->increments('id');
    $table->string('name');
    $table->integer('thief_id')->unsigned()->index()->nullable();
    $table->foreign('thief_id')->references('id')->on('thieves');
});

储存记录：

1
2
3
4
5
6
7
8
9
// 创建介于小偷与车之间的关联。
$thief->cars()->saveMany([
   $car1,
   $car2,
]);
// 或者在单一模型调用 save() 方法。
$thief->cars()->save($car);
// 创建介于 Car 和 Thief 的关联。
$car->thief()->associate($thief)->save();

检索记录：

1
2
3
4
// 获取小偷所偷的车
$thief->cars;
// 获取偷盗某辆车的小偷
$car->thief;

多态一对多关系

演示细节：

在这个演示中，我们有三个模型（男，女和车），和三张表（男，女和车）。

业务规则：

一个男人（买家）可以买很多汽车。
一个女人（买家）可以买很多汽车。
这个汽车可以被一个买家购买（男人或女人）。

关系图：

![](/images/blog/Untitled 3-20261027142052-1yjyy4y.png)

Eloquent模型：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
class Man
{
    public function cars()
    {
        return $this->morphMany(Car::class, 'buyer');
    }
}
class Woman
{
    public function cars()
    {
        return $this->morphMany(Car::class, 'buyer');
    }
}
class Car
{
    public function buyer()
    {
        return $this->morphTo();
    }
}

数据库迁移：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Schema::create('men', function (Blueprint $table) {
    $table->increments('id');
    $table->string('name');
});
Schema::create('women', function (Blueprint $table) {
    $table->increments('id');
    $table->string('name');
});
Schema::create('cars', function (Blueprint $table) {
    $table->increments('id');
    $table->string('name');
    $table->integer('buyer_id')->unsigned()->index()->nullable();
    $table->string('buyer_type')->nullable();
    // 或者使用 $table->morphs(‘buyer’); 代替 "buyer_id" 和 "buyer_type"
});

储存记录：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// 在买家 （男人 / 女人） 和汽车之间建立联系。
$man->cars()->saveMany([
   $car1,
   $car2,
]);
$woman->cars()->saveMany([
   $car1,
   $car2,
]);
// 或者为单个模型使用 save() 函数。
$man->cars()->save($car);
$woman->cars()->save($car);
//创建汽车与买家之间的关系 ( 男人/女人 )。
$car1->buyer()->associate($man)->save();
$car2->buyer()->associate($woman)->save();

检索记录：

1
2
3
4
5
// 获取买家 （男人 / 女人）的汽车
$men->cars
$women->cars
// 获取这辆车的买家 （男人 / 女人）
$car->buyer

多对多关联

示例展示：

在这个示例中，我们有两个模型（司机和汽车），和三张表
（司机，汽车和名为car_driver的中间关联表）。

业务规则：

一个司机可以驾驶很多辆车。
一辆车可以被很多个司机驾驶。

关系图：

![](/images/blog/Untitled 4-20261027142052-wjfv6qm.png)

关联详情：

关联表 “car_driver” 应该保存驾驶员ID和汽车ID。

关联模型：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
class Driver
{
    public function cars()
    {
       return $this->belongsToMany(Car::class);
    }
}
class Car
{
    public function drivers()
    {
        return $this->belongsToMany(Driver::class);
    }
}

数据库迁移：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Schema::create('drivers', function (Blueprint $table) {
    $table->increments('id');
    $table->string('name');
});
Schema::create('cars', function (Blueprint $table) {
    $table->increments('id');
    $table->string('name');
});
Schema::create('car_driver', function (Blueprint $table) {
    $table->increments('id');
    $table->integer('car_id')->unsigned()->index();
    $table->foreign('car_id')->references('id')->on('cars')->onDelete('cascade');
    $table->integer('driver_id')->unsigned()->index();
    $table->foreign('driver_id')->references('id')->on('drivers')->onDelete('cascade');
});

储存记录：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
//创建Driver和Car之间的关联。
$driver->cars()->attach([
   $car1->id,
   $car2->id,
]);
//或者使用sync()函数防止重复关联。
$driver->cars()->sync([
   $car1->id,
   $car2->id,
]);
//创建Car和Driver之间的关联。
$car->drivers()->attach([
   $driver1->id,
   $driver2->id,
]);
//或者使用sync()函数防止重复关联。
$car->drivers()->sync([
   $driver1->id,
   $driver2->id,
]);

检索记录：

1
2
3
4
// Get Driver Car
$driver->cars
// Get Car Drivers
$car->drivers

多对多多态关联

展示细节：

在这个展示中我们有三个模型（代客，所有者及汽车）和4张表（代客，车主，汽车及司机）。

商业逻辑：

一个代驾（司机）可以驾驶很多车辆
一个车主（司机）可以驾驶很多
车车一台车可以被很多个司机驾驶（代驾和/或车主）

关联图：

![](/images/blog/Untitled 5-20261027142052-0r0898p.png)

关联细节：

中间表「司机」应该储存驾驶人ID，驾驶人类型及车辆ID。
驾驶是一个模型集合的代称（代客及所有者），而且不限定两个模型。驾驶人类型是模型的真正名称。

Eloquent模型：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
class Valet
{
    public function cars()
    {
        return $this->morphToMany(Car::class, 'driver');
    }
}
class Owner
{
    public function cars()
    {
        return $this->morphToMany(Car::class, 'driver');
    }
}
class Car
{
    public function valets()
    {
        return $this->morphedByMany(Valet::class, 'driver');
    }

    public function owners()
    {
        return $this->morphedByMany(Owner::class, 'driver');
    }
}

数据库迁移：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Schema::create('valets', function (Blueprint $table) {
    $table->increments('id');
    $table->string('name');
});
Schema::create('owners', function (Blueprint $table) {
    $table->increments('id');
    $table->string('name');
});
Schema::create('drivers', function (Blueprint $table) {
    $table->increments('id');
    $table->integer('driver_id')->unsigned()->index();
    $table->string('driver_type');
    // 或使用 $table->morphs(‘driver’) 來取代「driver_id」和「driver_type」
    $table->integer('car_id')->unsigned()->index();
    $table->foreign('car_id')->references('id')->on('cars')->onDelete('cascade');
});

储存记录：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// 在 driver（Valet / Owner）和 Car 間建立關聯
$valet->cars()->saveMany([$car1, $car2]);
$owner->cars()->saveMany([$car1, $car2]);
// 或使用 save() 方法來儲存單一模型
$valet->cars()->save($car1);
$owner->cars()->save($car1);
// 在 Car 和 driver（Valet / Owner）間建立關聯
$car->valets()->attach([
    $valet1->id,
    $valet2->id,
]);
$car->owners()->attach([
    $owner1->id,
    $owner2->id,
]);
// 或是用 sync() 方法來避免重複關聯
$car->valets()->sync([
    $valet1->id,
    $valet2->id,
]);
$car->owners()->sync([
    $owner1->id,
    $owner2->id,
]);

检索记录：

1
2
3
4
5
6
7
// 取得 driver（Valet / Owner）的 Cars
$valet->cars
$owner->cars

// 取得 Car 的 drivers（Valet 及 Owner）
$car->owners
$car->valets

![](/images/blog/Untitled 6-20261027142052-o6aw58v.png)

原文作者的 Twitter Mahmoud Zalt

原文地址：​https://hackernoon.com/eloquent-relationships-cheat-sheet-5155498c209

赞赏