Laravel數據庫遷移最佳實踐

Laravel 數據庫遷移是一種強大的工具，用于管理數據庫結構的變更。以下是 Laravel 數據庫遷移的最佳實踐：

1. 使用版本控制

確保你的遷移文件存儲在版本控制系統（如 Git）中。這樣可以追蹤每次數據庫結構的變化，并在需要時回滾到之前的版本。

# 初始化 Git 倉庫
git init

# 添加遷移文件到版本控制
git add database/migrations/xxxx_xx_xx_xxxxxx_create_users_table.php

2. 創建遷移文件

使用 make:migration Artisan 命令創建遷移文件。確保命名規范為 yyyy_mm_dd_xxxxxx_description.php。

php artisan make:migration create_users_table --create=users

3. 編寫遷移文件

在生成的遷移文件中，編寫 up() 和 down() 方法來定義數據庫結構的變更和回滾操作。

// database/migrations/yyyy_mm_dd_xxxxxx_create_users_table.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();
            $table->string('name');
            $table->string('email')->unique();
            $table->timestamp('email_verified_at')->nullable();
            $table->string('password');
            $table->rememberToken();
            $table->timestamps();
        });
    }

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

4. 運行遷移

使用 migrate Artisan 命令來應用數據庫遷移。

php artisan migrate

5. 回滾遷移

如果需要回滾上一次的遷移，可以使用 migrate:rollback 命令。

php artisan migrate:rollback

6. 使用數據填充

在遷移過程中，可以使用數據填充文件（Seeder）來初始化數據庫數據。

# 創建數據填充文件
php artisan make:seeder UsersTableSeeder

在生成的 Seeder 文件中，編寫 run() 方法來插入初始數據。

// database/seeds/UsersTableSeeder.php

use Illuminate\Database\Seeder;
use Illuminate\Support\Facades\DB;

class UsersTableSeeder extends Seeder
{
    /**
     * Run the database seeds.
     *
     * @return void
     */
    public function run()
    {
        DB::table('users')->insert([
            'name' => 'John Doe',
            'email' => 'john@example.com',
            'password' => bcrypt('password'),
        ]);
    }
}

然后運行數據填充命令：

php artisan db:seed --class=UsersTableSeeder

7. 使用環境變量管理數據庫配置

將敏感的數據庫配置信息存儲在 .env 文件中，并使用 Laravel 的環境變量功能來管理這些配置。

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=mydatabase
DB_USERNAME=myuser
DB_PASSWORD=mypassword

8. 測試遷移

在開發環境中進行充分的測試，確保遷移文件和數據填充文件的正確性。可以使用本地數據庫或 Docker 容器來模擬生產環境。

9. 使用 schema::dropIfExists()

在創建表時，使用 schema::dropIfExists() 方法可以避免在表已經存在時拋出錯誤。

Schema::create('users', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->string('email')->unique();
    $table->timestamp('email_verified_at')->nullable();
    $table->string('password');
    $table->rememberToken();
    $table->timestamps();
});

10. 使用 Blueprint 類

利用 Blueprint 類提供的各種方法來定義表結構，這樣可以提高代碼的可讀性和可維護性。

$table->id();
$table->string('name');
$table->string('email')->unique();
$table->timestamp('email_verified_at')->nullable();
$table->string('password');
$table->rememberToken();
$table->timestamps();

通過遵循這些最佳實踐，你可以更高效地管理 Laravel 項目的數據庫結構變更。