마이그레이션과 시더는 어떻게 동작하나요?

Question

Accepted Answer

**마이그레이션(Migration)**은 PHP로 작성된, 버전 관리되는 데이터베이스 스키마 정의(테이블 생성/수정)로, 스키마 변경이 코드와 함께 추적되고 여러 환경에서 재현 가능합니다. **시더(Seeder)**는 테스트용 또는 기본 데이터로 데이터베이스를 채웁니다.

## 마이그레이션

```php
<?php
// 생성: php artisan make:migration create_users_table
return new class extends Migration {
    public function up(): void {        // 변경 적용
        Schema::create('users', function (Blueprint $table) {
            $table->id();                          // 자동 증가 기본 키
            $table->string('name');
            $table->string('email')->unique();
            $table->timestamps();                   // created_at + updated_at
        });
    }
    public function down(): void {       // 변경 되돌리기 (롤백)
        Schema::dropIfExists('users');
    }
};
```

마이그레이션의 `up()`은 (`Schema` 빌더를 사용하여) 스키마 변경을 정의하고, `down()`은 그것을 되돌립니다. 스키마를 SQL이 아닌 PHP로 작성하며 — 데이터베이스에 독립적입니다.

## 마이그레이션 실행

```bash
php artisan migrate              # 보류 중인 모든 마이그레이션 적용
php artisan migrate:rollback     # 마지막 배치 취소 (down() 사용)
php artisan migrate:fresh         # 모두 삭제하고 전체 재실행 (개발용)
php artisan make:migration add_phone_to_users   # 테이블 변경을 위한 새 마이그레이션
```

마이그레이션은 **버전 관리에 커밋**되므로, 모든 개발자, CI, 운영 환경이 `migrate`를 실행하여 동일한 스키마에 도달합니다 — 재현 가능하고 팀 친화적입니다.

## 시더 — 데이터 채우기

```php
class DatabaseSeeder extends Seeder {
    public function run(): void {
        User::factory()->count(50)->create();        // 팩토리를 통해 50명의 가짜 사용자
        User::create(['name' => 'Admin', 'email' => 'admin@x.com']);
    }
}
// 실행: php artisan db:seed
```

시더는 데이터베이스를 기본 또는 테스트 데이터로 채웁니다. **팩토리(factory)**(현실적인 가짜 데이터 생성)와 짝을 이루며 — 개발과 테스트에 매우 유용합니다.

## 왜 중요한가

마이그레이션과 시더는 전문적이고 팀 친화적인 방식으로 Laravel의 데이터베이스 계층을 다루는 데 필수적입니다. **마이그레이션**은 데이터베이스 스키마를 코드와 동기화하는 핵심 문제를 해결합니다: 스키마 변경을 버전 관리되는 PHP 파일로 정의함으로써, 스키마 진화를 **재현 가능**(모든 환경 — 각 개발자의 머신, CI, 운영 — 이 `migrate`를 실행하여 동일한 스키마에 도달)하고, **추적 가능**(변경이 코드와 함께 풀 리퀘스트에서 검토됨)하며, **안전**(수동 SQL이 아닌 PHP로 스키마를 작성하고, 되돌릴 수 있는 `down()` 메서드 포함)하게 만듭니다.

이는 스키마 드리프트와 일관되지 않은 환경 — 흔한 버그의 원인 — 을 제거합니다. **시더**(현실적인 가짜 데이터를 생성하는 팩토리와 함께)는 개발과 테스트를 위해 데이터베이스를 채워, 현실적인 데이터로 작업하고 테스트 시나리오를 설정하기 쉽게 합니다.

마이그레이션 워크플로(`make:migration`, `migrate`, `rollback`)를 이해하고, 마이그레이션이 재현성을 위해 버전 관리에 커밋된다는 점, 그리고 시더/팩토리가 데이터를 채우는 방법을 아는 것은 모든 실제 Laravel 프로젝트의 근본적이고 일상적인 지식입니다 — 팀이 데이터베이스 스키마를 협업적이고 안정적으로 발전시키고 개발 및 테스트용 데이터를 설정하는 방법이므로, 전문적인 Laravel 개발의 핵심 내용입니다.