antage/apache2-php5

apache2-php5 镜像文档

镜像概述和主要用途

基于 debian:jessie 的 Docker 镜像，集成 Apache 2.x Web 服务器和 mod_php 5.x 模块，用于部署和运行 PHP 5.x 应用程序。提供灵活的配置选项，支持通过环境变量自定义 Apache 和 PHP 参数，满足不同应用场景需求。

核心功能和特性

• 基于 debian:jessie 构建，稳定可靠
• 集成 Apache 2.x 和 mod_php 5.x，原生支持 PHP 5.x 应用运行
• 支持通过环境变量配置 Apache 核心参数（文档根目录、日志级别、连接数等）
• 提供 PHP 配置自定义（时区、内存限制、会话管理等）
• 支持卷挂载，实现数据持久化和日志管理
• 可集成 Newrelic 监控（通过专用环境变量配置）
• 支持日志重定向到标准输出，便于容器日志收集

使用场景和适用范围

适用于需要部署运行 PHP 5.x 应用程序的场景，尤其是依赖旧版 PHP 环境的 legacy 应用。可用于开发、测试或生产环境，支持快速配置以适应不同部署需求。

详细使用方法和配置说明

构建镜像

运行以下命令构建镜像：

bash
make

卷挂载

以下路径支持卷挂载，建议根据需求配置：

• /var/lib/php5/sessions：PHP 会话存储目录（推荐使用 tmpfs）
• /tmp/apache2-coredumps：Apache 核心转储文件目录（可选）
• /var/log/apache2：Apache 日志目录
• /var/www：网站根目录（存放应用代码）

暴露端口

容器暴露以下端口：

• 8080/tcp：Apache 服务端口

环境变量配置

Apache 相关环境变量

PHP 相关环境变量

必填变量

运行容器时必须定义以下环境变量：

• PHP_SMTP：MTA SMTP 服务器地址/主机名
• PHP_SMTP_FROM：邮件默认发件人地址

日志重定向到标准输出

要将 Apache 访问日志和错误日志重定向到标准输出，设置以下环境变量：

bash
-e APACHE_CUSTOMLOG='"|/bin/cat" combined' \
-e APACHE_ERRORLOG='"|/bin/cat"'

Docker 部署示例

基本运行命令

bash
docker run -d \
  -p 8080:8080 \
  -v /local/www:/var/www \
  -v /local/logs:/var/log/apache2 \
  -e PHP_SMTP=smtp.example.org \
  -e PHP_SMTP_FROM=noreply@example.org \
  -e APACHE_DOCUMENT_ROOT=/var/www \
  -e PHP_TIMEZONE=Asia/Shanghai \
  apache2-php5

带日志重定向的运行命令

bash
docker run -d \
  -p 8080:8080 \
  -v /local/www:/var/www \
  -e PHP_SMTP=smtp.example.org \
  -e PHP_SMTP_FROM=*** \
  -e APACHE_CUSTOMLOG='"|/bin/cat" combined' \
  -e APACHE_ERRORLOG='"|/bin/cat"' \
  -e PHP_MEMORY_LIMIT=2G \
  apache2-php5