PHP-GD-Apache 镜像文档

镜像概述

主要用途

本镜像基于 PHP ***镜像构建，集成 Apache Web 服务器与 GD 图形库扩展，提供开箱即用的 PHP 运行环境，适用于需要服务端图像处理能力的 Web 应用场景。

核心功能和特性

基础环境
- 集成 PHP 运行时（默认基于***稳定版本，如 8.1、8.2）及 Apache 2.4 服务器
- 预装 GD 扩展（支持 JPEG、PNG、GIF、WBMP 等图像格式处理）
GD 扩展能力
- 支持图像创建（如动态生成验证码、图表）、缩放、裁剪、旋转、水印添加
- 支持像素级操作（颜色调整、滤镜效果）及文字渲染（TrueType 字体支持）
易用性
- 兼容 Apache 标准配置（.htaccess 支持、虚拟主机配置）
- 支持 PHP 标准配置（php.ini 自定义）
- 轻量级镜像，基于 Alpine 或 Debian 基础镜像（依 PHP ***版本而定）

使用场景和适用范围

典型应用场景

动态图像生成：验证码、统计图表、动态水印生成
用户上传图像处理：头像裁剪、图片格式转换、缩略图生成
内容管理系统（CMS）：如 WordPress、Drupal 等需图片处理的 CMS 平台
小型电商/博客：需处理商品图片、文章封面图的场景

适用范围

个人博客、企业官网、内部管理系统等中小型 PHP 应用
开发环境快速搭建（本地调试、CI/CD 流程集成）

详细使用方法和配置说明

基本运行命令

通过 docker run 快速启动容器，挂载本地代码目录并映射端口：

bash
# 基础运行（映射本地 8080 端口到容器 80 端口，挂载当前目录代码）
docker run -d \
  -p 8080:80 \
  -v $(pwd):/var/www/html \
  --name php-gd-app \
  php-gd-apache

参数说明：

-p 8080:80：将容器 Apache 服务端口 80 映射到本地 8080 端口
-v $(pwd):/var/www/html：挂载本地当前目录到容器 Apache 默认网站根目录
--name：指定容器名称（可选）

Docker Compose 配置示例

通过 docker-compose.yml 管理多服务依赖（如搭配数据库）：

yaml
version: '3.8'
services:
  web:
    image: php-gd-apache
    ports:
      - "80:80"  # 直接映射宿主机 80 端口（需 root 权限）
    volumes:
      - ./src:/var/www/html  # 本地代码目录
      - ./config/php.ini:/usr/local/etc/php/php.ini  # 自定义 php.ini
      - ./config/apache2.conf:/etc/apache2/apache2.conf  # 自定义 Apache 配置
    environment:
      - PHP_MEMORY_LIMIT=256M  # PHP 内存限制
      - UPLOAD_MAX_FILESIZE=20M  # 上传文件大小限制
      - APACHE_SERVER_NAME=example.com  # Apache 服务器名称
    restart: unless-stopped  # 容器退出时自动重启（非手动停止）

自定义配置

1. 自定义 PHP 配置

通过挂载 php.ini 文件覆盖默认配置：

本地创建 config/php.ini，添加自定义参数：

ini
memory_limit = 256M
upload_max_filesize = 20M
post_max_size = 25M
date.timezone = Asia/Shanghai

在 docker run 或 docker-compose 中挂载该文件至容器的 PHP 配置目录（默认路径：/usr/local/etc/php/php.ini）。

2. 自定义 Apache 配置

修改 Apache 虚拟主机或模块配置：

本地创建 config/apache2.conf 或 .htaccess 文件，添加规则（如 URL 重写）：

apache
<VirtualHost *:80>
    ServerName example.com
    DocumentRoot /var/www/html/public
    <Directory /var/www/html/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

挂载至容器的 Apache 配置目录（默认路径：/etc/apache2/apache2.conf 或 /var/www/html/.htaccess）。

配置参数与环境变量

常用环境变量

环境变量名	说明	默认值
`PHP_MEMORY_LIMIT`	PHP 内存限制	`128M`
`UPLOAD_MAX_FILESIZE`	单文件上传大小限制	`2M`
`POST_MAX_SIZE`	POST 数据总大小限制	`8M`
`DATE_TIMEZONE`	PHP 时区配置	`UTC`
`APACHE_SERVER_NAME`	Apache 服务器域名	`localhost`
`APACHE_RUN_USER`	Apache 进程运行用户	`www-data`

注意事项

数据持久化
- 本地代码目录需通过 volumes 挂载，避免容器重建导致代码丢失。
- 敏感配置（如数据库密码）建议通过环境变量注入，而非硬编码在代码中。
性能优化
- 高并发场景建议调整 PHP_FPM_MAX_CHILDREN（若启用 PHP-FPM）或 Apache MaxRequestWorkers。
- 图像处理任务（如大文件裁剪）需确保 PHP_MEMORY_LIMIT 足够（建议 ≥ 256M）。
安全加固
- 限制容器内用户权限，避免使用 root 运行 Apache。
- 通过 .dockerignore 排除本地开发文件（如 .git、node_modules），减少镜像体积及安全风险。