splattael/phpmyadmin

phpMyAdmin on Alpine 3.12

![image]([***]

镜像概述和主要用途

本镜像基于Alpine 3.12构建，集成phpMyAdmin工具，提供Web界面用于管理MySQL数据库。通过轻量级Alpine系统基础，确保镜像体积小、资源占用低，同时支持灵活配置PHP参数和多数据库服务器连接，适用于开发、测试及小型生产环境的数据库管理需求。

核心功能和特性

• 轻量级基础：基于Alpine 3.12，镜像体积小，启动速度快
• 可配置PHP参数：支持通过环境变量调整PHP上传大小、内存限制等关键配置
• 多服务器支持：通过PMA_SERVERS环境变量配置多数据库服务器连接
• 代理友好：默认启用mod_remoteip.so，支持通过X-Forwarded-For头记录真实客户端IP，便于反向代理部署
• 稳定组件：集成Apache 2.4、PHP 7.3及phpMyAdmin 4.9.7，确保功能稳定可靠

使用场景和适用范围

• 开发环境中快速搭建MySQL数据库管理界面
• 测试环境中临时管理数据库实例
• 小型生产环境中轻量级数据库管理工具部署
• 需要通过Web界面直观操作MySQL的场景

使用方法和配置说明

Docker run 部署

bash
docker run \
  --link mysql:mysql \
  --name phpmyadmin \
  -P \
  splattael/phpmyadmin

环境变量配置

可通过以下环境变量自定义PHP和phpMyAdmin配置：

• -e PHP_UPLOAD_MAX_FILESIZE=2M：PHP上传文件大小限制（默认2M）
• -e PHP_POST_MAX_SIZE=8M：PHP POST数据大小限制（默认8M）
• -e PHP_MEMORY_LIMIT=128M：PHP内存限制（默认128M）
• -e PHP_MAX_EXECUTION_TIME=300：PHP最大执行时间（默认300秒）
• -e PMA_SERVERS=mysql://mysql：配置数据库服务器连接，更多示例见https://github.com/splattael/docker-phpmyadmin/blob/master/config.inc.php

代理配置（mod_remoteip.so）

默认启用mod_remoteip.so模块，支持通过X-Forwarded-For HTTP头记录客户端真实IP，便于反向代理部署。例如Nginx代理配置：

nginx
location / {
  proxy_pass http://backend;
  proxy_set_header Host $host;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

测试步骤

bash
# 创建网络
docker network create backend

# 启动MySQL（首次运行）
docker run -d --name mysql --net backend -e MYSQL_ROOT_PASSWORD=mysql mysql:5.7

# 或使用MySQL 8.0（需指定认证插件）
# docker run -d --name mysql --net backend -e MYSQL_ROOT_PASSWORD=mysql mysql:8.0 --default-authentication-plugin=mysql_native_password

# 后续启动MySQL
docker start mysql

# 运行测试
make test

# 查看映射端口
docker port `docker ps -l -q`
# 示例输出：80/tcp -> 0.0.0.0:32768

访问 http://localhost:32768/phpmyadmin 即可打开管理界面。

软件版本信息

• apache2-2.4.46-r0
• php-apache2-7.3.27-r0
• phpMyAdmin 4.9.7（源码构建）

发布说明

更新镜像版本需执行以下步骤：

1. Makefile：更新VERSION字段
2. Dockerfile：更新PHPMYADMIN_VERSION和RELEASE_DATE
3. README.md：更新"软件版本信息"部分的版本号
4. 执行make release命令发布新版本