newdeveloper/apache-php

镜像概述和主要用途

本镜像基于Ubuntu系统构建，集成了Apache Web服务器和PHP8运行环境，预装了多种常用PHP扩展（如mysql、xml、zip、gd等），并配置了自定义Apache虚拟主机设置。镜像默认时区为欧洲/阿姆斯特丹，启用URL重写模块，支持.htaccess文件覆盖配置，文档根目录权限已优化，适用于快速部署需要Apache和PHP8环境的PHP Web项目。

核心功能和特性

• 基础环境：基于Ubuntu系统，包含Apache Web服务器和PHP8运行环境
• PHP扩展：预装php-mysql（MySQL数据库支持）、php-xml（XML处理）、php-zip（文件压缩/解压缩）、php-gd（图片处理）等常用扩展
• 时区配置：默认设置为欧洲/阿姆斯特丹时区（Europe/Amsterdam）
• Apache配置：
  • 自定义虚拟主机配置（000-default.conf），文档根目录为/var/www/html
  • 启用rewrite模块，支持URL重写
  • 允许.htaccess文件覆盖目录配置（AllowOverride All）
  • 禁止访问.ini文件，增强安全性
• 权限优化：文档根目录/var/www/html权限设置为www-data用户组，确保Web服务可访问
• 启动机制：通过run.sh脚本启动Apache，自动清理残留pid文件，确保容器正常运行

使用场景和适用范围

适用于需要Apache和PHP8运行环境的PHP Web项目部署，特别适合以下场景：

• 需要MySQL数据库连接的PHP应用
• 依赖XML处理、文件压缩/解压缩或图片处理功能的PHP项目
• 需要URL重写规则（如SEO友好URL）的Web应用
• 开发或生产环境中快速搭建PHP运行环境

使用方法和配置说明### 前提条件

使用本镜像前，需准备以下文件（与Dockerfile同目录）：

• src/：存放PHP项目源代码（将被复制到容器/var/www/html）
• settings/000-default.conf：Apache虚拟主机配置文件（如无需自定义可使用镜像内置配置）

构建镜像

在包含Dockerfile、src目录和settings目录的路径下执行：

bash
docker build -t apache-php8-ubuntu .

运行容器#### 基本运行命令

bash
docker run -d -p 8080:80 --name my-php-app apache-php8-ubuntu

• -p 8080:80：将容器80端口映射到主机8080端口
• --name my-php-app：指定容器名称为my-php-app

挂载项目代码（开发环境）

如需实时修改代码，可将本地项目目录挂载到容器/var/www/html：

bash
docker run -d -p 8080:80 -v /本地项目路径:/var/www/html --name my-php-app apache-php8-ubuntu

配置说明#### 环境变量

镜像定义了以下Apache相关环境变量（无需手动修改）：

• APACHE_RUN_USER=www-data：Apache运行用户
• APACHE_RUN_GROUP=www-data：Apache运行用户组
• APACHE_LOG_DIR=/var/log/apache2：日志目录
• APACHE_LOCK_DIR=/var/lock/apache2：锁文件目录
• APACHE_PID_FILE=/var/run/apache2.pid：PID文件路径

Apache配置

• 虚拟主机配置文件路径：/etc/apache2/sites-available/000-default.conf
• 核心配置项：
  • 文档根目录：/var/www/html
  • 错误日志：${APACHE_LOG_DIR}/error.log
  • 访问日志：${APACHE_LOG_DIR}/access.log
  • 目录权限：允许索引、跟随符号链接，支持.htaccess覆盖
  • 安全限制：禁止访问.ini文件（Deny from all）

时区修改

如需修改时区，可在Dockerfile中调整以下部分后重新构建：

dockerfile
ENV TZ "Asia/Shanghai"  # 修改为目标时区
RUN echo "Asia/Shanghai" > /etc/timezone \
  && dpkg-reconfigure --frontend noninteractive tzdata
RUN ln -fs /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

容器启动流程

1. 执行run.sh脚本，删除残留的Apache pid文件（/var/run/apache2/apache2.pid）
2. 通过apachectl -DFOREGROUND启动Apache，确保在前台运行（保持容器活跃）