마이그레이션을 사용한 Laravel의 데이터베이스 스키마 관리: 심층 튜토리얼

Laravel 마이그레이션은 데이터베이스 스키마 변경 사항을 관리하는 좋은 방법입니다. 이를 통해 데이터베이스 구조의 버전을 제어하고 시간이 지남에 따라 변경 사항을 쉽게 롤백하거나 수정할 수 있습니다. 이 가이드에서는 실습 예제와 함께 Laravel에서 마이그레이션을 생성, 실행 및 롤백하는 과정을 단계별로 살펴보겠습니다.

1단계: Laravel 환경 설정

마이그레이션을 시작하기 전에 Laravel이 설치되어 있는지 확인하세요. Composer를 통해 이 작업을 수행할 수 있습니다.

composer create-project --prefer-dist laravel/laravel migration-demo

그런 다음 프로젝트 폴더로 이동하세요.

cd migration-demo

2단계: 데이터베이스 구성

데이터베이스를 구성하려면 Laravel 프로젝트에서 .env 파일을 열고 데이터베이스 자격 증명을 업데이트하세요.

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_username
DB_PASSWORD=your_password

데이터베이스를 구성한 후, 아직 존재하지 않는 경우 로컬 환경에 새 데이터베이스를 생성할 수 있습니다.

3단계: 마이그레이션 생성

artisan 명령을 사용하여 새로운 마이그레이션을 생성할 수 있습니다. 예를 들어, 사용자 테이블 마이그레이션을 생성하려면:

php artisan make:migration create_users_table

이 명령은 데이터베이스/마이그레이션 디렉터리에 마이그레이션 파일을 생성합니다. 파일 이름에는 타임스탬프가 포함되며 2024_09_13_123456_create_users_table.php와 같은 형태입니다.

4단계: 마이그레이션 스키마 정의

생성된 마이그레이션 파일을 엽니다. up()(테이블 생성 정의) 및 down()(테이블 롤백 방법 정의)의 두 가지 메소드를 찾을 수 있습니다.

사용자 테이블 생성 예:

<?php

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

class CreateUsersTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('users', function (Blueprint $table) {
            $table->id(); // Primary key
            $table->string('name');
            $table->string('email')->unique();
            $table->timestamp('email_verified_at')->nullable();
            $table->string('password');
            $table->rememberToken();
            $table->timestamps(); // Created at & Updated at
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('users');
    }
}

up() 메소드에서는 사용자 테이블의 구조를 정의합니다. down() 메소드는 롤백(즉, 테이블 삭제) 시 테이블을 제거하는 방법을 정의합니다.

5단계: 마이그레이션 실행

마이그레이션을 실행하고 데이터베이스에 사용자 테이블을 생성하려면 다음 명령을 사용하세요.

php artisan migrate

이 명령은 아직 실행되지 않은 모든 마이그레이션을 실행합니다. 다음 출력이 표시됩니다.

Migrating: 2024_09_13_123456_create_users_table
Migrated:  2024_09_13_123456_create_users_table (0.45 seconds)

데이터베이스에 사용자 테이블이 생성되었는지 확인할 수 있습니다.

6단계: 마이그레이션 롤백

최근 마이그레이션을 롤백하려면 다음 명령을 사용하세요.

php artisan migrate:rollback

이렇게 하면 가장 최근 마이그레이션 일괄 처리에 정의된 사용자 테이블 또는 모든 테이블이 제거됩니다.

여러 마이그레이션 단계를 롤백하려면 다음을 사용하세요.

php artisan migrate:rollback --step=2

이렇게 하면 마지막 두 배치의 마이그레이션이 롤백됩니다.

7단계: 기존 테이블 수정

기존 테이블을 수정하려면(예: 열 추가) 새 마이그레이션을 생성하세요.

php artisan make:migration add_phone_to_users_table --table=users

이렇게 하면 사용자 테이블을 수정하기 위한 마이그레이션이 생성됩니다. 그런 다음 변경 사항을 정의할 수 있습니다.

public function up()
{
    Schema::table('users', function (Blueprint $table) {
        $table->string('phone')->nullable(); // Add phone column
    });
}

public function down()
{
    Schema::table('users', function (Blueprint $table) {
        $table->dropColumn('phone'); // Remove phone column
    });
}

변경 사항을 적용하려면 마이그레이션을 실행하세요.

php artisan migrate

8단계: 데이터베이스 시드

Laravel을 사용하면 더미 데이터로 데이터베이스를 시드할 수도 있습니다. 시더를 생성하려면 다음을 사용하세요.

php artisan make:seeder UsersTableSeeder

database/seeders/UsersTableSeeder.php에 있는 시더 파일에서 다음과 같이 데이터를 정의할 수 있습니다.

use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Hash;

class UsersTableSeeder extends Seeder
{
    public function run()
    {
        DB::table('users')->insert([
            'name' => 'John Doe',
            'email' => 'john@example.com',
            'password' => Hash::make('password'),
        ]);
    }
}

그런 다음 다음을 사용하여 시더를 실행합니다.

php artisan db:seed --class=UsersTableSeeder

DatabaseSeeder.php에서 시더를 호출하여 마이그레이션 중에 데이터베이스를 시드할 수도 있습니다.

9단계: 모든 마이그레이션 및 시더 실행

데이터베이스를 재설정하고 모든 마이그레이션 및 시더를 실행하려면:

php artisan migrate:fresh --seed

이 명령은 모든 테이블을 삭제하고 모든 마이그레이션을 다시 실행하며 데이터베이스를 시드합니다.

10단계: 마이그레이션 모범 사례

• 버전 관리: 항상 코드와 함께 버전 관리(Git)로 마이그레이션을 커밋하세요.
• 소규모 마이그레이션: 대규모 마이그레이션을 작은 마이그레이션으로 나누어 롤백 및 디버깅을 더 쉽게 만듭니다.
• 기존 마이그레이션 변경 방지: 프로덕션에서 이미 마이그레이션을 실행한 경우 기존 마이그레이션을 변경하는 대신 새 마이그레이션을 만들어 데이터베이스를 수정하세요.

실습 예시 요약

1. 새로운 Laravel 프로젝트를 생성하세요.
2. 데이터베이스 연결을 위한 .env 파일을 구성합니다.
3. 사용자 테이블에 대한 마이그레이션을 생성합니다.
4. up() 메소드에서 테이블 스키마를 정의합니다.
5. php artisan migration으로 마이그레이션을 실행하세요.
6. 다른 마이그레이션을 통해 전화 열을 추가하여 사용자 테이블을 수정합니다.
7. 필요에 따라 마이그레이션을 롤백하거나 다시 실행하세요.
8. 샘플 데이터로 데이터베이스를 시드합니다.
9. 마이그레이션을 사용하여 데이터베이스 상태를 효율적으로 관리하세요.

이러한 단계를 따르면 마이그레이션을 사용하여 Laravel에서 데이터베이스 스키마 변경 사항을 쉽게 관리할 수 있습니다. Laravel 마이그레이션은 개발, 스테이징, 프로덕션과 같은 다양한 환경에서 데이터베이스 구조의 버전 제어 및 동기화를 유지하는 데 필수적인 부분입니다.

위 내용은 마이그레이션을 사용한 Laravel의 데이터베이스 스키마 관리: 심층 튜토리얼의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!