理解 Laravel 数据库迁移
laravel 的数据库迁移（migrations）提供了一种版本控制系统，用于管理数据库模式。它允许团队协作修改数据库结构，并确保所有开发者都拥有最新的数据库定义。核心思想是将数据库的每一次结构变化都视为一个“迁移”文件，通过运行这些文件来更新数据库。
默认情况下，php artisan migrate 命令会执行所有尚未运行的迁移文件。对于添加新表或修改现有表结构的操作，只要迁移文件编写得当，该命令并不会导致现有数据的丢失。
安全地添加新表：Schema::create() 的应用
当需要向数据库中添加全新的表时，应使用 Schema::create() 方法。这个方法专门用于创建新表，它不会影响数据库中已有的任何表或数据。
1. 创建新迁移文件
首先，使用 Artisan 命令生成一个新的迁移文件。例如，要创建一个名为 products 的新表：
php artisan make:migration create_products_table --create=products
这会在 database/migrations 目录下生成一个类似 YYYY_MM_DD_HHMMSS_create_products_table.php 的文件。
2. 编写 up() 和 down() 方法
在新生成的迁移文件中，up() 方法定义了当迁移被执行时要进行的数据库操作（例如创建表），而 down() 方法定义了当迁移被回滚时要进行的反向操作（例如删除表）。
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
class CreateProductsTable extends Migration
{
/**
* 运行数据库迁移。
*
* @return void
*/
public function up()
{
Schema::create('products', function (Blueprint $table) {
$table->id(); // 主键ID
$table->string('name'); // 产品名称
$table->text('description')->nullable(); // 产品描述，可为空
$table->decimal('price', 8, 2); // 产品价格，总共8位，小数点后2位
$table->timestamps(); // created_at 和 updated_at
});
}
/**
* 回滚数据库迁移。
*
* @return void
*/
public function down()
{
Schema::dropIfExists('products'); // 如果表存在则删除
}
}在上述示例中，Schema::create('products', ...) 会创建 products 表。由于这是一个全新的表，它不会触及任何现有数据。
3. 执行迁移
完成迁移文件编写后，运行以下命令来应用它：
php artisan migrate
此命令会识别所有尚未执行的迁移文件（包括 create_products_table），并按顺序执行它们的 up() 方法。已存在的表和数据将保持不变。
修改现有表：Schema::table() 的使用
当需要修改一个已存在的表（例如添加新列、修改列类型、添加索引等）时，应使用 Schema::table() 方法。与 Schema::create() 类似，Schema::table() 也不会导致现有数据的丢失，因为它只针对表结构进行修改。
1. 创建新迁移文件
php artisan make:migration add_category_id_to_products_table --table=products
2. 编写 up() 和 down() 方法
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
class AddCategoryIdToProductsTable extends Migration
{
/**
* 运行数据库迁移。
*
* @return void
*/
public function up()
{
Schema::table('products', function (Blueprint $table) {
// 添加 category_id 列，并设置为外键
$table->unsignedBigInteger('category_id')->nullable()->after('name');
$table->foreign('category_id')->references('id')->on('categories')->onDelete('set null');
});
}
/**
* 回滚数据库迁移。
*
* @return void
*/
public function down()
{
Schema::table('products', function (Blueprint $table) {
// 回滚时删除外键和列
$table->dropForeign(['category_id']);
$table->dropColumn('category_id');
});
}
}3. 执行迁移
php artisan migrate
其他 Schema 操作及其数据影响
Laravel 的 Schema 门面提供了多种数据库操作方法，了解它们对数据的影响至关重要：
- Schema::rename('old_table', 'new_table'): 重命名数据库表。此操作不会影响表中的现有数据。
- Schema::drop('table_name'): 删除指定的数据库表。此操作会导致该表中的所有数据永久丢失。
- Schema::dropIfExists('table_name'): 如果表存在则删除。与 Schema::drop() 相同，会导致数据丢失。
在使用 Schema::drop() 或 Schema::dropIfExists() 时务必谨慎，尤其是在生产环境中。
管理迁移状态：php artisan migrate:status
为了查看当前所有迁移文件的执行状态，可以使用 migrate:status 命令：
php artisan migrate:status
该命令会列出所有迁移文件，并指示它们是否已被执行（Ran? Yes/No）以及所属的批次（Batch）。这对于调试和理解数据库当前状态非常有用。
+------+-------------------------------------------------------+-------+ | Ran? | Migration | Batch | +------+-------------------------------------------------------+-------+ | Yes | 2014_10_12_000000_create_users_table | 1 | | Yes | 2014_10_12_100000_create_password_resets_table | 1 | | Yes | 2023_01_01_000000_create_products_table | 2 | | Yes | 2023_01_02_000000_add_category_id_to_products_table | 2 | +------+-------------------------------------------------------+-------+
谨慎使用：可能导致数据丢失的迁移命令
虽然 php artisan migrate 在添加新表或修改表结构时通常是安全的，但 Artisan 迁移命令族中存在一些命令，它们的设计目的就是重置或刷新数据库，因此会导致数据丢失。在生产环境或包含重要数据的开发环境中，使用这些命令时必须格外小心。
- php artisan migrate:fresh: 删除所有表，然后重新运行所有迁移。此命令会彻底清空数据库，所有数据都将丢失。
- php artisan migrate:refresh: 回滚所有迁移，然后重新运行所有迁移。这相当于 migrate:reset 后跟 migrate。此命令同样会导致所有数据丢失。
- php artisan migrate:reset: 回滚所有迁移。它会执行所有迁移文件的 down() 方法。如果 down() 方法中包含 Schema::drop()，则数据会丢失。
- php artisan migrate:rollback: 回滚最近一次执行的迁移批次。它会执行最近一批迁移文件的 down() 方法。同样，如果 down() 方法中包含 Schema::drop()，则数据会丢失。
重要提示： 在执行任何可能导致数据丢失的命令之前，务必备份您的数据库。
总结与最佳实践
在 Laravel 中安全地管理数据库结构变更，同时保护现有数据，关键在于理解不同 Schema 方法和 Artisan 迁移命令的作用：
- 添加新表或列：始终使用 Schema::create() 来创建新表，使用 Schema::table() 来修改现有表结构。这些操作在设计上不会丢失现有数据。
- 避免数据丢失：除非您明确需要清空数据库或回滚特定更改，否则请避免使用 php artisan migrate:fresh、php artisan migrate:refresh 和 php artisan migrate:reset。
- 回滚策略：在编写迁移文件的 down() 方法时，对于 Schema::create() 对应的操作应是 Schema::dropIfExists()，对于 Schema::table() 对应的操作应是 dropColumn() 或 dropForeign() 等反向操作。
- 版本控制：将迁移文件纳入版本控制系统（如 Git），确保团队成员之间的数据库结构一致性。
- 生产环境操作：在生产环境执行任何迁移操作前，务必进行数据库备份，并考虑在维护模式下执行，以避免对用户造成影响。
通过遵循这些原则，您可以有效地利用 Laravel 的数据库迁移系统，实现数据库结构的平滑演进，同时确保数据的完整性和安全性。
