webhippie/php-apache

php-apache

https://github.com/dockhippie/php-apache/actions/workflows/docker.yml/badge.svg](https://github.com/dockhippie/php-apache/actions/workflows/docker.yml)

概述

这是基于 https://github.com/dockhippie/apache 运行 PHP 的 Docker 镜像，用于部署和运行 PHP 应用程序，提供灵活的配置选项和环境变量支持。

版本信息

有关可用版本，请查看 https://hub.docker.com/r/webhippie/php-apache/tags、Quay 或 https://github.com/dockhippie/php-apache 中的现有文件夹。

核心功能与特性

• 基于 Apache 服务器构建的 PHP 运行环境
• 支持 PHP 7 和 PHP 8 的自定义配置
• 提供丰富的 PHP 配置环境变量
• 支持卷挂载以持久化网站文件和配置
• 继承 Apache 和 Alpine 基础镜像的功能特性

使用场景

适用于需要运行 PHP 应用程序的各类场景：

• PHP Web 应用的开发与测试环境
• 生产环境中 PHP 应用的部署
• 需要自定义 PHP 配置的应用场景
• 快速搭建 PHP + Apache 运行环境

使用方法

基本运行

快速启动 PHP + Apache 容器：

bash
docker run -d -p 8080:8080 webhippie/php-apache

挂载网站目录

将本地网站文件目录挂载到容器中：

bash
docker run -d -p 8080:8080 -v /本地/www目录:/srv/www webhippie/php-apache

自定义 PHP 配置

通过环境变量修改 PHP 配置参数：

bash
docker run -d -p 8080:8080 \
  -e PHP_MEMORY_LIMIT=2G \
  -e PHP_DATE_TIMEZONE=Asia/Shanghai \
  -e PHP_POST_MAX_SIZE=5G \
  webhippie/php-apache

挂载自定义 PHP 配置文件

挂载 PHP 配置文件到对应版本的自定义配置目录：

bash
# PHP 7
docker run -d -p 8080:8080 -v /本地/php7配置:/etc/php7/custom.d webhippie/php-apache

# PHP 8
docker run -d -p 8080:8080 -v /本地/php8配置:/etc/php8/custom.d webhippie/php-apache

配置说明

卷

以下卷可用于数据持久化和自定义配置：

• /srv/www - 网站文件存放目录，用于挂载应用代码
• /etc/php7/custom.d - PHP 7 自定义配置目录，可放置 .ini 配置文件
• /etc/php8/custom.d - PHP 8 自定义配置目录，可放置 .ini 配置文件

端口

• 8080 - Apache 服务端口，用于访问 PHP 应用

可用环境变量

console
PHP_ALLOW_URL_FOPEN = On                # 是否允许打开 URL 形式的文件
PHP_ALLOW_URL_INCLUDE = Off             # 是否允许在 include/require 中使用 URL
PHP_COMPOSER_INSTALL = true             # 是否自动安装 Composer 依赖
PHP_COMPOSER_ROOT = ${APACHE_WEBROOT}   # Composer 安装根目录
PHP_DATE_TIMEZONE = UTC                 # 默认时区
PHP_DISPLAY_ERRORS = On                 # 是否显示错误信息
PHP_DISPLAY_STARTUP_ERRORS = On         # 是否显示启动时错误
PHP_ENABLE_DL = Off                     # 是否允许使用 dl() 函数
PHP_ERROR_LOG = /proc/self/fd/2         # 错误日志文件路径
PHP_ERROR_REPORTING = E_ALL & ~E_DEPRECATED & ~E_STRICT  # 错误报告级别
PHP_EXPOSE_HEADER = On                  # 是否暴露 X-Powered-By 头
PHP_HTML_ERRORS = On                    # 是否以 HTML 格式显示错误
PHP_IGNORE_REPEATED_ERRORS = Off        # 是否忽略重复错误
PHP_IGNORE_REPEATED_SOURCE = Off        # 是否忽略重复错误的来源
PHP_LOG_ERRORS = On                     # 是否记录错误日志
PHP_LOG_ERRORS_MAX_LEN = 1024           # 错误日志最大长度
PHP_MAX_EXECUTION_TIME = 3600           # 最大执行时间（秒）
PHP_MAX_FILE_UPLOADS = 20               # 最大上传文件数
PHP_MAX_INPUT_TIME = 3600               # 最大输入时间（秒）
PHP_MEMORY_LIMIT = 1G                   # 内存限制
PHP_OUTPUT_BUFFERING = 4096             # 输出缓冲区大小
PHP_POST_MAX_SIZE = 2G                  # POST 数据最大大小
PHP_REPORT_MEMLEAKS = On                # 是否报告内存泄漏
PHP_SKIP_TEMPLATES = false              # 是否跳过模板处理
PHP_TRACK_ERRORS = Off                  # 是否跟踪错误
PHP_UPLOAD_MAX_FILESIZE = 2G            # 上传文件最大大小

继承的环境变量

该镜像继承了以下基础镜像的环境变量：

• https://github.com/dockhippie/apache#available-environment-variables - Apache 服务相关环境变量
• https://github.com/dockhippie/alpine#available-environment-variables - Alpine 系统相关环境变量

贡献

Fork -> 提交补丁 -> 推送 -> 拉取请求

作者

• https://github.com/tboerger

许可证

MIT

版权信息

console
Copyright (c) 2015 Thomas Boerger <http://www.webhippie.de>