phpMyAdmin容器编排：Docker Compose多服务配置指南

phpMyAdmin容器编排：Docker Compose多服务配置指南

【免费下载链接】phpmyadmin A web interface for MySQL and MariaDB 项目地址: https://gitcode.com/gh_mirrors/ph/phpmyadmin

你还在为本地开发环境中MySQL与phpMyAdmin的版本冲突烦恼吗？还在手动配置数据库连接参数时频频出错吗？本文将通过Docker Compose实现phpMyAdmin与MySQL的一键部署，让你5分钟内拥有稳定可用的数据库管理平台。读完本文后，你将掌握多服务容器编排技巧、环境变量配置方法以及常见问题排查方案。

准备工作：环境搭建基础

必要软件安装

开始前需确保系统已安装：

• Docker Engine（20.10+）
• Docker Compose（v2+）
• Git（用于获取配置示例）

克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/ph/phpmyadmin.git
cd phpmyadmin

项目配置文件

核心配置文件参考：

• 官方配置模板：config.sample.inc.php
• 安装文档：docs/setup.rst

Docker Compose配置文件编写

基础架构设计

采用双服务架构：

完整配置示例

创建docker-compose.yml文件：

version: '3.8'

services:
  db:
    image: mysql:8.0
    volumes:
      - db_data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD:-rootpass123}
      MYSQL_DATABASE: ${DB_NAME:-appdb}
    restart: always
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      timeout: 5s
      retries: 5

  phpmyadmin:
    image: phpmyadmin:latest
    ports:
      - "8080:80"
    environment:
      PMA_HOST: db
      PMA_PORT: 3306
      PMA_USER: root
      PMA_PASSWORD: ${DB_ROOT_PASSWORD:-rootpass123}
      UPLOAD_LIMIT: 100M
    depends_on:
      db:
        condition: service_healthy
    restart: always

volumes:
  db_data:

服务启动与访问验证

启动命令

# 后台启动服务
docker compose up -d

# 查看服务状态
docker compose ps

访问phpMyAdmin

打开浏览器访问：http://localhost:8080 成功登录后可看到数据库管理界面：

高级配置：定制化你的环境

多数据库服务器配置

修改environment部分实现多服务器切换：

environment:
  PMA_HOSTS: db,db2,db3
  PMA_VERBOSES: 主数据库,测试库,备份库
  PMA_PORTS: 3306,3307,3308

持久化配置覆盖

通过 volumes 挂载自定义配置：

volumes:
  - ./config.user.inc.php:/etc/phpmyadmin/config.user.inc.php

配置示例（config.user.inc.php）：

<?php
// 自定义CSV导出格式
$cfg['Export']['csv_columns'] = true;
// 启用查询历史记录
$cfg['QueryHistoryDB'] = true;
$cfg['QueryHistoryMax'] = 100;

常见问题解决

端口冲突处理

修改ports映射解决端口占用：

ports:
  - "8081:80"  # 将8080改为未占用端口

数据库连接失败排查

1. 检查服务健康状态：

docker compose logs db

2. 验证环境变量传递：

docker compose exec phpmyadmin env | grep PMA_

数据备份策略

定期备份数据库数据卷：

docker run --rm -v $(pwd):/backup -v phpmyadmin_db_data:/source alpine tar -czf /backup/db_backup.tar.gz -C /source .

安全最佳实践

敏感信息保护

创建.env文件存储密码：

DB_ROOT_PASSWORD=StrongP@ssw0rd
DB_NAME=production_db

在docker-compose.yml中引用：

environment:
  MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}

网络隔离配置

添加自定义网络限制容器通信：

networks:
  db_net:
    driver: bridge
    internal: true

services:
  db:
    networks:
      - db_net
  phpmyadmin:
    networks:
      - db_net

总结与展望

通过本文配置，你已实现：

• ✅ 基于Docker Compose的多服务编排
• ✅ 环境变量驱动的配置管理
• ✅ 健康检查与依赖启动控制
• ✅ 数据持久化与备份策略

进阶学习方向：

1. 集成Redis实现查询缓存：src/Cache.php
2. 配置SSL加密连接：docs/setup.rst
3. 实现监控告警系统：src/Logging.php

如果觉得本文对你有帮助，请点赞收藏并关注，下期将带来《phpMyAdmin高级特性：主从复制监控配置》。

【免费下载链接】phpmyadmin A web interface for MySQL and MariaDB 项目地址: https://gitcode.com/gh_mirrors/ph/phpmyadmin