PHP로 데이터베이스 마이그레이션 관리하기

목차
1. 데이터베이스 마이그레이션이란 무엇인가?
   - 마이그레이션의 개념
   - 데이터베이스 마이그레이션의 중요성
2. Phinx: PHP 데이터베이스 마이그레이션 도구
   - Phinx 설치 및 설정
   - 기본 마이그레이션 작업
3. 데이터베이스 스키마 버전 관리
   - 마이그레이션 파일 생성 및 실행
   - 롤백 및 버전 관리
4. 코드 예제
5. 결론 및 추가 학습 자료

---

1. 데이터베이스 마이그레이션이란 무엇인가?

마이그레이션의 개념

데이터베이스 마이그레이션(Database Migration)은 데이터베이스의 스키마나 데이터 구조를 변경하는 과정입니다. 이는 테이블을 추가하거나 수정하고, 데이터 타입을 변경하거나, 기존 데이터를 새로운 구조에 맞게 변환하는 작업을 포함합니다. 마이그레이션은 소프트웨어 개발 과정에서 데이터베이스의 일관성을 유지하고, 변경 사항을 추적하며, 손쉽게 롤백할 수 있도록 돕습니다.

데이터베이스 마이그레이션의 중요성

- 변경 관리: 데이터베이스 구조 변경을 체계적으로 관리할 수 있어, 개발 단계에서 발생할 수 있는 오류를 줄일 수 있습니다.
- 버전 관리: 코드와 마찬가지로 데이터베이스 스키마도 버전 관리가 가능하여, 다양한 환경에서 일관된 상태를 유지할 수 있습니다.
- 협업: 팀 개발 환경에서 데이터베이스 변경 사항을 쉽게 공유하고 적용할 수 있습니다.
- 롤백 지원: 잘못된 변경 사항을 쉽게 되돌릴 수 있어, 안정성을 높입니다.

---

2. Phinx: PHP 데이터베이스 마이그레이션 도구

Phinx 설치 및 설정

Phinx는 PHP에서 데이터베이스 마이그레이션을 관리할 수 있는 도구로, 간편하게 데이터베이스 스키마를 생성, 변경, 삭제할 수 있습니다. Phinx는 Composer를 통해 설치할 수 있습니다:

composer require robmorgan/phinx

설치가 완료되면 Phinx 설정 파일을 생성합니다:

vendor/bin/phinx init

이 명령어를 실행하면 프로젝트 루트에 'phinx.php'라는 기본 설정 파일이 생성됩니다. 이 파일을 열어 데이터베이스 연결 설정을 지정합니다:

return [
    'paths' => [
        'migrations' => '%%PHINX_CONFIG_DIR%%/db/migrations',
        'seeds' => '%%PHINX_CONFIG_DIR%%/db/seeds'
    ],
    'environments' => [
        'default_migration_table' => 'phinxlog',
        'default_environment' => 'development',
        'development' => [
            'adapter' => 'mysql',
            'host' => 'localhost',
            'name' => 'your_database_name',
            'user' => 'your_username',
            'pass' => 'your_password',
            'port' => '3306',
            'charset' => 'utf8mb4',
        ],
    ],
];

이 설정 파일에서 'migrations' 경로와 데이터베이스 연결 정보(호스트, 사용자, 비밀번호 등)를 설정합니다.

기본 마이그레이션 작업

Phinx를 사용하여 기본 마이그레이션 작업을 수행할 수 있습니다. 예를 들어, 새로운 테이블을 생성하는 마이그레이션을 작성하려면 다음 명령어를 사용합니다:

vendor/bin/phinx create CreateUsersTable

이 명령어를 실행하면 'db/migrations' 디렉토리에 새로운 마이그레이션 파일이 생성됩니다. 이 파일에서 테이블 생성 코드를 작성합니다:

<?php

use Phinx\Migration\AbstractMigration;

class CreateUsersTable extends AbstractMigration
{
    public function change()
    {
        $table = $this->table('users');
        $table->addColumn('name', 'string', ['limit' => 100])
              ->addColumn('email', 'string', ['limit' => 100])
              ->addColumn('password', 'string', ['limit' => 255])
              ->addColumn('created_at', 'timestamp', ['default' => 'CURRENT_TIMESTAMP'])
              ->create();
    }
}

이 마이그레이션 파일은 'users' 테이블을 생성하고, 'name', 'email', 'password', 'created_at' 열을 추가합니다.

---

