XAMPP Docker 镜像文档

镜像概述

xampp/app 是基于 XAMPP（Apache + MySQL + PHP + Perl）的 Docker 镜像，封装了完整的 Web 服务器解决方案。该镜像将 Apache 服务器、MySQL 数据库、PHP 解释器及 Perl 集成于一体，提供开箱即用的 Web 开发环境，无需手动配置各组件，可快速部署用于本地开发、测试或小型应用演示。

核心功能与特性

• 集成核心组件：包含 Apache 服务器（Web 服务）、MySQL 数据库（关系型数据库管理系统）、PHP 解释器（服务端脚本语言）及 Perl（通用脚本语言），满足 Web 开发全流程需求。
• 跨平台兼容：基于 Docker 容器化技术，支持在 Windows、macOS、Linux 等系统上一致运行，避免环境差异导致的兼容性问题。
• 即开即用：无需手动安装配置各组件，拉取镜像后可直接启动，默认配置适用于大多数开发场景。
• 数据持久化：支持通过数据卷挂载 Web 根目录、数据库文件等，确保容器重启后数据不丢失。
• 灵活配置：可通过环境变量或挂载自定义配置文件，调整 Apache、MySQL、PHP 等组件的参数。

使用场景

• 本地 Web 开发：快速搭建与生产环境一致的开发环境，支持 PHP 项目（如 WordPress、Drupal 等）的本地开发调试。
• 教学与演示：作为 Web 开发教学工具，简化环境搭建步骤，让学***者专注于代码编写。
• 小型测试服务器：用于临时部署应用进行功能测试或兼容性验证，无需复杂的服务器配置。

使用方法与配置

Docker Run 快速启动

通过以下命令可直接启动容器，映射 Web 服务端口（80）和 MySQL 端口(3306)，并挂载本地 Web 目录：

docker run -d \
  --name xampp-dev \
  -p 80:80 \          # Apache Web 服务端口
  -p 3306:3306 \      # MySQL 数据库端口
  -v ./www:/opt/lampp/htdocs \  # 本地 Web 目录挂载
  -v ./mysql-data:/opt/lampp/var/mysql \  # MySQL 数据持久化
  xampp/app

Docker Compose 配置示例

创建 docker-compose.yml 文件，定义更灵活的服务配置：

version: '3'
services:
  xampp:
    image: xampp/app
    container_name: xampp-server
    ports:
      - "80:80"       # Web 服务端口
      - "3306:3306"   # MySQL 端口
      - "443:443"     # HTTPS 端口（如需）
    volumes:
      - ./www:/opt/lampp/htdocs       # Web 根目录
      - ./mysql-data:/opt/lampp/var/mysql  # MySQL 数据
      - ./config/apache:/opt/lampp/etc/apache2  # 自定义 Apache 配置
      - ./config/php:/opt/lampp/etc/php.ini  # 自定义 PHP 配置
    restart: always  # 容器退出后自动重启
    environment:
      - MYSQL_ROOT_PASSWORD=root  # MySQL root 用户密码（默认空，建议设置）

启动服务：docker-compose up -d

核心配置说明

默认路径与端口

• Web 根目录：/opt/lampp/htdocs（可通过挂载自定义）
• MySQL 数据目录：/opt/lampp/var/mysql
• 默认端口：Apache (80)、MySQL (3306)、HTTPS (443)

环境变量

自定义配置

如需修改 Apache、PHP 或 MySQL 配置，可将本地配置文件挂载至容器对应路径：

• Apache 配置：/opt/lampp/etc/apache2
• PHP 配置：/opt/lampp/etc/php.ini
• MySQL 配置：/opt/lampp/etc/my.cnf

访问服务

• Web 服务：浏览器访问 http://localhost（或宿主机 IP）
• MySQL 连接：使用数据库工具（如 Navicat）连接 localhost:3306，用户 root，密码为设置的 MYSQL_ROOT_PASSWORD

注意事项

• 生产环境不建议直接使用该镜像，XAMPP 默认配置安全性较低，仅适用于开发/测试场景。
• 首次启动时，MySQL 数据库需初始化，可能需要等待数秒至分钟（视宿主机性能）。
• 如需修改 MySQL 密码，可进入容器执行 /opt/lampp/bin/mysqladmin -u root password "新密码"。