如何利用 composer script 在 install/update 后自动执行数据库迁移？

可通过配置composer.json的scripts实现安装或更新后自动运行数据库迁移。1. 在composer.json中添加post-install-cmd和post-update-cmd脚本，调用@php artisan migrate --no-interaction执行迁移；2. 如需更复杂逻辑，可编写PHP类如PostUpdateScript.php并在scripts中注册，通过files自动加载；3. 注意生产环境慎用，建议结合环境变量控制，避免数据丢失，并确保命令可执行。此方法提升部署效率，适配不同项目需求。

在使用 Composer 管理 PHP 项目依赖时，你可能希望在执行 composer install 或 composer update 后自动运行数据库迁移。这在部署流程或团队协作中非常实用。可以通过 Composer 的 scripts 功能实现这一目标。

1. 配置 composer.json 中的 scripts

Composer 支持在特定事件触发时运行自定义脚本。常用的事件包括 post-install-cmd 和 post-update-cmd，它们分别在 install 和 update 命令完成后执行。

打开你的 composer.json 文件，在 "scripts" 部分添加如下内容：

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

说明：

• @php 是 Composer 提供的命令别名，用于调用当前环境下的 PHP CLI，并自动处理可执行路径问题。
• artisan migrate 是 Laravel 框架的迁移命令，如果你使用的是其他框架或自定义迁移脚本，请替换为对应命令。
• --no-interaction 确保命令非交互式运行，适合自动化场景。

2. 使用自定义 PHP 类（可选，更灵活）

如果需要更复杂的逻辑（如判断是否是首次安装、读取配置等），可以编写一个 PHP 类来处理脚本。

析稿Ai写作

科研人的高效工具：AI论文自动生成，十分钟万字，无限大纲规划写作思路。

142

查看详情

创建文件 scripts/PostUpdateScript.php：

<?php

class PostUpdateScript
{
    public static function runMigrations($event)
    {
        echo "Running database migrations...\n";
        $cmd = 'php artisan migrate --no-interaction';
        system($cmd, $returnCode);

        if ($returnCode !== 0) {
            echo "Migration failed.\n";
            exit($returnCode);
        }

        echo "Migrations completed.\n";
    }
}

然后在 composer.json 中注册该脚本：

{
    "scripts": {
        "post-install-cmd": "PostUpdateScript::runMigrations",
        "post-update-cmd": "PostUpdateScript::runMigrations"
    },
    "files": ["scripts/PostUpdateScript.php"]
}

注意：必须通过 "files" 自动加载该 PHP 文件，否则类无法被找到。

3. 注意事项与最佳实践

• 自动迁移在生产环境中要谨慎使用，建议结合环境判断。例如通过环境变量控制是否执行：

if (getenv('AUTO_MIGRATE') === 'true') { ... }

登录后复制
• 避免在开发环境中频繁触发迁移造成数据丢失。
• 确保目标命令（如 artisan）存在于项目根目录下且有执行权限。
• Composer 脚本默认按顺序执行，多个脚本可用数组形式列出。

基本上就这些。通过合理配置 Composer scripts，你可以轻松实现 install/update 后自动执行数据库迁移，提升部署效率。关键是根据项目实际需求选择简单命令还是可编程脚本方式。

以上就是如何利用 composer script 在 install/update 后自动执行数据库迁移？的详细内容，更多请关注php中文网其它相关文章！