如何让 composer 在更新包时自动执行数据库迁移脚本？-composer-PHP中文网

如何让 composer 在更新包时自动执行数据库迁移脚本？

冰火之心

发布： 2025-11-13 17:07:02

原创

402人浏览过

答案：可通过Composer的post-update-cmd或post-autoload-dump钩子执行迁移。在composer.json中定义脚本，更新后自动运行php artisan migrate；开发包时可监听事件复制迁移文件并执行，但生产环境需谨慎使用，建议结合CI/CD管理。

如何让 composer 在更新包时自动执行数据库迁移脚本？

Composer 本身不直接支持在更新包时自动运行数据库迁移，但可以通过 自定义脚本 + Composer 钩子（scripts） 的方式实现类似效果。以下是具体做法：

使用 Composer 的 post-update-cmd 钩子

你可以在项目的 composer.json 文件中定义一个脚本，在每次执行 composer update 后自动运行迁移。

{
    "scripts": {
        "post-update-cmd": [
            "php artisan migrate --no-interaction"
        ]
    }
}

登录后复制

这样，每次运行 composer update 完成后，Laravel 的迁移命令会自动执行。适用于 Laravel 项目或其他带迁移命令的框架。

为特定包添加安装/更新钩子

如果你开发的是一个独立的包，并希望在它被安装或更新时触发某些操作（比如运行迁移），可以：

行者AI

行者AI绘图创作，唤醒新的灵感，创造更多可能

100

查看详情

在主项目中监听 post-autoload-dump 或 post-install-cmd
检查是否新增或更新了你的包
然后复制迁移文件并执行

示例脚本：

{
    "scripts": {
        "post-autoload-dump": [
            "MyPackage\Installer::postAutoloadDump"
        ]
    }
}

登录后复制

然后在代码中实现逻辑：

namespace MyPackage;

use ComposerScriptEvent;
use SymfonyComponentFilesystemFilesystem;

class Installer
{
    public static function postAutoloadDump(Event $event)
    {
        $filesystem = new Filesystem();
        $migrationFile = __DIR__ . '/migrations/2024_01_01_000000_add_columns.php';
        $target = base_path('database/migrations/' . basename($migrationFile));

        if (!file_exists($target) && file_exists($migrationFile)) {
            $filesystem->copy($migrationFile, $target);
            echo "Migration copied.
";
        }

        // 可选：执行 Artisan 命令
        if (function_exists('app')) {
            Artisan::call('migrate', ['--force' => true]);
            echo "Migrations run.
";
        }
    }
}

登录后复制

注意事项与建议

谨慎使用自动迁移：生产环境应手动确认迁移内容，避免意外修改数据库
区分开发与生产：可通过环境变量控制是否自动执行
不要依赖 composer 脚本做核心部署流程：推荐将迁移纳入 CI/CD 或部署脚本中统一管理
确保框架已加载：调用 Artisan 前要确认 Laravel 已启动

基本上就这些。Composer 不是部署工具，但它提供的脚本钩子足够让你“顺手”完成一些自动化任务。

以上就是如何让 composer 在更新包时自动执行数据库迁移脚本？的详细内容，更多请关注php中文网其它相关文章！