Eager Loading、Lazy Loading、Collection Methods：Laravelでネストされた関係を効率的に操作する

Laravelにおけるネストされた関係

データベース構造

ネストされた関係を定義するには、まずデータベース構造を設計する必要があります。たとえば、カテゴリとサブカテゴリを持つストアを表す場合は、次の表を持つことができます。

CREATE TABLE categories (
  id INT PRIMARY KEY AUTO_INCREMENT,
  name VARCHAR(255) NOT NULL,
  parent_id INT NULL,
  FOREIGN KEY (parent_id) REFERENCES categories(id)
);

categoriesテーブルには、id、name、およびparent_idという3つの列があります。id列はプライマリキーであり、name列はカテゴリの名前を格納します。parent_id列は、カテゴリの親カテゴリのIDを格納します。

Laravelモデル

次に、Laravelモデルを作成して、データベーステーブルを表す必要があります。

// app/Category.php

class Category extends Model
{
    public function children()
    {
        return $this->hasMany(Category::class, 'parent_id');
    }

    public function parent()
    {
        return $this->belongsTo(Category::class, 'parent_id');
    }
}

Categoryモデルには、children()メソッドとparent()メソッドという2つのメソッドがあります。children()メソッドは、現在のカテゴリの子カテゴリのすべてを返します。parent()メソッドは、現在のカテゴリの親カテゴリを返します。

ネストされた関係の取得

ネストされた関係を取得するには、Eloquentリレーションメソッドを使用できます。たとえば、すべてのカテゴリとその子カテゴリを取得するには、次のコードを使用できます。

$categories = Category::with('children')->get();

このコードは、categoriesテーブルからすべてのカテゴリを取得し、各カテゴリに関連するすべての子カテゴリを含めます。

ネストされた関係を保存するには、関連するモデルインスタンスを作成して保存する必要があります。たとえば、新しいカテゴリとその子カテゴリを作成するには、次のコードを使用できます。

$parent = new Category(['name' => 'Parent Category']);
$parent->save();

$child = new Category(['name' => 'Child Category', 'parent_id' => $parent->id]);
$child->save();

このコードは、Parent Categoryという名前の新しいカテゴリを作成し、categoriesテーブルに保存します。次に、Child Categoryという名前の新しい子カテゴリを作成し、parent_idをParent CategoryのIDに設定して、categoriesテーブルに保存します。

$category = Category::find(1);
$category->delete();

このコードは、IDが1のカテゴリとその子カテゴリをすべて削除します。

CREATE TABLE users (
  id INT PRIMARY KEY AUTO_INCREMENT,
  name VARCHAR(255) NOT NULL,
  email VARCHAR(255) UNIQUE NOT NULL,
  password VARCHAR(255) NOT NULL
);

CREATE TABLE posts (
  id INT PRIMARY KEY AUTO_INCREMENT,
  title VARCHAR(255) NOT NULL,
  body TEXT NOT NULL,
  user_id INT NOT NULL,
  FOREIGN KEY (user_id) REFERENCES users(id)
);

CREATE TABLE comments (
  id INT PRIMARY KEY AUTO_INCREMENT,
  body TEXT NOT NULL,
  post_id INT NOT NULL,
  user_id INT NOT NULL,
  FOREIGN KEY (post_id) REFERENCES posts(id),
  FOREIGN KEY (user_id) REFERENCES users(id)
);

// app/User.php

class User extends Model
{
    public function posts()
    {
        return $this->hasMany(Post::class);
    }
}

// app/Post.php

class Post extends Model
{
    public function user()
    {
        return $this->belongsTo(User::class);
    }

    public function comments()
    {
        return $this->hasMany(Comment::class);
    }
}

// app/Comment.php

class Comment extends Model
{
    public function user()
    {
        return $this->belongsTo(User::class);
    }

    public function post()
    {
        return $this->belongsTo(Post::class);
    }
}

// ユーザーとその投稿、投稿のコメントを取得

$user = User::with('posts.comments')->find(1);

// ユーザーの名前を表示
echo $user->name;

// ユーザーの投稿をすべてループ処理
foreach ($user->posts as $post) {
    // 投稿のタイトルを表示
    echo $post->title;

    // 投稿のコメントをすべてループ処理
    foreach ($post->comments as $comment) {
        // コメントの本文を表示
        echo $comment->body;
    }
}

このコードは、IDが1のユーザーとその投稿、投稿のコメントをすべて取得します。

// 新しいユーザー、投稿、コメントを作成

$user = new User(['name' => 'John Doe', 'email' => '[email protected]', 'password' => 'password']);
$user->save();

$post = new Post(['title' => 'My First Post', 'body' => 'This is my first post.', 'user_id' => $user->id]);
$post->save();

$comment = new Comment(['body' => 'This is a comment.', 'post_id' => $post->id, 'user_id' => $user->id]);
$comment->save();

このコードは、John Doeという名前の新しいユーザー、My First Postというタイトルの新しい投稿、This is a comment.という本文の新しいコメントを作成します。

// ユーザーとその投稿、投稿のコメントをすべて削除

$user = User::find(1);
$user->delete();

eager loading

Eager loadingは、関連するモデルを一度にすべてロードするテクニックです。これにより、データベースクエリ数を削減し、パフォーマンスを向上させることができます。

// ユーザーとその投稿、投稿のコメントをeager load

$users = User::with(['posts', 'posts.comments'])->get();

lazy loading

Lazy loadingは、関連するモデルが実際にアクセスされるまでロードされないテクニックです。これは、パフォーマンスを向上させるのに役立ちますが、N+1クエリ問題につながる可能性があります。

// ユーザーを取得

$user = User::find(1);

// ユーザーの投稿を取得

$posts = $user->posts;

// 投稿のコメントをすべてループ処理

foreach ($posts as $post) {
    // 投稿のコメントを取得

    $comments = $post->comments;

    // コメントの本文を表示

    foreach ($comments as $comment) {
        echo $comment->body;
    }
}

collection methods

Eloquentコレクションには、さまざまなメソッドが用意されており、ネストされた関係を操作するのに役立ちます。たとえば、pluck()メソッドを使用して、コレクション内のモデルから特定のプロパティを抽出できます。

// ユーザーのすべての投稿のタイトルを取得

$titles = $user->posts->pluck('title');

custom methods

カスタムメソッドを作成して、ネストされた関係を操作することもできます。これにより、アプリケーションの特定のニーズに合わせて関係を操作する方法をより細かく制御できます。

// ユーザーのすべての投稿のコメントを取得

public function getAllComments()
{
    return $this->posts->map(function ($post) {
        return $post->comments;
    })->collapse();
}

このメソッドは、posts関係に関連するすべてのコメントを単一のEloquentコレクションに返します。