Eloquent ベストプラクティス

クエリの最適化

常にリレーションシップを Eager Load する

// ❌ N+1 クエリ問題
$posts = Post::all();
foreach ($posts as $post) {
    echo $post->user->name; // N個の追加クエリ
}

// ✅ Eager Loading
$posts = Post::with('user')->get();
foreach ($posts as $post) {
    echo $post->user->name; // 追加クエリなし
}

必要なカラムのみを選択する

// ❌ すべてのカラムを取得
$users = User::all();

// ✅ 必要なカラムのみ
$users = User::select(['id', 'name', 'email'])->get();

// ✅ リレーションシップ付き
$posts = Post::with(['user:id,name'])->select(['id', 'title', 'user_id'])->get();

クエリスコープを使用する

// ✅ 再利用可能なクエリロジックを定義
class Post extends Model
{
    public function scopePublished($query)
    {
        return $query->where('status', 'published')
                    ->whereNotNull('published_at');
    }
    
    public function scopePopular($query, $threshold = 100)
    {
        return $query->where('views', '>', $threshold);
    }
}

// 使用方法
$posts = Post::published()->popular()->get();

リレーションシップのベストプラクティス

戻り値の型を定義する

use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;

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

withCount でカウントを使用する

// ❌ 追加のクエリを実行
foreach ($posts as $post) {
    echo $post->comments()->count();
}

// ✅ 効率的にカウントを読み込む
$posts = Post::withCount('comments')->get();
foreach ($posts as $post) {
    echo $post->comments_count;
}

一括割り当て保護

class Post extends Model
{
    // ✅ 許可されたアトリビュートをホワイトリスト化
    protected $fillable = ['title', 'content', 'status'];
    
    // または保護されたアトリビュートをブラックリスト化
    protected $guarded = ['id', 'user_id'];
    
    // ❌ 絶対にこのようなことをしないこと
    // protected $guarded = [];
}

型安全性のためにキャストを使用する

class Post extends Model
{
    protected $casts = [
        'published_at' => 'datetime',
        'metadata' => 'array',
        'is_featured' => 'boolean',
        'views' => 'integer',
    ];
}

大規模データセットのためのチャンキング

// ✅ チャンク単位で処理してメモリを節約
Post::chunk(200, function ($posts) {
    foreach ($posts as $post) {
        // 各投稿を処理
    }
});

// ✅ またはレイジーコレクションを使用
Post::lazy()->each(function ($post) {
    // 一度に1つずつ処理
});

データベースレベルの操作

// ❌ 遅い - 最初にメモリに読み込む
$posts = Post::where('status', 'draft')->get();
foreach ($posts as $post) {
    $post->update(['status' => 'archived']);
}

// ✅ 高速 - 単一のクエリ
Post::where('status', 'draft')->update(['status' => 'archived']);

// ✅ インクリメント/デクリメント
Post::where('id', $id)->increment('views');

モデルイベントを賢く使用する

class Post extends Model
{
    protected static function booted()
    {
        static::creating(function ($post) {
            $post->slug = Str::slug($post->title);
        });
        
        static::deleting(function ($post) {
            $post->comments()->delete();
        });
    }
}

回避すべき一般的な落とし穴

ループ内でクエリしない

// ❌ 悪い
foreach ($userIds as $id) {
    $user = User::find($id);
}

// ✅ 良い
$users = User::whereIn('id', $userIds)->get();

インデックスを忘れない

// マイグレーション
Schema::create('posts', function (Blueprint $table) {
    $table->id();
    $table->foreignId('user_id')->constrained()->index();
    $table->string('slug')->unique();
    $table->string('status')->index();
    $table->timestamp('published_at')->nullable()->index();
    
    // 一般的なクエリ用の複合インデックス
    $table->index(['status', 'published_at']);
});

開発環境で遅延読み込みを防ぐ

// AppServiceProvider の boot メソッド内
Model::preventLazyLoading(!app()->isProduction());

チェックリスト

• リレーションシップが必要なところで Eager Load されている
• 必要なカラムのみを選択している
• 再利用性のためにクエリスコープを使用している
• 一括割り当て保護が設定されている
• 適切なキャストが定義されている
• 外部キーとクエリカラムにインデックスがある
• 可能な限りデータベースレベルの操作を使用している
• 大規模データセットをチャンキングしている
• モデルイベントが適切に使用されている
• 開発環境で遅延読み込みが防止されている