Laravel Database Migrations: 스키마 관리 전략 🚀

안녕, 친구들! 오늘은 Laravel의 꿀팁 중 하나인 Database Migrations에 대해 재밌게 얘기해볼까? 😎 이 주제는 프로그램 개발, 특히 PHP 카테고리에서 정말 중요한 부분이야. 우리 함께 Laravel의 세계로 빠져보자구!

잠깐! 혹시 프로그래밍에 관심 있는 친구들이라면 '재능넷'이라는 사이트를 들어봤어? 여기서 다양한 개발 관련 재능을 공유하고 거래할 수 있대. Laravel 같은 고급 기술도 배울 수 있을지도?

Database Migrations이 뭐길래? 🤔

자, 먼저 Database Migrations이 뭔지부터 알아보자. Database Migrations는 데이터베이스 스키마를 버전 관리하는 Laravel의 강력한 기능이야. 쉽게 말해, 데이터베이스 구조를 코드로 관리할 수 있게 해주는 거지. 😮

예를 들어볼까? 너희가 친구들의 연락처를 관리하는 앱을 만든다고 생각해봐. 처음에는 이름과 전화번호만 저장했는데, 나중에 이메일 주소도 추가하고 싶어졌어. 이럴 때 Database Migrations를 사용하면 데이터베이스 구조를 쉽게 변경할 수 있어!

꿀팁! Database Migrations를 사용하면 팀원들과 협업할 때 데이터베이스 구조를 일관되게 유지할 수 있어. 마치 Git으로 코드를 관리하는 것처럼 말이야!

Migration 파일 만들기 📝

자, 이제 실제로 Migration 파일을 만들어볼까? Laravel에서는 아티즌 명령어를 사용해서 쉽게 Migration 파일을 생성할 수 있어.

php artisan make:migration create_contacts_table

이 명령어를 실행하면 database/migrations 폴더에 새로운 PHP 파일이 생성돼. 파일 이름은 날짜와 시간이 포함된 형식으로 자동 생성되니까 걱정하지 마!

생성된 파일을 열어보면 이런 구조로 되어 있을 거야:


use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateContactsTable extends Migration
{
    public function up()
    {
        Schema::create('contacts', function (Blueprint $table) {
            $table->id();
            $table->timestamps();
        });
    }

    public function down()
    {
        Schema::dropIfExists('contacts');
    }
}

up() 메소드는 새로운 테이블이나 컬럼을 추가할 때 사용하고, down() 메소드는 up()에서 한 작업을 되돌릴 때 사용해. 마치 Ctrl+Z 같은 거지! 😄

테이블 구조 정의하기 🏗️

이제 우리의 contacts 테이블에 필요한 컬럼들을 추가해보자. up() 메소드를 다음과 같이 수정해볼까?


public function up()
{
    Schema::create('contacts', function (Blueprint $table) {
        $table->id();
        $table->string('name');
        $table->string('phone_number');
        $table->string('email')->nullable();
        $table->timestamps();
    });
}

여기서 우리는:

id: 자동 증가하는 기본 키
name: 이름을 저장할 문자열 컬럼
phone_number: 전화번호를 저장할 문자열 컬럼
email: 이메일 주소를 저장할 문자열 컬럼 (nullable()을 사용해 선택적으로 입력 가능)
timestamps: created_at과 updated_at 컬럼을 자동으로 추가

이렇게 하면 우리의 연락처 앱에 필요한 기본적인 구조가 완성돼! 👏

참고: Laravel은 다양한 컬럼 타입을 지원해. 예를 들어, integer(), text(), boolean(), date() 등이 있어. 필요에 따라 적절한 타입을 선택하면 돼!

Migration 실행하기 ▶️

자, 이제 우리가 만든 Migration을 실행해볼 차례야. 터미널에서 다음 명령어를 입력해봐:

php artisan migrate

이 명령어를 실행하면 Laravel이 자동으로 데이터베이스에 우리가 정의한 테이블을 생성해줘. 정말 편리하지? 😎

만약 실수로 뭔가를 잘못 입력했다면, 걱정하지 마! 다음 명령어로 마지막 Migration을 되돌릴 수 있어:

php artisan migrate:rollback

이렇게 하면 마지막으로 실행한 Migration의 down() 메소드가 실행돼서 변경사항이 취소돼.

Migration 수정하기 ✏️

자, 이제 우리의 연락처 앱이 인기를 얻어서 더 많은 기능을 추가하고 싶어졌다고 생각해보자. 예를 들어, 각 연락처의 생일을 저장하고 싶어졌어. 이럴 때는 어떻게 해야 할까?

새로운 Migration 파일을 만들어서 기존 테이블을 수정할 수 있어. 다음 명령어를 사용해보자:

php artisan make:migration add_birthday_to_contacts_table --table=contacts

이렇게 하면 새로운 Migration 파일이 생성돼. 이 파일을 열어서 다음과 같이 수정해보자:


public function up()
{
    Schema::table('contacts', function (Blueprint $table) {
        $table->date('birthday')->nullable();
    });
}

public function down()
{
    Schema::table('contacts', function (Blueprint $table) {
        $table->dropColumn('birthday');
    });
}

이제 이 Migration을 실행하면 contacts 테이블에 birthday 컬럼이 추가돼! 그리고 나중에 이 변경을 취소하고 싶다면, down() 메소드가 birthday 컬럼을 삭제해줄 거야.

