antage/apache2-php7

apache2-php7

镜像概述和主要用途

基于debian:buster的Apache 2.x + mod_php 7.3 Docker镜像，用于运行PHP应用程序，提供可配置的Web服务器环境，支持通过环境变量自定义Apache和PHP参数。

核心功能和特性

• 基于debian:buster构建，系统稳定可靠
• 集成Apache 2.x和mod_php 7.3，原生支持PHP应用运行
• 提供灵活的环境变量配置，支持自定义Apache和PHP参数
• 预设多个卷挂载点，支持数据持久化、日志管理和会话存储
• 暴露8080端口，便于Web服务访问和端口映射

使用场景和适用范围

适用于需要Apache Web服务器与PHP 7.3环境的Web应用部署场景，包括但不限于：

• PHP网站和Web应用程序托管
• 遗留PHP项目的容器化部署
• 需要自定义Apache配置的PHP服务

构建方法

执行make命令即可构建镜像：

bash
make

卷挂载

以下目录建议通过卷挂载以实现数据持久化或配置自定义：

• /var/lib/php/sessions：PHP会话存储目录（推荐使用tmpfs提高性能）
• /tmp/apache2-coredumps：Apache核心转储文件目录（可选，用于故障排查）
• /var/log/apache2：Apache日志目录（建议挂载以保留访问日志和错误日志）
• /var/www：网站根目录（需挂载包含PHP应用代码的目录）

暴露端口

• 8080/tcp：Apache Web服务端口

环境变量

Apache配置变量

PHP配置变量

其他配置变量

• CREATE_USER_UID：创建用户的UID
• CREATE_USER_GID：创建用户的GID
• CREATE_SYMLINKS：创建符号链接，格式示例："/var/www/dir1>/var/dir1,/var/www/dir2>/var/dir2"

必填变量

运行容器时必须定义以下环境变量，否则容器无法正常启动：

• PHP_SMTP：MTA SMTP服务器的IP地址或主机名
• PHP_SMTP_FROM：邮件发送时使用的默认发件人地址

部署示例

docker run命令示例

bash
docker run -d \
  -p 8080:8080 \
  -v /path/to/local/www:/var/www \
  -v /path/to/local/logs:/var/log/apache2 \
  -v type=tmpfs,target=/var/lib/php/sessions \
  -e PHP_SMTP=smtp.example.com \
  -e PHP_SMTP_FROM=webmaster@example.com \
  -e APACHE_DOCUMENT_ROOT=/var/www/public \
  -e APACHE_ALLOW_OVERRIDE=All \
  -e PHP_TIMEZONE=Asia/Shanghai \
  --name apache2-php7-app \
  apache2-php7

docker-compose配置示例

yaml
version: '3.8'
services:
  apache2-php7:
    image: apache2-php7
    container_name: apache2-php7-app
    ports:
      - "8080:8080"
    volumes:
      - ./www:/var/www:rw
      - ./logs:/var/log/apache2:rw
      - type: tmpfs
        target: /var/lib/php/sessions
        tmpfs:
          size: 100M
    environment:
      - PHP_SMTP=smtp.example.com
      - PHP_SMTP_FROM=***
      - APACHE_SERVER_NAME=app.example.com
      - APACHE_DOCUMENT_ROOT=/var/www/html
      - APACHE_ALLOW_OVERRIDE=All
      - PHP_TIMEZONE=Asia/Shanghai
      - PHP_MBSTRING_FUNC_OVERLOAD=2
    restart: unless-stopped