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 项目的数据库结构变更。