MongoDB Laravel 扩展中的 Eloquent 模型关系详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00735/article/details/148464846

MongoDB Laravel 扩展中的 Eloquent 模型关系详解

laravel-mongodb A MongoDB based Eloquent model and Query builder for Laravel (Moloquent) 项目地址: https://gitcode.com/gh_mirrors/la/laravel-mongodb

前言

MongoDB Laravel 扩展（mongodb/laravel-mongodb）为 Laravel 开发者提供了在 MongoDB 中使用 Eloquent ORM 的能力。与传统的关系型数据库不同，MongoDB 作为文档数据库，其数据关系处理有着独特的特点。本文将深入探讨该扩展中支持的各种模型关系类型，帮助开发者更好地在 MongoDB 环境中构建数据模型。

关系类型概述

在 MongoDB Laravel 扩展中，主要支持以下几种模型关系：

一对一关系 (One to One)
一对多关系 (One to Many)
多对多关系 (Many to Many)
嵌入式文档模式 (Embedded Document Pattern)
跨数据库关系 (Cross-Database Relationships)

一对一关系

基本概念

一对一关系表示一个模型实例仅与另一个模型的一个实例相关联。在 MongoDB 中，这种关系通常通过存储关联文档的 ID 来实现。

实现方式

在父模型中使用 hasOne() 方法，在子模型中使用 belongsTo() 方法建立反向关系。

// Planet 模型
class Planet extends Model
{
    public function orbit()
    {
        return $this->hasOne(Orbit::class);
    }
}

// Orbit 模型
class Orbit extends Model
{
    public function planet()
    {
        return $this->belongsTo(Planet::class);
    }
}

数据存储结构

// planets 集合文档
{
  "_id": ObjectId("..."),
  "name": "Earth",
  "diameter_km": 12742
}

// orbits 集合文档
{
  "_id": ObjectId("..."),
  "period": 365.26,
  "direction": "counterclockwise",
  "planet_id": "..."
}

使用示例

$planet = Planet::find('...');
$orbit = $planet->orbit; // 获取关联的轨道信息

$orbit = Orbit::find('...');
$planet = $orbit->planet; // 获取关联的行星信息

一对多关系

基本概念

一对多关系表示一个模型实例可以与多个其他模型实例相关联。这是最常见的数据库关系类型之一。

实现方式

在父模型中使用 hasMany() 方法，在子模型中使用 belongsTo() 方法建立反向关系。

// Planet 模型
class Planet extends Model
{
    public function moons()
    {
        return $this->hasMany(Moon::class);
    }
}

// Moon 模型
class Moon extends Model
{
    public function planet()
    {
        return $this->belongsTo(Planet::class);
    }
}

数据存储结构

// planets 集合文档
{
  "_id": ObjectId("..."),
  "name": "Jupiter",
  "diameter_km": 142984
}

// moons 集合文档
[
  {
    "_id": ObjectId("..."),
    "name": "Ganymede",
    "orbital_period": 7.15,
    "planet_id": "..."
  },
  {
    "_id": ObjectId("..."),
    "name": "Europa",
    "orbital_period": 3.55,
    "planet_id": "..."
  }
]

使用示例

$planet = Planet::find('...');
$moons = $planet->moons; // 获取所有卫星

$moon = Moon::find('...');
$planet = $moon->planet; // 获取所属行星

多对多关系

基本概念

多对多关系表示两个模型实例可以相互关联多个对方实例。在关系型数据库中通常需要中间表，而在 MongoDB 中则通过数组字段存储关联 ID。

实现方式

在两个模型中都使用 belongsToMany() 方法。

// Planet 模型
class Planet extends Model
{
    public function explorers()
    {
        return $this->belongsToMany(SpaceExplorer::class);
    }
}

// SpaceExplorer 模型
class SpaceExplorer extends Model
{
    public function planets()
    {
        return $this->belongsToMany(Planet::class);
    }
}

数据存储结构

// planets 集合文档
{
  "_id": ObjectId("..."),
  "name": "Earth",
  "space_explorer_ids": ["...", "..."]
}

// space_explorers 集合文档
{
  "_id": ObjectId("..."),
  "name": "Jean-Luc Picard",
  "planet_ids": ["...", "..."]
}

使用示例

$planet = Planet::find('...');
$explorers = $planet->explorers; // 获取访问过该行星的所有探险家

$explorer = SpaceExplorer::find('...');
$planets = $explorer->planets; // 获取该探险家访问过的所有行星

嵌入式文档模式

基本概念

嵌入式文档是 MongoDB 特有的数据建模方式，它将相关数据直接嵌套存储在父文档中，而不是通过引用关联。这种方式适合需要频繁一起查询的数据。

实现方式

使用 embedsOne() 或 embedsMany() 方法。

// SpaceShip 模型
class SpaceShip extends Model
{
    public function cargo()
    {
        return $this->embedsMany(Cargo::class);
    }
}

// Cargo 模型
class Cargo extends Model
{
    // 不需要定义反向关系
}

数据存储结构

{
  "_id": ObjectId("..."),
  "name": "The Millenium Falcon",
  "cargo": [
    {
      "name": "spice",
      "weight": 50,
      "_id": ObjectId("...")
    },
    {
      "name": "hyperdrive",
      "weight": 25,
      "_id": ObjectId("...")
    }
  ]
}

使用示例

$ship = SpaceShip::find('...');
$cargoItems = $ship->cargo; // 获取所有货物

// 添加新货物
$ship->cargo()->save(new Cargo(['name' => 'droid', 'weight' => 10]));

跨数据库关系

基本概念

跨数据库关系允许 MongoDB 文档与关系型数据库中的表建立关联，这在混合使用两种数据库的系统中非常有用。

实现方式

在关系型数据库模型中使用 HybridRelations trait，并正常定义关系方法。

// SpaceShip 模型（存储在MySQL）
use MongoDB\Laravel\Eloquent\HybridRelations;

class SpaceShip extends Model
{
    use HybridRelations;
    
    public function passengers()
    {
        return $this->hasMany(Passenger::class);
    }
}

// Passenger 模型（存储在MongoDB）
class Passenger extends Model
{
    public function spaceShip()
    {
        return $this->belongsTo(SpaceShip::class);
    }
}

数据存储结构

-- MySQL 中的 space_ships 表
+------+----------+
| id   | name     |
+------+----------+
| 1234 | Nostromo |
+------+----------+

// MongoDB 中的 passengers 集合
[
  {
    "_id": ObjectId("..."),
    "name": "Ellen Ripley",
    "space_ship_id": 1234
  }
]

使用示例

$ship = SpaceShip::find(1234);
$passengers = $ship->passengers; // 获取所有乘客

$passenger = Passenger::find('...');
$ship = $passenger->spaceShip; // 获取所属飞船