sigblue/apache-php

Docker Apache PHP

https://github.com/marcochiodo/docker-apache-php

https://hub.docker.com/r/sigblue/apache-php

开发者：Marco Chiodo

镜像概述

Docker Apache PHP 镜像扩展自官方 php:*-apache 镜像，预安装了大多数常用PHP扩展，并提供 light、standard、full 三个版本以满足不同需求。该镜像简化了PHP Web应用的部署流程，内置优化的Apache配置，支持环境变量自定义端口，默认适配现代PHP框架的URL重写需求。

核心功能与特性

多版本选择

提供三个预配置版本，适配不同扩展需求：

• light：基础版本，包含核心扩展
• standard：标准版本，包含更多常用扩展
• full：完整版本，包含几乎所有主流扩展

预安装扩展

镜像已预装多数常用PHP扩展，以下扩展需通过 docker-php-ext-enable 命令或 php.ini 文件手动启用：

ini
extension=grpc.so
extension=imagick.so
extension=memcached.so
extension=mongodb.so
extension=protobuf.so
extension=redis.so

自定义Apache配置

• 端口灵活配置：自动将 Apache 配置文件 /etc/apache2/ports.conf 中的端口 80 替换为 ${PORT} 环境变量值，支持动态指定端口
• 默认虚拟主机配置：内置优化的虚拟主机配置，适配PHP框架（如Laravel、Symfony）的URL重写需求，配置如下：

apache
<VirtualHost *:${PORT}>
  DocumentRoot /var/www/html/public

  RewriteEngine On

  # 保留Authorization头信息
  RewriteCond %{HTTP:Authorization} ^(.*)
  RewriteRule .* - [e=HTTP_AUTHORIZATION:%1]

  # 前端路由重写规则
  <Directory /var/www/html/public > 
    RewriteCond %{REQUEST_FILENAME} -s [OR]
    RewriteCond %{REQUEST_FILENAME} -l [OR]
    RewriteCond %{REQUEST_FILENAME} -d
    RewriteRule ^.*$ - [NC,L]

    RewriteCond %{REQUEST_URI}::$1 ^(/.+)(.+)::\2$
    RewriteRule ^(.*) - [E=BASE:%1]
    RewriteRule ^(.*)$ %{ENV:BASE}index.php [NC,L]
  </Directory>

  # 目录权限配置
  <Directory /var/www/html > 
    Options Indexes FollowSymLinks
    AllowOverride None
    Require all granted
  </Directory>

  LogLevel notice
  ErrorLog ${APACHE_LOG_DIR}/error.log
  CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

使用场景

• 快速部署基于PHP的Web应用，如Laravel、Symfony、CodeIgniter等框架项目
• 需要常用PHP扩展（如Redis、MongoDB、Imagick）的应用场景
• 需自定义Apache端口或URL重写规则的PHP服务部署

使用方法与配置说明

1. 版本选择

拉取镜像时通过标签指定版本，默认标签为 latest（对应 standard 版本）：

bash
# light版本
docker pull docker.xuanyuan.run/sigblue/apache-php:latest-light

# standard版本（默认）
docker pull docker.xuanyuan.run/sigblue/apache-php:latest-standard

# full版本
docker pull docker.xuanyuan.run/sigblue/apache-php:latest-full

2. 启用扩展

部分扩展需手动启用，可通过以下两种方式：

方式一：在Dockerfile中使用docker-php-ext-enable

dockerfile
FROM docker.xuanyuan.run/sigblue/apache-php:latest-standard
RUN docker-php-ext-enable redis mongodb

方式二：挂载php.ini文件

在项目根目录创建 php.ini，添加扩展启用配置，并挂载到容器 /var/www/html 目录：

ini
; php.ini
extension=redis.so
extension=mongodb.so

3. 环境变量配置

• PORT：指定Apache监听端口（默认替换配置文件中的80端口），如 -e PORT=8080

4. 部署示例

基础运行示例

bash
docker run -d \
  -p 8080:8080 \
  -e PORT=8080 \
  -v $(pwd):/var/www/html \
  docker.xuanyuan.run/sigblue/apache-php:latest-standard

Docker Compose示例

yaml
# docker-compose.yml
version: '3'
services:
  php-app:
    image: docker.xuanyuan.run/sigblue/apache-php:latest-standard
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
    volumes:
      - ./:/var/www/html
      - ./php.ini:/var/www/html/php.ini  # 自定义php.ini
    restart: always

注意事项

• 应用代码需挂载到容器 /var/www/html 目录，框架项目的入口文件应放在 /var/www/html/public（默认DocumentRoot）
• 如需修改Apache配置，可通过挂载自定义虚拟主机配置文件到 /etc/apache2/sites-available/000-default.conf 覆盖默认配置