주의! 이미 데이터가 있는 테이블을 수정할 때는 주의해야 해. 특히 NOT NULL 제약 조건이 있는 컬럼을 추가할 때는 기존 데이터를 어떻게 처리할지 잘 생각해봐야 해.

Migration 전략 세우기 🧠

자, 이제 우리는 Migration의 기본을 알았어. 하지만 실제 프로젝트에서는 어떻게 Migration을 관리해야 할까? 여기 몇 가지 팁을 줄게:

작은 단위로 나누기: 하나의 Migration에서 너무 많은 변경을 하지 마. 작은 단위로 나누면 나중에 문제가 생겼을 때 디버깅하기 쉬워.
의미 있는 이름 짓기: Migration 파일의 이름은 그 Migration이 무엇을 하는지 명확하게 나타내야 해. 예를 들어, "add_birthday_to_contacts_table"같이 말이야.
버전 관리 시스템 활용: Migration 파일도 코드의 일부야. Git 같은 버전 관리 시스템을 사용해서 관리하는 것이 좋아.
테스트 데이터 준비: Migration을 만들 때는 항상 테스트 데이터도 함께 준비해. 이를 위해 Laravel의 Seeder를 활용할 수 있어.
롤백 계획 세우기: 항상 Migration을 되돌릴 수 있는 방법을 생각해둬. down() 메소드를 잘 활용하자.

고급 Migration 기법 🚀

자, 이제 우리는 Migration의 기본을 완전히 마스터했어! 🎉 하지만 Laravel은 여기서 멈추지 않아. 더 고급스러운 기능들도 제공하거든. 함께 살펴볼까?

1. 외래 키 제약 조건 추가하기

연락처 앱을 더 발전시켜서, 각 연락처가 특정 그룹에 속할 수 있게 만들고 싶다고 생각해보자. 이럴 때는 외래 키를 사용할 수 있어.


Schema::create('contacts', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->string('phone_number');
    $table->string('email')->nullable();
    $table->date('birthday')->nullable();
    $table->unsignedBigInteger('group_id');
    $table->foreign('group_id')->references('id')->on('groups');
    $table->timestamps();
});

여기서 group_id는 groups 테이블의 id를 참조하는 외래 키야. 이렇게 하면 데이터의 일관성을 유지할 수 있지!

2. 인덱스 추가하기

데이터베이스 성능을 향상시키기 위해 자주 검색되는 컬럼에 인덱스를 추가할 수 있어.


Schema::table('contacts', function (Blueprint $table) {
    $table->index('email');
});

이렇게 하면 email 컬럼으로 검색할 때 성능이 훨씬 좋아질 거야!

3. 유니크 제약 조건 추가하기

전화번호나 이메일 주소가 중복되지 않도록 유니크 제약 조건을 추가할 수 있어.


Schema::table('contacts', function (Blueprint $table) {
    $table->unique('email');
    $table->unique('phone_number');
});

이렇게 하면 같은 이메일이나 전화번호를 가진 연락처를 실수로 추가하는 것을 방지할 수 있어.

4. 조건부 Migration

때로는 특정 조건에 따라 Migration을 실행하고 싶을 수 있어. Laravel은 이런 경우를 위한 기능도 제공해.


if (!Schema::hasColumn('contacts', 'twitter_handle')) {
    Schema::table('contacts', function (Blueprint $table) {
        $table->string('twitter_handle')->nullable();
    });
}

이 코드는 contacts 테이블에 twitter_handle 컬럼이 없을 때만 해당 컬럼을 추가해. 이렇게 하면 같은 Migration을 여러 번 실행해도 안전해!

Migration 테스트하기 🧪

Migration을 작성하는 것만큼이나 중요한 게 바로 테스트야. Migration이 의도한 대로 동작하는지 확인하는 건 정말 중요해!

Laravel은 데이터베이스 테스트를 위한 강력한 도구를 제공해. 예를 들어, 다음과 같이 테스트 코드를 작성할 수 있어:


use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;

class ContactMigrationTest extends TestCase
{
    use RefreshDatabase;

    public function test_contacts_table_has_expected_columns()
    {
        $this->assertTrue(Schema::hasColumns('contacts', [
            'id', 'name', 'phone_number', 'email', 'birthday', 'group_id'
        ]), 1);
    }
}

이 테스트는 contacts 테이블에 우리가 예상한 모든 컬럼이 있는지 확인해. RefreshDatabase 트레이트를 사용하면 각 테스트 전에 데이터베이스를 초기화하고 모든 Migration을 다시 실행해. 이렇게 하면 항상 깨끗한 상태에서 테스트를 시작할 수 있지!

팁! 테스트를 작성할 때는 긍정적인 케이스뿐만 아니라 부정적인 케이스도 고려해야 해. 예를 들어, 유니크 제약 조건이 제대로 동작하는지 확인하는 테스트도 작성해보는 게 어때?

Migration 성능 최적화 🚀

프로젝트가 커지면 Migration 실행 시간도 길어질 수 있어. 이럴 때 사용할 수 있는 몇 가지 최적화 기법을 소개할게.

1. 배치 삽입 사용하기

대량의 데이터를 삽입할 때는 개별 삽입보다 배치 삽입을 사용하는 게 훨씬 빨라.


DB::table('contacts')->insert([
    ['name' => 'John Doe', 'phone_number' => '0'],
    ['name' => 'Jane Doe', 'phone_number' => '0987654321'],
    // ... 더 많은 데이터
]);