velmie/laravel-migrate

Laravel migrations (基于Lumen)

镜像概述

本Docker镜像基于Lumen框架构建，旨在提供一种便捷方式运行Laravel数据库迁移，无需在本地环境安装Laravel及相关依赖。通过挂载本地迁移文件目录并配置数据库连接参数，即可快速执行数据库结构更新。

核心功能与特性

• 迁移文件挂载：支持将本地Laravel迁移文件目录挂载至容器，直接使用本地迁移脚本
• 灵活的数据库配置：通过环境变量配置数据库连接信息（主机、端口、数据库名、用户名、密码等）
• 多连接支持：默认使用MySQL连接，可通过环境变量指定其他数据库连接类型
• 自动清理：支持容器退出后自动删除，避免残留容器文件

使用场景

• 需要在不同环境（开发、测试、生产）快速执行Laravel数据库迁移
• 临时执行数据库结构更新任务，无需部署完整Laravel应用
• 在CI/CD流程中集成数据库迁移步骤

使用方法

基本命令示例

bash
docker run -v "/your/path/to/migrations:/migrations" -e "DB_HOST=host" -e "DB_PORT=3306" -e "DB_DATABASE=example" -e "DB_USERNAME=root" -e "DB_PASSWORD=secret" --rm velmie/laravel-migrate:1.0.0

警告：请务必指定标签版本（如1.0.0）。latest标签指向旧版本，仅为保持向后兼容。

命令选项说明

-v：挂载卷

• "-v "/your/path/to/migrations:/migrations""：将本地迁移文件目录（/your/path/to/migrations）挂载至容器内的/migrations目录，容器将读取此目录下的迁移文件

-e：设置环境变量

• "-e "DB_HOST=host""：指定数据库主机地址
• "-e "DB_PORT=3306""：指定数据库端口（默认3306）
• "-e "DB_DATABASE=example""：指定数据库名称
• "-e "DB_USERNAME=root""：指定数据库用户名
• "-e "DB_PASSWORD=secret""：指定数据库密码
• "-e "DB_CONNECTION=mysql""：指定数据库连接类型（默认值为mysql，可根据需求修改）

其他选项

• velmie/laravel-migrate:1.0.0：使用的Docker镜像名称及版本
• --rm：容器退出后自动删除容器

数据库连接配置

默认使用MySQL连接，如需指定其他数据库连接类型，可添加环境变量：

bash
-e "DB_CONNECTION=mysql"  # 显式指定MySQL连接（默认值）

（可根据实际支持的数据库类型修改连接名称，如pgsql等）

连接本地主机数据库

如需连接主机机器上的数据库，需添加--network="host"并指定DB_HOST=127.0.0.1：

bash
docker run -v "/your/path/to/migrations:/migrations" -e "DB_HOST=127.0.0.1" -e "DB_PORT=3306" -e "DB_DATABASE=example" -e "DB_USERNAME=root" -e "DB_PASSWORD=secret" --network="host" --rm velmie/laravel-migrate:1.0.0

注意：必须使用127.0.0.1而非localhost，否则可能尝试通过socket文件连接导致失败。