Laravel数据库迁移核心概念
在laravel应用开发中，数据库迁移（migrations）提供了一种版本控制机制，允许团队轻松地修改和共享应用的数据库结构。它避免了手动维护sql脚本的繁琐，并确保了开发、测试和生产环境之间数据库结构的一致性。当需要向数据库中添加新表或修改现有表结构时，关键在于如何操作才能避免数据丢失。
Laravel的迁移系统通过Schema门面（Facade）提供了一套直观的API来构建和修改数据库表。理解这些API的行为对于安全地管理数据库至关重要。
Schema门面方法详解
Schema门面提供了多种方法来定义和操作数据库表：
-
Schema::create(string $tableName, Closure $callback): 此方法用于创建一个全新的数据库表。在回调函数中，你可以定义表的列、索引和外键。 影响: 它只会创建新表，不会对数据库中已存在的任何数据产生影响。因此，添加新表时使用此方法是完全安全的，不会导致现有数据丢失。
// database/migrations/xxxx_xx_xx_xxxxxx_create_products_table.php use Illuminate\Database\Migrations\Migration; use Illuminate\Database\Schema\Blueprint; use Illuminate\Support\Facades\Schema; class CreateProductsTable extends Migration { public function up() { Schema::create('products', function (Blueprint $table) { $table->id(); $table->string('name'); $table->text('description')->nullable(); $table->decimal('price', 8, 2); $table->timestamps(); }); } public function down() { Schema::dropIfExists('products'); } } -
Schema::table(string $tableName, Closure $callback): 此方法用于修改一个已存在的数据库表。在回调函数中，你可以添加新列、修改现有列、添加索引等。 影响: 它旨在进行非破坏性操作，通常用于添加列或修改列属性，而不会影响表中已有的数据。这是在不丢失数据的情况下扩展现有表结构的首选方法。
// database/migrations/xxxx_xx_xx_xxxxxx_add_category_to_products_table.php use Illuminate\Database\Migrations\Migration; use Illuminate\Database\Schema\Blueprint; use Illuminate\Support\Facades\Schema; class AddCategoryToProductsTable extends Migration { public function up() { Schema::table('products', function (Blueprint $table) { $table->string('category')->after('name')->nullable(); }); } public function down() { Schema::table('products', function (Blueprint $table) { $table->dropColumn('category'); }); } } Schema::rename(string $from, string $to): 此方法用于重命名数据库表。 影响: 它只会更改表的名称，不会影响表中存储的任何数据。数据会随表一起被重命名。
Schema::drop(string $tableName) / Schema::dropIfExists(string $tableName): 这些方法用于删除数据库表。 影响: 它们会永久删除指定的表及其所有数据。使用时务必小心，因为它会导致数据丢失。 通常在down方法中使用，用于回滚迁移。
php artisan migrate命令及其变体
php artisan migrate是执行数据库迁移的核心命令。当您创建了新的迁移文件后，运行此命令会将所有尚未执行的迁移应用到数据库中。它会根据迁移文件的up方法来创建或修改表。
除了php artisan migrate，Laravel还提供了其他一些相关的Artisan命令，它们在不同的场景下发挥作用，但有些可能会导致数据丢失，需要特别注意：
php artisan migrate: 运行所有尚未执行的迁移。安全，不会丢失数据（除非迁移文件中明确执行了Schema::drop()等操作）。
-
php artisan migrate:status: 显示所有迁移的状态（是否已运行、批次号）。这是一个非常有用的调试工具，可以帮助你了解当前数据库的迁移状态。
php artisan migrate:status
输出示例：
+------+-------------------------------------------------------+-------+ | Ran? | Migration | Batch | +------+-------------------------------------------------------+-------+ | Yes | 2014_10_12_000000_create_users_table | 1 | | Yes | 2014_10_12_100000_create_password_resets_table | 1 | | No | 2023_01_01_000000_create_products_table | | +------+-------------------------------------------------------+-------+
php artisan migrate:fresh: 删除所有表，然后重新运行所有迁移。此命令会导致所有数据丢失！ 仅在开发环境或您确定不需要保留任何数据时使用。
php artisan migrate:refresh: 回滚所有迁移，然后重新运行所有迁移。此命令也会导致所有数据丢失！ 类似于fresh，但在内部通过reset和migrate实现。
php artisan migrate:reset: 回滚所有已运行的迁移。此命令会删除所有由迁移创建的表及其数据！
php artisan migrate:rollback: 回滚最近一批次的迁移。如果最近一次运行了多个迁移，它们都会被回滚。此命令会删除最近批次创建的表或修改的数据！
注意事项与最佳实践
- 数据备份: 在生产环境或重要数据环境中执行任何迁移操作之前，务必进行数据库备份。这是防止数据丢失的最后一道防线。
- 理解命令差异: 务必清楚migrate、migrate:fresh、migrate:refresh、migrate:reset和migrate:rollback之间的区别。前两个（migrate和migrate:status）通常是安全且推荐用于日常操作的。
- 开发环境先行: 在将迁移部署到生产环境之前，始终在开发和测试环境中充分测试您的迁移。
- down方法的重要性: 在创建迁移时，确保down方法能够正确地撤销up方法所做的更改。对于Schema::create()，down方法通常是Schema::dropIfExists()；对于Schema::table()添加列，down方法是Schema::table()->dropColumn()。
- 避免在up方法中删除数据: 除非是明确的数据清理或重构，否则应避免在up方法中直接删除数据。如果需要数据转换，可以考虑使用Seeder或单独的数据迁移脚本。
- 版本控制: 迁移文件是代码的一部分，应纳入版本控制系统（如Git），确保团队成员之间的同步。
通过遵循这些指南和理解Laravel数据库迁移的工作原理，您可以高效、安全地管理数据库结构，确保在添加新表或修改现有表时不会意外丢失宝贵的数据。
