如何实现Laravel数据库零停机迁移？daursu/laravel-zero-downtime-migration助你轻松搞定！-composer-PHP中文网

如何实现Laravel数据库零停机迁移？daursu/laravel-zero-downtime-migration助你轻松搞定！

PHPz

发布： 2025-08-23 10:54:24

原创

502人浏览过

Composer在线学习地址：学习地址

夜深人静，你准备上线一个重要功能，它需要为你的

users

登录后复制

表添加一个新字段。你的

users

登录后复制

表里已经积累了数百万甚至上千万的用户数据。你信心满满地敲下

php artisan migrate

登录后复制

，然后... 你的心跳开始加速。你盯着屏幕，眼睁睁看着数据库连接池被耗尽，用户反馈系统收到大量错误报告，甚至可能导致整个服务宕机几分钟，甚至更久。这种“上线即停机”的噩梦，相信每个资深开发者都曾经历过。

传统的Laravel数据库迁移，在执行

ALTER TABLE

登录后复制

等操作时，尤其是在数据量巨大的表上，会锁定表，阻止读写操作。对于24/7不间断服务的应用来说，哪怕是几秒钟的停机也是不可接受的损失。我们不得不选择在用户访问量最低的深夜进行维护，或者想尽办法通过复杂的部署策略来规避，但这些方案都增加了开发和运维的复杂度。

难道就没有一种更优雅、更安全的方式来处理数据库结构变更吗？

答案是肯定的！幸好，PHP社区从来不缺乏优秀的解决方案，而今天我们要介绍的，正是如何利用Composer和

daursu/laravel-zero-downtime-migration

登录后复制

这个强大的工具，彻底告别数据库迁移带来的停机烦恼。

告别停机噩梦：引入

daursu/laravel-zero-downtime-migration

登录后复制

daursu/laravel-zero-downtime-migration

登录后复制

是一个Laravel扩展包，它巧妙地将Percona Toolkit中的

pt-online-schema-change

登录后复制

工具或GitHub的

gh-ost

登录后复制

工具集成到Laravel的迁移流程中。这两个工具都是业界公认的MySQL在线Schema变更利器，它们的核心思想是在不锁定原表的情况下，通过创建新表、同步数据、最终原子性地替换原表的方式来完成Schema变更。

这意味着，当你的Laravel应用进行数据库迁移时，用户仍然可以正常访问和操作，不会感受到任何中断！

如何使用Composer解决问题：

1. 安装与准备

首先，通过Composer将这个包引入你的Laravel项目：

<pre class="brush:php;toolbar:false;">composer require daursu/laravel-zero-downtime-migration

登录后复制

前置条件： 这个包本身只是一个“桥梁”，它依赖于外部的Schema变更工具。你需要根据自己的选择，在服务器上安装对应的工具：

如果你选择
gh-ost
登录后复制
：从其GitHub发布页面下载二进制文件并确保其可执行。
- https://www.php.cn/link/d2d26584b4ffbf0de1af4a7e9ecf3b68
如果你选择
pt-online-schema-change
登录后复制
：安装Percona Toolkit。
- 在macOS上：
```
brew install percona-toolkit
```
  登录后复制
- 在Debian/Ubuntu上：
```
sudo apt-get install percona-toolkit
```
  登录后复制

2. 配置数据库连接

在

config/database.php

登录后复制

文件中，你需要添加一个新的数据库连接，专门用于零停机迁移。这个连接的

driver

登录后复制

字段将指向你选择的在线Schema变更工具。

腾讯智影-AI数字人

基于AI数字人能力，实现7*24小时AI数字人直播带货，低成本实现直播业务快速增增，全天智能在线直播

查看详情

以

pt-online-schema-change

登录后复制

为例：

<pre class="brush:php;toolbar:false;">'connections' => [
    // ... 其他连接
    'zero-downtime' => [
        'driver' => 'pt-online-schema-change', // 或 'gh-ost'

        // 这是你的主数据库（写入权限）连接详情
        'host' => env('DB_HOST', '127.0.0.1'),
        'port' => env('DB_PORT', '3306'),
        'database' => env('DB_DATABASE', 'forge'),
        'username' => env('DB_USERNAME', 'forge'),
        'password' => env('DB_PASSWORD', ''),

        // 传递给 pt-online-schema-change 或 gh-ost 的额外参数
        'params' => [
            '--nocheck-replication-filters',
            '--nocheck-unique-key-change',
            '--recursion-method=none', // 如果有复制集，需要配置此项
            '--chunk-size=2000',
            // 更多参数请参考 pt-online-schema-change 或 gh-ost 的官方文档
        ],
    ],
],

