PHP-GD-Apache 镜像文档

镜像概述

主要用途

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

核心功能和特性

1. 基础环境

   • 集成 PHP 运行时（默认基于官方稳定版本，如 8.1、8.2）及 Apache 2.4 服务器
   • 预装 GD 扩展（支持 JPEG、PNG、GIF、WBMP 等图像格式处理）

2. GD 扩展能力

   • 支持图像创建（如动态生成验证码、图表）、缩放、裁剪、旋转、水印添加
   • 支持像素级操作（颜色调整、滤镜效果）及文字渲染（TrueType 字体支持）

3. 易用性

   • 兼容 Apache 标准配置（.htaccess 支持、虚拟主机配置）
   • 支持 PHP 标准配置（php.ini 自定义）
   • 轻量级镜像，基于 Alpine 或 Debian 基础镜像（依 PHP 官方版本而定）

使用场景和适用范围

典型应用场景

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

适用范围

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

详细使用方法和配置说明

基本运行命令

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

# 基础运行（映射本地 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 管理多服务依赖（如搭配数据库）：

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，添加自定义参数：

  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 重写）：

  <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）。

配置参数与环境变量

常用环境变量

注意事项

1. 数据持久化

   • 本地代码目录需通过 volumes 挂载，避免容器重建导致代码丢失。
   • 敏感配置（如数据库密码）建议通过环境变量注入，而非硬编码在代码中。

2. 性能优化

   • 高并发场景建议调整 PHP_FPM_MAX_CHILDREN（若启用 PHP-FPM）或 Apache MaxRequestWorkers。
   • 图像处理任务（如大文件裁剪）需确保 PHP_MEMORY_LIMIT 足够（建议 ≥ 256M）。

3. 安全加固

   • 限制容器内用户权限，避免使用 root 运行 Apache。
   • 通过 .dockerignore 排除本地开发文件（如 .git、node_modules），减少镜像体积及安全风险。