matthewbaggett/phpmyadmin

docker_phpmyadmin 镜像文档

镜像概述

docker_phpmyadmin 是一个基于 yoshz/phpmyadmin 的改进版 Docker 镜像，主要解决了原镜像中缺少初始数据的问题，确保能够正确导入 phpMyAdmin 的设置表，保障 phpMyAdmin 正常运行所需的基础配置数据完整性。

核心功能与特性

• 继承 yoshz/phpmyadmin 的全部功能，提供 PHPMyAdmin 数据库管理界面
• 修复初始数据缺失问题，确保 phpMyAdmin 设置表（如 pma__userconfig 等）正确导入
• 保持与原镜像一致的使用体验，同时提升初始化可靠性

使用场景与适用范围

适用于需要通过 PHPMyAdmin 管理 MySQL/MariaDB 数据库，且希望避免因初始数据缺失导致功能异常的场景，尤其适合开发环境、测试环境及小型生产环境中快速部署 PHPMyAdmin。

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d -p 8080:80 --name phpmyadmin docker_phpmyadmin

上述命令将启动容器并映射 8080 端口到容器的 80 端口，通过 http://localhost:8080 即可访问 PHPMyAdmin 界面。

连接数据库

如需连接外部数据库，可通过环境变量指定数据库主机、用户名和密码：

bash
docker run -d -p 8080:80 \
  -e PMA_HOST=mysql-host \
  -e PMA_USER=admin \
  -e PMA_PASSWORD=password \
  --name phpmyadmin docker_phpmyadmin

其中：

• PMA_HOST：数据库主机地址或容器名称
• PMA_USER：数据库连接用户名
• PMA_PASSWORD：数据库连接密码

Docker Compose 示例

yaml
version: '3'
services:
  phpmyadmin:
    image: docker_phpmyadmin
    ports:
      - "8080:80"
    environment:
      - PMA_HOST=mysql
      - PMA_USER=root
      - PMA_PASSWORD=rootpassword
    depends_on:
      - mysql
  mysql:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=rootpassword

启动命令：docker-compose up -d，通过 http://localhost:8080 访问 PHPMyAdmin，连接到 mysql 服务。

注意事项

• 该镜像仅修复初始数据导入问题，其他配置与 yoshz/phpmyadmin 保持一致
• 建议根据实际需求调整端口映射及数据库连接参数
• 生产环境中应注意设置安全的数据库凭证及网络隔离