buluma/php-apache

PHP Apache容器（使用Ansible构建）

https://github.com/buluma/php-apache-container/actions/workflows/build.yml/badge.svg](https://github.com/buluma/php-apache-container/actions/workflows/build.yml)

镜像概述和主要用途

本项目由三部分核心组件构成：

• Ansible项目：维护于GitHub仓库 https://github.com/buluma/php-apache-container%EF%BC%8C%E6%89%80%E6%9C%89%E9%97%AE%E9%A2%98%E5%8F%8D%E9%A6%88%E5%92%8C%E6%94%AF%E6%8C%81%E8%AF%B7%E6%B1%82%E8%AF%B7%E6%8F%90%E4%BA%A4%E8%87%B3%E8%AF%A5%E4%BB%93%E5%BA%93%E3%80%82
• Docker Hub镜像：直接使用可从Docker Hub拉取 https://hub.docker.com/r/buluma/php-apache/ 镜像。
• Ansible角色：如需灵活适配传统服务器和容器化构建的Ansible角色，可使用Ansible Galaxy上的 geerlingguy.php（该角色负责PHP容器的核心管理工作）。

核心功能和特性

• 支持多版本PHP：涵盖PHP 7.1至8.0系列版本
• 基于Ansible构建，配置管理标准化
• 集成Apache服务器，开箱即可运行PHP应用
• 支持自定义代码挂载、配置文件覆盖
• 兼容Docker Compose部署

支持的版本

当前维护的PHP版本及对应标签：

• 8.0, 8.0.x, latest: PHP 8.0.x
• 7.4, 7.4.x: PHP 7.4.x
• 7.3, 7.3.x: PHP 7.3.x
• 7.2, 7.2.x: PHP 7.2.x
• 7.1, 7.1.x: PHP 7.1.x

使用场景和适用范围

• 快速搭建PHP开发环境
• 生产环境PHP应用容器化部署
• 需要多版本PHP测试的场景
• 基于Apache的PHP Web应用部署

详细使用方法和配置说明

独立使用

无需安装项目源码，直接使用Docker Hub镜像即可快速部署。

快速启动

bash
docker run -d --name=php-apache -p 80:80 buluma/php-apache:latest /usr/sbin/apache2ctl -D FOREGROUND

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: "3"

services:
  php-apache:
    image: buluma/php-apache:latest
    container_name: php-apache
    ports:
      - "80:80"
    restart: always
    # 卷配置参见"自定义PHP代码库"部分
    volumes: []

启动服务：

bash
docker-compose up -d

服务启动后，可通过 http://localhost/ 访问默认主页。

自定义PHP代码库

将本地代码目录（如./web）挂载到容器的/var/www/html目录：

Docker命令方式：

bash
docker run -d --name=php-apache -p 80:80 -v ./web:/var/www/html:rw,delegated buluma/php-apache:latest /usr/sbin/apache2ctl -D FOREGROUND

Docker Compose方式：

yaml
services:
  myapp:
    ...
    volumes:
      - ./web:/var/www/html:rw,delegated

如需构建生产环境镜像，可创建Dockerfile并将代码COPY到镜像中：

dockerfile
FROM buluma/php-apache:latest
COPY ./web /var/www/html

自定义配置

Apache虚拟主机配置：挂载自定义虚拟主机配置文件覆盖容器内配置：

yaml
services:
  myapp:
    ...
    volumes:
      - ./web:/var/www/html:rw,delegated
      - ./virtualhosts.conf:/etc/apache2/sites-enabled/vhosts.conf:rw

PHP配置：挂载自定义PHP配置文件（需根据使用的PHP版本调整路径）：

yaml
services:
  myapp:
    ...
    volumes:
      - ./php.ini:/etc/php/7.4/apache2/php.ini:rw  # 替换7.4为实际使用的PHP版本

使用Ansible管理

前提条件

构建和维护Docker镜像需安装：

• Docker Community Edition（支持Mac、Windows、Linux）
• Ansible

构建镜像

1. 安装Ansible角色依赖：

bash
ansible-galaxy install -r requirements.yml

2. 确保Docker服务运行，执行playbook构建容器：

bash
ansible-playbook --extra-vars="@vars/7.4.yml" main.yml  # 替换7.4为目标PHP版本

构建完成后，可通过docker images查看生成的php-apache镜像。

注意：如遇Failed to import docker错误，执行pip install docker安装依赖。

推送到Docker Hub

参考仓库中的.github/workflows/build.yml文件，配置自动推送机制，在master分支提交时自动推送所有标签镜像。

许可证

MIT / BSD

作者信息

本容器构建由 Michael Buluma 于2021年创建。