Laravel 遷移是管理資料庫架構變更的好方法。它們允許您對資料庫結構進行版本控制，並隨時間輕鬆回滾或修改變更。在本指南中，我們將逐步探索在 Laravel 中建立、運行和回滾遷移的過程，並提供一個實踐範例。
第 1 步：設定 Laravel 環境
開始遷移之前，請確保已安裝 Laravel。您可以透過 Composer 執行此操作：
composer create-project --prefer-dist laravel/laravel 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
登入後複製
該指令在database/migrations目錄中產生一個遷移檔。檔案名稱將包含時間戳，類似於 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() 方法中，我們定義了 users 表的結構。 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)。
-
小型遷移：將大型遷移分解為較小的遷移，以便更輕鬆地回溯和調試。
-
避免更改現有遷移：如果您已經在生產中運行遷移，請建立一個新遷移來修改資料庫，而不是更改現有遷移。
實踐範例摘要
- 建立一個新的 Laravel 專案。
- 設定資料庫連線的.env 檔案。
- 為使用者表建立遷移。
- 在 up() 方法中定義表格模式。
- 使用 php artisan migrate 運行遷移。
- 透過另一個遷移新增電話列來修改使用者表。
- 根據需要回滾或重新運行遷移。
- 使用範例資料為資料庫新增種子。
- 使用遷移有效管理資料庫狀態。
透過執行以下步驟，您可以使用遷移輕鬆管理 Laravel 中的資料庫架構變更。 Laravel 遷移是保持資料庫結構版本控制並在不同環境（如開發、登台和生產）之間同步的重要組成部分。
以上是使用遷移在 Laravel 中進行資料庫架構管理：深入教程的詳細內容。更多資訊請關注PHP中文網其他相關文章！
