laravel 的数据库迁移（migrations）提供了一种版本控制系统，用于管理数据库模式。它允许团队协作修改数据库结构，并确保所有开发者都拥有最新的数据库定义。核心思想是将数据库的每一次结构变化都视为一个“迁移”文件，通过运行这些文件来更新数据库。
默认情况下，php artisan migrate 命令会执行所有尚未运行的迁移文件。对于添加新表或修改现有表结构的操作，只要迁移文件编写得当，该命令并不会导致现有数据的丢失。
当需要向数据库中添加全新的表时，应使用 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::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
Laravel 的 Schema 门面提供了多种数据库操作方法，了解它们对数据的影响至关重要：
在使用 Schema::drop() 或 Schema::dropIfExists() 时务必谨慎，尤其是在生产环境中。
为了查看当前所有迁移文件的执行状态，可以使用 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 迁移命令族中存在一些命令，它们的设计目的就是重置或刷新数据库，因此会导致数据丢失。在生产环境或包含重要数据的开发环境中，使用这些命令时必须格外小心。
重要提示： 在执行任何可能导致数据丢失的命令之前，务必备份您的数据库。
在 Laravel 中安全地管理数据库结构变更，同时保护现有数据，关键在于理解不同 Schema 方法和 Artisan 迁移命令的作用：
通过遵循这些原则，您可以有效地利用 Laravel 的数据库迁移系统，实现数据库结构的平滑演进，同时确保数据的完整性和安全性。
以上就是Laravel 数据库迁移：安全添加新表与数据管理指南的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
564
收藏
