empiremedical/queue-runner Docker 镜像 - 轩辕镜像

镜像概述

该镜像提供Docker化的PHP命令行（CLI）运行环境，基于官方PHP CLI镜像构建并预安装pdo_mysql扩展。旨在为用户提供即开即用的PHP命令行环境，特别适用于需要与MySQL数据库交互的PHP脚本执行场景。

核心功能与特性

• PHP CLI运行时：包含完整PHP命令行执行环境，支持运行各类PHP脚本
• 预配置pdo_mysql扩展：无需额外安装即可通过PDO接口连接和操作MySQL数据库
• 轻量级设计：基于官方PHP CLI基础镜像，保持较小体积，适合快速部署
• 版本兼容性：支持多种PHP版本标签（如7.4-cli、8.1-cli等），适配不同项目需求
• Docker生态集成：可无缝对接Docker Compose、Kubernetes等容器编排工具，支持CI/CD工作流

使用场景与适用范围

• PHP命令行脚本执行：运行独立PHP工具脚本、数据处理脚本等
• 数据库交互任务：执行数据库迁移脚本、数据导入/导出、SQL查询脚本等
• 定时任务环境：作为Cron作业执行环境，运行周期性PHP任务
• 开发测试环境：本地开发中快速测试PHP脚本，无需配置主机PHP环境

使用方法与配置说明

基本使用

通过docker run命令启动容器并执行PHP命令：

bash
# 查看PHP版本
docker run --rm [镜像标签] php -v

# 执行简单PHP代码
docker run --rm [镜像标签] php -r "echo 'Hello World';"

挂载本地代码

挂载本地目录至容器内，执行本地PHP脚本：

bash
# 执行当前目录下的script.php
docker run --rm -v $(pwd):/app [镜像标签] php /app/script.php

# 示例：运行数据处理脚本
docker run --rm -v /path/to/local/scripts:/app [镜像标签] php /app/data_processor.php

连接MySQL数据库

连接外部MySQL

通过环境变量或脚本配置数据库连接信息：

bash
# 执行连接外部MySQL的脚本
docker run --rm -v $(pwd):/app [镜像标签] php /app/mysql_script.php

脚本示例（mysql_script.php）：

php
<?php
try {
    $pdo = new PDO(
        'mysql:host=mysql-host;dbname=testdb;charset=utf8mb4',
        'username',
        'password'
    );
    echo "MySQL连接成功";
} catch (PDOException $e) {
    die("连接失败: " . $e->getMessage());
}
?>

连接Docker MySQL容器

与Docker MySQL容器联动（使用Docker网络）：

bash
# 创建自定义网络
docker network create php-mysql-net

# 启动MySQL容器
docker run -d --name mysql --network php-mysql-net -e MYSQL_ROOT_PASSWORD=pass -e MYSQL_DATABASE=test mysql:latest

# PHP容器连接MySQL容器
docker run --rm --network php-mysql-net -v $(pwd):/app [镜像标签] php /app/mysql_script.php

自定义PHP配置

挂载自定义php.ini调整PHP配置：

bash
# 挂载本地php.ini至容器配置目录
docker run --rm -v $(pwd)/php.ini:/usr/local/etc/php/php.ini -v $(pwd):/app [镜像标签] php /app/script.php

环境变量说明

继承官方PHP CLI镜像环境变量，主要包括：

• PHP_INI_DIR：PHP配置文件目录（默认/usr/local/etc/php）
• PHP_EXTRA_CONFIGURE_ARGS：编译时额外配置参数（构建镜像时使用）

注意事项

• 选择镜像标签时需匹配项目PHP版本需求（如8.2-cli对应PHP 8.2）
• 执行文件操作脚本时，确保挂载目录权限正确（可通过-u参数指定用户）
• 生产环境中建议配合非root用户运行容器，增强安全性
• 连接数据库时需确保网络可达性及凭据安全性（避免硬编码敏感信息）