쿼리 빌더란 무엇이며 Eloquent와 어떻게 관련되나요?

Question

Accepted Answer

Laravel의 **쿼리 빌더(Query Builder)**는 원시 SQL을 작성하지 않고 데이터베이스 쿼리를 빌드하고 실행하는 유연하고 체이닝 가능한 인터페이스입니다. **Eloquent는 쿼리 빌더 위에 구축되어** 있습니다 — Eloquent 모델은 내부적으로 그것을 사용하며, Eloquent 쿼리는 모든 쿼리 빌더 메서드를 사용할 수 있습니다.

## 쿼리 빌더 (DB facade를 통한 데이터베이스 수준)

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

DB::table('users')
    ->where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->limit(10)
    ->get();                          // 일반 객체 반환 (모델 아님)

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

쿼리 빌더는 테이블과 직접 작업합니다(Eloquent 모델이 아닌 일반 객체 반환). 체이닝 가능하며 **자동으로 파라미터 바인딩을 사용**합니다 — SQL 인젝션을 방지합니다.

## Eloquent는 동일한 유연한 메서드를 사용

```php
// Eloquent 쿼리는 모든 쿼리 빌더 메서드를 지원함 (그 위에 구축되었으므로)
User::where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->get();                          // User 모델 반환 (관계 등을 가짐)
```

Eloquent 모델에서 메서드를 체이닝하면 내부적으로 쿼리 빌더를 사용하는 것이지만 — 일반 객체가 아닌 **모델**(관계, 접근자, 메서드를 가짐)을 돌려받습니다.

## 고급 쿼리 (둘 다 지원함)

```php
DB::table('orders')
    ->join('users', 'orders.user_id', '=', 'users.id')   // 조인
    ->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::...) → 기본 — 관계/접근자/메서드를 가진 모델을 얻음.
                        대부분의 애플리케이션 로직에 최적.
쿼리 빌더 (DB::table) → 모델 오버헤드 없이 가벼운 쿼리를 원할 때,
                        복잡한 리포팅/집계, 또는 모델 로딩을 피하고 싶을 때.
```

## 왜 중요한가

쿼리 빌더와 Eloquent와의 관계를 이해하는 것은 Laravel에서 데이터베이스를 효과적으로 다루고 각 상황에 맞는 도구를 선택하는 데 중요합니다.

핵심 통찰은 **Eloquent가 쿼리 빌더 위에 구축되었다**는 점입니다 — 따라서 Eloquent 모델에서 사용하는 유연하고 체이닝 가능한 메서드(`where`, `orderBy`, `join` 등)는 쿼리 빌더의 것이며, 하나를 배우면 둘 다 배우는 셈입니다.

쿼리 빌더는 원시 SQL을 작성하지 않고 쿼리를 빌드하는 깔끔하고 (자동 파라미터 바인딩을 통한) SQL 인젝션에 안전한 방법을 제공하며, Eloquent는 그 위에 모델 기능(관계, 접근자, 메서드)을 더합니다.

**언제 무엇을 사용할지** 아는 것이 실용적인 기술입니다: 대부분의 애플리케이션 로직에는 **Eloquent**(관계와 동작을 가진 풍부한 모델 객체를 얻음)를, 모델 오버헤드 없는 가벼운 쿼리, 복잡한 리포팅/집계, 또는 완전한 모델이 필요 없을 때는 **쿼리 빌더 직접 사용**(`DB::table`)을 사용합니다 — 특정 경우에는 이것이 더 효율적일 수 있습니다.

둘 다 동일한 유연한 API로 복잡한 쿼리(조인, 집계, 서브쿼리)를 안전하게 처리합니다.

쿼리 빌더, Eloquent가 그 위에 어떻게 구축되는지, 공유된 안전한 파라미터 바인딩(SQL 인젝션 방지), 그리고 둘 사이의 선택을 이해하는 것은 Laravel에서 효율적이고 안전한 데이터베이스 코드를 작성하는 데 중요한 지식입니다. 데이터베이스 접근이 대부분의 애플리케이션의 중심이고, 적절한 수준(모델이 풍부한 Eloquent 대 가벼운 쿼리 빌더)을 선택하는 것이 명확성과 성능 모두에 영향을 미치기 때문입니다.