クエリビルダーとは何か、またそれがEloquentとどのような関係にあるのか

Question

Accepted Answer

Laravelの**クエリビルダー**は、生のSQLを書かずにデータベースクエリを構築して実行するための流暢でチェーン可能なインターフェースです。**Eloquentはクエリビルダーの上に構築されています** — Eloquentモデルは内部的にそれを使用し、Eloquentクエリはすべてのクエリビルダーメソッドを使用できます。

## クエリビルダー（DBファサード経由のデータベースレベル）

```php
use Illuminate\Support\Facades\DB;

DB::table('users')
    ->where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->limit(10)
    ->get();                          // returns generic objects (not models)

DB::table('users')->where('id', 1)->update(['name' => 'X']);
DB::table('users')->insert(['name' => 'Ann']);
```

クエリビルダーはテーブルに直接機能し（プレーンオブジェクトを返し、Eloquentモデルではありません）。チェーン可能であり、**自動的にパラメータバインディングを使用します** — SQLインジェクションを防止します。

## Eloquentは同じ流暢なメソッドを使用します

```php
// Eloquent queries support ALL Query Builder methods (it's built on top)
User::where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->get();                          // returns User MODELS (with relationships, etc.)
```

Eloquentモデルでメソッドをチェーンするとき、その内部ではクエリビルダーを使用しています — ただし、プレーンオブジェクトではなく**モデル**（リレーションシップ、アクセサー、メソッド付き）を取得します。

## 高度なクエリ（両方がサポート）

```php
DB::table('orders')
    ->join('users', 'orders.user_id', '=', 'users.id')   // joins
    ->select('orders.*', 'users.name')
    ->where('orders.total', '>', 100)
    ->groupBy('users.id')
    ->havingRaw('SUM(orders.total) > 1000')
    ->get();

User::where('role', 'admin')
    ->orWhere('role', 'editor')
    ->whereIn('status', ['active', 'pending'])
    ->get();
```

両方ともジョイン、集計、サブクエリ、および複雑な条件をサポートしています。

## どちらを使用するか

```text
Eloquent (Model::...) → the default — get models with relationships/accessors/methods.
                        Best for most application logic.
Query Builder (DB::table) → when you want lightweight queries without model overhead,
                            complex reporting/aggregations, or to avoid loading models.
```

## なぜ重要なのか

クエリビルダーとEloquentとの関係を理解することは、Laravelでデータベースを効果的に操作し、各状況に適したツールを選択するために重要です。

重要な洞察は、**EloquentがクエリビルダーT上に構築されている**ということです — したがって、Eloquentモデル（`where`、`orderBy`、`join`など）で使用する流暢でチェーン可能なメソッドはクエリビルダーのものであり、1つを学ぶことで両方を学べます。

クエリビルダーは、生のSQLを書かずにクエリを構築するためのクリーンで、SQLインジェクション安全（自動パラメータバインディング経由）な方法を提供し、Eloquentはその上にモデル機能（リレーションシップ、アクセサー、メソッド）をレイアーします。

**どちらを使用するか知る**ことが実用的なスキルです：ほとんどのアプリケーションロジックに**Eloquent**（リレーションシップと動作を持つ豊富なモデルオブジェクトを取得）を使用し、モデルオーバーヘッドなしの軽量なクエリ、複雑なレポーティング/集計、または完全なモデルが必要ない場合は直接**クエリビルダー**（`DB::table`）を使用します — これは特定のケースではより効率的です。

両方とも、同じ流暢なAPIでジョイン、集計、サブクエリなどの複雑なクエリを安全に処理します。

クエリビルダー、Eloquentがそれに基づいている方法、共有されたセーフパラメータバインディング（SQLインジェクション防止）、およびそれらの選択を理解することは、Laravelで効率的で安全なデータベースコードを書くための重要な知識です。データベースアクセスはほとんどのアプリケーションの中心であり、適切なレベル（モデル豊富なEloquent対軽量なクエリビルダー）を選択することは明確性とパフォーマンスの両方に影響するからです。