siwa/phpmyadmin

官方phpMyAdmin Docker镜像

运行基于Alpine、supervisor、nginx和PHP FPM的phpMyAdmin。

![Build Status]([***]

以下所有示例将在 http://localhost:8080 提供phpMyAdmin服务，您可以在此进行MySQL管理操作。

凭证说明

phpMyAdmin使用MySQL服务器凭证，请参考对应服务器镜像的设置方法。官方MySQL和MariaDB镜像使用以下环境变量定义凭证：

• MYSQL_ROOT_PASSWORD - 必需变量，指定root超级用户账户的密码。
• MYSQL_USER、MYSQL_PASSWORD - 可选变量，用于创建新用户并设置该用户的密码。

Docker Hub标签

可使用以下Docker Hub标签：

• latest - 最新稳定版本
• 4.8 - 4.8版本的最新稳定发布
• edge - 前沿Docker镜像（包含稳定的phpMyAdmin，但Docker镜像变更可能尚未完全测试）
• edge-4.8 - 前沿Docker镜像 + 4.8分支的最新快照（当前为master分支）

使用场景和适用范围

• 本地开发环境：快速搭建数据库管理界面
• 测试环境：临时部署用于数据库测试和调试
• 生产环境：通过反向代理安全访问数据库管理功能
• 需要管理多个MySQL/MariaDB服务器的场景

使用方法和配置说明

链接服务器使用

首先需在Docker中运行MySQL或MariaDB服务器，然后将此镜像链接到运行中的MySQL实例容器：

bash
docker run --name myadmin -d --link mysql_db_server:db -p 8080:80 phpmyadmin/phpmyadmin

外部服务器使用

可通过PMA_HOST环境变量指定MySQL主机。若服务器端口非默认值，可使用PMA_PORT指定端口：

bash
docker run --name myadmin -d -e PMA_HOST=dbhost -p 8080:80 phpmyadmin/phpmyadmin

任意服务器使用

通过添加环境变量PMA_ARBITRARY=1，可允许连接任意服务器：

bash
docker run --name myadmin -d -e PMA_ARBITRARY=1 -p 8080:80 phpmyadmin/phpmyadmin

使用docker-compose和任意服务器

此方式将运行支持任意服务器的phpMyAdmin，允许在登录页面指定MySQL/MariaDB服务器。

使用https://github.com/phpmyadmin/docker%E4%B8%AD%E7%9A%84docker-compose.yml%EF%BC%9A

bash
docker-compose up -d

使用docker-compose运行E2E测试

可通过运行MariaDB/MySQL数据库在本地测试环境中运行E2E测试。环境变量PHPMYADMIN_RUN_TEST=true已添加到docker-compose文件中。只需运行：

使用https://github.com/phpmyadmin/docker%E4%B8%AD%E7%9A%84docker-compose.testing.yml%EF%BC%9A

bash
docker-compose -f docker-compose.testing.yml up phpmyadmin

添加自定义配置

可通过创建名为config.user.inc.php的文件添加自定义config.inc.php设置（如配置存储设置），其中包含各种用户定义的设置，然后通过以下方式将其链接到容器：

bash
-v /some/local/directory/config.user.inc.php:/etc/phpmyadmin/config.user.inc.php

完整的docker run命令示例：

bash
docker run --name myadmin -d --link mysql_db_server:db -p 8080:80 -v /some/local/directory/config.user.inc.php:/etc/phpmyadmin/config.user.inc.php phpmyadmin/phpmyadmin

配置文件相关信息请参考以下链接： [] []

反向代理后使用

设置变量PMA_ABSOLUTE_URI为反向代理提供phpMyAdmin访问的完整路径（如https://pma.example.net/）。

环境变量汇总

• PMA_ARBITRARY - 设置为1时允许连接任意服务器
• PMA_HOST - 定义MySQL服务器的地址/主机名
• PMA_VERBOSE - 定义MySQL服务器的显示名称
• PMA_PORT - 定义MySQL服务器的端口
• PMA_HOSTS - 定义逗号分隔的MySQL服务器地址/主机名列表
• PMA_VERBOSES - 定义逗号分隔的MySQL服务器显示名称列表
• PMA_PORTS - 定义逗号分隔的MySQL服务器端口列表
• PMA_USER 和 PMA_PASSWORD - 定义用于配置认证方式的用户名和密码
• PMA_ABSOLUTE_URI - 定义用户访问的URI

更多详细文档请参见[***]

有关Docker容器的任何问题，请报告至https://github.com/phpmyadmin/docker/issues