keopx/apache-php

Docker镜像文档

镜像概述

本镜像基于Debian 10 Buster构建，集成Apache 2.4 Web服务器，并支持PHP 7.4、7.3、7.2、7.1、7.0及5.6多个版本。采用新模板系统实现配置的灵活定制，默认配置针对开发环境优化，不建议直接用于生产环境。

核心功能与特性

• 多PHP版本支持：兼容PHP 5.6至7.4各版本，满足不同应用的运行需求
• 灵活配置系统：通过环境变量定制PHP、XDEBUG、sSMTP及Apache虚拟主机配置
• 开发工具集成：内置XDEBUG调试工具，支持远程调试和代码分析
• 邮件发送支持：集成sSMTP服务，可通过环境变量配置邮件发送路径和域名
• 模板化配置：基于模板文件动态生成php.ini、xdebug.ini等配置文件

使用场景与适用范围

适用于PHP应用的开发和测试环境，尤其适合需要在不同PHP版本间切换的开发场景。默认配置开启错误显示、调试模式等开发特性，不满足生产环境的安全和性能要求，请勿直接用于生产环境。

使用方法与配置说明

环境变量配置

.env文件设置

通过.env文件定义基础环境变量，例如启用XDEBUG：

ini
XDEBUG_ENABLED=1

docker-compose.yml配置

在docker-compose.yml中添加环境变量配置：

yml
environment:
  ## Web根目录，如Drupal脚手架可设为/web
  - WEB_ROOT
  ## SSH支持，如需启用需同时取消volumes中的# - ${SSH_AUTH_SOCK}:/ssh-agent注释
  - SSH_AUTH_SOCK=/ssh-agent
  ### 警告：仅在不使用自定义php.ini时使用
  - PHP_SENDMAIL_PATH
  - PHP_SENDMAIL_DOMAIN
  - XDEBUG_ENABLED

详细配置参数

PHP配置

基于php.ini-development文件，各PHP版本默认配置如下：

PHP XDEBUG配置

sSMTP配置

Apache虚拟主机配置

模板配置文件

php.ini模板

基于php.ini-development，通过环境变量动态生成：

ini
[PHP]
expose_php = {{ getenv "PHP_EXPOSE" "On" }}
error_reporting = {{ getenv "PHP_ERROR_REPORTING" "E_ALL" }}
display_errors = {{ getenv "PHP_DISPLAY_ERRORS" "On" }}
display_startup_errors = {{ getenv "PHP_DISPLAY_STARTUP_ERRORS" "On" }}
log_errors = {{ getenv "PHP_LOG_ERRORS" "On" }}
log_errors_max_len = {{ getenv "PHP_LOG_ERRORS_MAX_LEN" "1024" }}

max_execution_time = {{ getenv "PHP_MAX_EXECUTION_TIME" "30" }}
max_input_time = {{ getenv "PHP_MAX_INPUT_TIME" "60" }}
max_input_vars = {{ getenv "PHP_MAX_INPUT_VARS" "2000" }}
post_max_size = {{ getenv "PHP_POST_MAX_SIZE" "8M" }}
upload_max_filesize = {{ getenv "PHP_UPLOAD_MAX_FILESIZE" "2M" }}
max_file_uploads = {{ getenv "PHP_MAX_FILE_UPLOADS" "20" }}
memory_limit = {{ getenv "PHP_MEMORY_LIMIT" "128M" }}

[Date]
date.timezone = {{ getenv "PHP_DATE_TIMEZONE" "Europe/Berlin"}}

[Assertion]
zend.assertions = {{ getenv "PHP_ZEND_ASSERTIONS" "1" }}

[mail function]
sendmail_path = {{ getenv "PHP_SENDMAIL_PATH" "/usr/sbin/ssmtp -t" }}

[Xdebug]
xdebug.remote_host = {{ getenv "XDEBUG_HOST" "localhost" }}

xdebug.ini模板

ini
xdebug.default_enable = {{ getenv "XDEBUG_ENABLED" "1" }}
xdebug.remote_connect_back = {{ getenv "XDEBUG_REMOTE_CONNECT_BACK" "1" }}
xdebug.remote_autostart = {{ getenv "XDEBUG_REMOTE_AUTOSTART" "1" }}
xdebug.remote_enable = {{ getenv "XDEBUG_REMOTE_ENABLE" "1" }}
xdebug.remote_host = {{ getenv "XDEBUG_HOST" "localhost" }}
xdebug.remote_port = {{ getenv "XDEBUG_REMOTE_PORT" "9000" }}
xdebug.max_nesting_level = {{ getenv "XDEBUG_MAX_NESTING_LEVEL" "500" }}
xdebug.idekey = {{ getenv "XDEBUG_IDEKEY" "PHPSTORM" }}
xdebug.profiler_enable_trigger = {{ getenv "XDEBUG_PROFILER_ENABLE_TRIGGER" "1" }}
xdebug.show_error_trace = {{ getenv "XDEBUG_SHOW_ERROR_TRACE" "1" }}

sSMTP配置模板

ini
mailhub={{ getenv "PHP_SENDMAIL_DOMAIN" "true" }}

Apache虚拟主机模板

ini
DocumentRoot {{ getenv "DEFAULT_ROOT" "/var/www/html" }}{{ getenv "WEB_ROOT" "" }}
ServerName {{ getenv "APACHE_SERVER_NAME" "localhost" }}

部署示例

docker-compose.yml示例

yml
version: '3'

services:
  php-apache:
    image: [镜像名称]
    ports:
      - "80:80"
    volumes:
      - ./your-app:/var/www/html
      # 如需SSH支持，取消下一行注释
      # - ${SSH_AUTH_SOCK}:/ssh-agent
    environment:
      - WEB_ROOT=/web  # 如Drupal应用的web根目录
      - SSH_AUTH_SOCK=/ssh-agent
      - PHP_MEMORY_LIMIT=256M  # 自定义PHP内存限制
      - XDEBUG_ENABLED=1  # 启用XDEBUG
      - APACHE_SERVER_NAME=myapp.local  # 自定义服务器名称

启动命令

bash
# 创建.env文件
echo "XDEBUG_ENABLED=1" > .env

# 启动服务
docker-compose up -d