如何在Composer更新Laravel包时自动执行迁移？

好问题！要实现composer update name/name-package时自动跑你的包的迁移，核心是利用Composer的脚本钩子，结合Laravel的迁移发布机制，下面分步骤给你拆解：

1. 确保你的包能自动发布迁移文件 #

首先得保证你的包的迁移文件能自动复制到项目的database/migrations目录，不用用户手动跑vendor:publish。在你的包的ServiceProvider的boot方法里，用Laravel 8+提供的publishesMigrations方法：

public function boot()
{
    // 自动发布迁移文件到项目目录
    $this->publishesMigrations([
        __DIR__.'/../database/migrations' => database_path('migrations'),
    ]);
}

如果是Laravel 7及以下版本，用publishes方法并指定migrations标签，不过还是建议升级到新版写法更省心。

2. 用Composer脚本钩子自动执行迁移 #

Composer提供了多个事件钩子，我们可以用post-update-cmd或者post-package-update来触发迁移命令。

方式一：直接在composer.json里添加命令 #

在你的包的composer.json的scripts节点下，添加post-update-cmd钩子：

{
    "name": "name/name-package",
    // ... 其他配置
    "scripts": {
        "post-update-cmd": [
            "@php artisan migrate --force"
        ]
    }
}

• --force参数是为了跳过生产环境的确认提示，如果你不想强制执行，可以去掉，但生产环境下用户需要手动确认。
• 注意：这个钩子会在任何Composer更新操作后触发，不只是你的包更新。如果只想在你的包更新时才跑，看方式二。

方式二：自定义脚本判断仅更新你的包时执行 #

如果你希望只有当用户更新你的包时才触发迁移，可以写一个自定义的PHP脚本，在脚本里判断当前更新的包是否是你的包：

1. 在你的包的src/Scripts目录下创建PostUpdateHandler.php：

<?php

namespace YourPackage\Scripts;

use Composer\Script\Event;

class PostUpdateHandler
{
    public static function handle(Event $event)
    {
        // 获取本次更新的包列表
        $updatedPackages = $event->getComposer()->getRepositoryManager()->getLocalRepository()->getPackages();
        
        foreach ($updatedPackages as $package) {
            // 检查是否是你的包
            if ($package->getName() === 'name/name-package') {
                // 执行迁移命令
                exec('php artisan migrate --force');
                echo "✅ 你的包迁移已自动执行完成！\n";
                break;
            }
        }
    }
}

2. 在你的包的composer.json里注册这个脚本，并确保命名空间能被自动加载：

{
    // ... 其他配置
    "autoload": {
        "psr-4": {
            "YourPackage\\": "src/",
            "YourPackage\\Scripts\\": "src/Scripts/"
        }
    },
    "scripts": {
        "post-package-update": "YourPackage\\Scripts\\PostUpdateHandler::handle"
    }
}

这样每次有包更新时，Composer会调用这个脚本，只有你的包被更新时才会执行迁移。

3. 重要注意事项 #

• 生产环境风险：自动迁移在生产环境可能导致数据问题，建议给用户提供一个配置开关，让他们可以选择是否开启自动迁移。比如在你的包的配置文件里加auto_migrate选项，然后在脚本里判断这个配置再执行。
• 迁移顺序：如果你的迁移依赖其他包的迁移，要确保迁移文件名的时间戳设置合理，避免执行顺序出错。
• 测试：在本地环境多次测试composer update和composer require操作，确保迁移能正确自动执行。

内容的提问来源于stack exchange，提问作者Bas