3. 데이터베이스 스키마 버전 관리

마이그레이션 파일 생성 및 실행

마이그레이션 파일을 생성한 후, 다음 명령어를 사용하여 마이그레이션을 실행합니다:

vendor/bin/phinx migrate

이 명령어는 모든 마이그레이션 파일을 실행하고, 데이터베이스를 업데이트합니다. 마이그레이션이 성공적으로 완료되면, 'phinxlog' 테이블에 이력이 기록되어 나중에 롤백하거나 재실행할 수 있습니다.

롤백 및 버전 관리

잘못된 마이그레이션을 롤백하려면 다음 명령어를 사용합니다:

vendor/bin/phinx rollback

이 명령어는 가장 최근의 마이그레이션을 롤백합니다. 특정 버전으로 롤백하려면 '--target' 옵션을 사용할 수 있습니다:

vendor/bin/phinx rollback --target=0

이 명령어는 모든 마이그레이션을 롤백하여 데이터베이스를 초기 상태로 되돌립니다.

---

4. 코드 예제

다음은 Phinx를 사용하여 데이터베이스 마이그레이션을 관리하는 종합적인 예제입니다.

1. Phinx 설정 파일 (phinx.php):

return [
    'paths' => [
        'migrations' => '%%PHINX_CONFIG_DIR%%/db/migrations',
        'seeds' => '%%PHINX_CONFIG_DIR%%/db/seeds'
    ],
    'environments' => [
        'default_migration_table' => 'phinxlog',
        'default_environment' => 'development',
        'development' => [
            'adapter' => 'mysql',
            'host' => 'localhost',
            'name' => 'your_database_name',
            'user' => 'your_username',
            'pass' => 'your_password',
            'port' => '3306',
            'charset' => 'utf8mb4',
        ],
    ],
];

2. 마이그레이션 파일 생성 (CreateUsersTable.php):

<?php

use Phinx\Migration\AbstractMigration;

class CreateUsersTable extends AbstractMigration
{
    public function change()
    {
        $table = $this->table('users');
        $table->addColumn('name', 'string', ['limit' => 100])
              ->addColumn('email', 'string', ['limit' => 100])
              ->addColumn('password', 'string', ['limit' => 255])
              ->addColumn('created_at', 'timestamp', ['default' => 'CURRENT_TIMESTAMP'])
              ->create();
    }
}

3. 마이그레이션 실행:

vendor/bin/phinx migrate

4. 마이그레이션 롤백:

vendor/bin/phinx rollback --target=0

코드 분석:
- 첫 번째 파일은 Phinx 설정 파일로, 데이터베이스 연결 정보와 마이그레이션 경로를 지정합니다.
- 두 번째 파일은 'users' 테이블을 생성하는 마이그레이션 파일입니다.
- 세 번째 명령어는 마이그레이션을 실행하여 데이터베이스를 업데이트하고, 네 번째 명령어는 모든 마이그레이션을 롤백하여 초기 상태로 되돌립니다.

---

5. 결론 및 추가 학습 자료

이번 글에서는 PHP로 데이터베이스 마이그레이션을 관리하는 방법에 대해 알아보았습니다. Phinx와 같은 도구를 사용하면 데이터베이스 스키마 변경을 체계적으로 관리하고, 데이터베이스 구조의 일관성을 유지할 수 있습니다. 마이그레이션 도구는 협업 환경에서 특히 유용하며, 롤백 기능을 통해 데이터베이스 변경에 대한 안전성을 확보할 수 있습니다.

추가 학습 자료:
- [Phinx 공식 문서](https://phinx.org/) Phinx의 설치, 사용법, 고급 기능 등을 다룬 공식 문서입니다.
- [Database Migrations Explained](https://laravel.com/docs/8.x/migrations) 데이터베이스 마이그레이션의 개념과 모범 사례를 설명하는 자료입니다.
- [PHP와 MySQL로 데이터베이스 마이그레이션 관리](https://www.sitepoint.com/migrate-from-the-mysql-extension-to-pdo/) PHP와 MySQL을 사용한 데이터베이스 마이그레이션 관리에 대한 튜토리얼입니다.

---

이제 PHP를 사용하여 데이터베이스 마이그레이션을 효율적으로 관리하고, 프로젝트의 데이터베이스 구조를 체계적으로 유지할 수 있습니다. 실습을 통해 다양한 마이그레이션 시나리오를 경험하고, 프로젝트에 적용해보세요!