thebiggive/php

docker-php 镜像文档

1. 镜像概述与主要用途

docker-php 是一个基于 PHP + Apache 的基础 Docker 镜像，专为支持 Big Give 的 PHP + Slim 应用而设计。该镜像提供了稳定的运行环境，确保相关应用在开发、测试及生产环境中一致部署。

主要用途：作为 Big Give 旗下 PHP 应用的基础运行环境，目前已支持以下项目：

• https://github.com/thebiggive/mailer
• https://github.com/thebiggive/matchbot

基础环境：当前基于 PHP 8.0 版本构建。

2. 核心功能与特性

• 基础环境：集成 PHP 8.0 运行时与 Apache 服务器，满足 PHP 应用的基础运行需求。
• 框架支持：针对 Slim 框架优化，兼容 Big Give 的 PHP + Slim 应用架构。
• 环境一致性：统一开发、测试与生产环境的运行时配置，减少环境差异导致的问题。
• 轻量可靠：基于官方基础镜像构建，确保安全性与稳定性，适合生产环境部署。

3. 使用场景与适用范围

适用场景

• Big Give 旗下 PHP + Slim 应用（如 Mailer、MatchBot）的开发、测试与生产环境部署。
• 需要快速搭建 PHP 8.0 + Apache 运行环境的场景。

适用范围

• 开发团队：本地开发与测试环境的快速初始化。
• 运维团队：生产环境中标准化部署 PHP 应用。

4. 使用方法与配置说明

4.1 手动构建（本地测试）

如需在本地测试或自定义构建镜像，执行以下命令：

bash
# 克隆镜像仓库（假设已克隆，进入仓库目录）
cd docker-php

# 构建镜像，标签为 thebiggive/php
docker build -t thebiggive/php .

4.2 运行示例

4.2.1 基础运行（docker run）

使用构建好的镜像运行容器，暴露 80 端口（Apache 默认端口），并挂载 PHP 应用代码至 Apache 网站根目录（通常为 /var/www/html）：

bash
docker run -d -p 8080:80 \
  -v /path/to/your/php/app:/var/www/html \
  --name php-app-container \
  thebiggive/php

• -p 8080:80：将容器内 Apache 的 80 端口映射到宿主机的 8080 端口。
• -v /path/to/your/php/app:/var/www/html：挂载本地 PHP 应用代码到容器内 Apache 的网站根目录。
• --name：指定容器名称，便于管理。

4.2.2 Docker Compose 配置（示例）

创建 docker-compose.yml 文件，集成 PHP 应用与其他服务（如数据库）：

yaml
version: '3'

services:
  php-app:
    image: thebiggive/php
    build: .  # 如需本地构建，取消注释此行并删除 image 字段
    ports:
      - "8080:80"
    volumes:
      - ./app:/var/www/html  # 本地应用代码目录
    depends_on:
      - db  # 假设依赖数据库服务（如 MySQL）

  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: example
      MYSQL_DATABASE: app_db

4.3 镜像发布流程

官方镜像通过 Docker Hub 自动构建发布，流程如下：

1. 代码提交：将镜像相关修改（如 Dockerfile 更新）推送到仓库的 main 分支。
2. 自动构建：Docker Hub 监测到 main 分支更新后，触发自动构建流程（https://hub.docker.com/r/thebiggive/php/builds/%EF%BC%89%E3%80%82
3. 镜像可用：构建成功后，镜像将更新至 thebiggive/php 仓库，可供直接拉取使用。

4.4 配置说明

当前镜像未提供额外可配置环境变量或运行时参数。如需自定义 PHP 配置（如 php.ini 参数）、Apache 虚拟主机配置或扩展安装，可基于此镜像创建自定义 Dockerfile 进行扩展，示例：

dockerfile
# 基于 thebiggive/php 扩展
FROM thebiggive/php

# 安装额外 PHP 扩展（如 mysqli）
RUN docker-php-ext-install mysqli

# 自定义 php.ini 配置
COPY php.ini /usr/local/etc/php/

# 自定义 Apache 配置
COPY apache.conf /etc/apache2/sites-available/000-default.conf
RUN a2ensite 000-default.conf

5. 注意事项

• 镜像基于 PHP 8.0，如需更高版本 PHP，需关注官方仓库更新或自行扩展构建。
• 生产环境部署时，建议通过 Docker Compose 或容器编排工具（如 Kubernetes）管理，并配置持久化存储与健康检查。
• 应用代码需符合 Slim 框架规范，确保与 Apache 目录结构（如 /var/www/html）兼容。