登录后复制

注意：

params

登录后复制

数组中可以添加任何

pt-online-schema-change

登录后复制

或

gh-ost

登录后复制

支持的命令行参数，这提供了极高的灵活性来微调在线变更行为。

3. 编写零停机迁移文件

现在，当你需要进行Schema变更时，不再使用Laravel默认的

Schema

登录后复制

facade，而是使用

ZeroDowntimeSchema

登录后复制

facade。

例如，为

users

登录后复制

表添加一个

phone_number

登录后复制

字段：

<pre class="brush:php;toolbar:false;"><?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Daursu\ZeroDowntimeMigration\ZeroDowntimeSchema; // 引入 ZeroDowntimeSchema

class AddPhoneNumberToUsersTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        ZeroDowntimeSchema::table('users', function (Blueprint $table) {
            $table->string('phone_number')->nullable()->after('email'); // 添加字段
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        ZeroDowntimeSchema::table('users', function (Blueprint $table) {
            $table->dropColumn('phone_number'); // 回滚操作
        });
    }
}

登录后复制

编写完迁移文件后，正常运行

php artisan migrate

登录后复制

即可。此时，Laravel会通过

daursu/laravel-zero-downtime-migration

登录后复制

将Schema变更指令转发给

pt-online-schema-change

登录后复制

或

gh-ost

登录后复制

来执行，从而实现零停机。

优势和实际应用效果：

真正的零停机： 这是最大的优势。在迁移过程中，你的用户不会感受到任何服务中断或性能下降，确保了业务的连续性。
降低风险： 在线Schema变更工具通常有完善的错误处理和回滚机制。例如，
```
pt-online-schema-change
```
登录后复制
在执行过程中会创建影子表，即使出现问题，也可以安全地中止操作，不影响原表。
提高开发效率： 告别深夜维护和复杂的部署流程。开发者可以更频繁、更自信地进行数据库结构变更，加速新功能的迭代。
与Laravel无缝集成： 只需要简单地将
```
Schema
```
登录后复制
替换为
```
ZeroDowntimeSchema
```
登录后复制
，几乎不改变原有的迁移编写习惯，学习成本极低。
灵活性： 通过
```
params
```
登录后复制
参数，可以完全控制底层在线Schema变更工具的行为，满足各种复杂的场景需求。

需要注意的“坑”：

仅支持MySQL： 这个包和底层工具（
```
gh-ost
```
登录后复制
,
```
pt-online-schema-change
```
登录后复制
）目前只支持MySQL、Percona Server和MariaDB。
主要用于
ALTER TABLE
登录后复制
：它最适合用于修改现有表的结构（如添加/删除列、修改列类型、添加索引等），而不是创建或删除整个表。
测试环境处理： 在测试环境中，你可能不希望真正运行
```
pt-online-schema-change
```
登录后复制
。可以通过在
```
TestCase.php
```
登录后复制
的
```
setUp
```
登录后复制
方法中调用
```
ZeroDowntimeSchema::disable();
```
登录后复制
来禁用零停机模式，让迁移回到Laravel默认行为。

总结

daursu/laravel-zero-downtime-migration

登录后复制

结合Composer的便利性，为Laravel开发者提供了一个优雅且高效的解决方案，彻底解决了大型应用数据库迁移带来的停机痛点。它将复杂的在线Schema变更操作封装成简单的Laravel facade调用，大大降低了实施门槛。如果你正在为数据库迁移的停机问题而烦恼，强烈推荐你尝试这个包，它将彻底改变你的部署体验，让你的应用在高并发下也能从容应对数据库结构变更！

以上就是如何实现Laravel数据库零停机迁移？daursu/laravel-zero-downtime-migration助你轻松搞定！的详细内容，更多请关注php中文网其它相关文章！