geerlingguy/php-apache

PHP Apache容器（使用Ansible构建）

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

本项目由三个主要部分组成：

• Ansible项目：该项目在GitHub上维护：https://github.com/geerlingguy/php-apache-container%E3%80%82%E9%97%AE%E9%A2%98%E5%8F%8D%E9%A6%88%E3%80%81%E6%94%AF%E6%8C%81%E8%AF%B7%E6%B1%82%E7%AD%89%E8%AF%B7%E6%8F%90%E4%BA%A4%E8%87%B3%E8%AF%A5GitHub%E4%BB%93%E5%BA%93%E3%80%82
• Docker Hub镜像：如果只需在项目中使用https://hub.docker.com/r/geerlingguy/php-apache/%EF%BC%8C%E5%8F%AF%E7%9B%B4%E6%8E%A5%E4%BB%8EDocker Hub拉取。
• Ansible角色：如需灵活的Ansible角色（兼容传统服务器和容器化构建），请查看Ansible Galaxy上的geerlingguy.php。（该Ansible角色是管理PHP容器的核心组件。）

版本

当前维护的版本包括：

• 8.3、8.3.x、latest：PHP 8.3.x
• 8.2、8.2.x：PHP 8.2.x
• 8.1、8.1.x：PHP 8.1.x

独立使用

如需使用Docker Hub上的geerlingguy/php-apache镜像，无需安装或使用本项目。可通过以下命令快速本地构建PHP容器：

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

也可将配置封装到Dockerfile和/或docker-compose.yml中以简化管理。例如：

yaml
version: "3"

services:
  php-apache:
    image: geerlingguy/php-apache:latest
    container_name: php-apache
    ports:
      - "80:80"
    restart: always
    # 有关卷的说明，请参见“自定义PHP代码库”部分。
    volumes: []

然后运行：

bash
docker-compose up -d

现在可通过http://localhost/访问默认主页。

自定义PHP代码库

若本地有web文件夹中的代码库，可通过卷挂载：-v ./web:/var/www/html:rw,delegated。

使用Docker Compose文件时：

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

如需基于此镜像构建生产环境镜像，可创建Dockerfile并通过COPY指令将webroot复制到镜像中。

若需运行多个webroot或自定义Apache虚拟主机配置，可挂载配置文件覆盖容器内的默认配置，例如：

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

类似地，可挂载PHP配置文件到路径/etc/php/8.3/apache2/php.ini（根据使用的PHP版本替换路径中的版本号）。

使用Ansible管理

前提条件

使用本项目构建和维护Docker PHP镜像前，需安装：

• Docker Community Edition（适用于Mac、Windows或Linux）
• Ansible

构建镜像

首先安装Ansible角色依赖：

bash
ansible-galaxy install -r requirements.yml

确保Docker运行后，执行playbook构建容器：

bash
ansible-playbook --extra-vars="@vars/8.2.yml" main.yml

（将vars路径中的版本号替换为所需的支持版本）构建完成后，运行docker images可查看生成的php-apache镜像。

注意：若出现Failed to import docker错误，运行pip install docker解决。

推送到Docker Hub

有关自动推送所有标签镜像的方法，参见本仓库中的.github/workflows/build.yml文件（master分支提交时自动触发）。

许可证

MIT / BSD

作者信息

本容器构建项目由Jeff Geerling于2018年创建，他也是《Ansible for DevOps》的作者。