bfren/apache-php

Docker Apache PHP

https://hub.docker.com/r/bfren/apache-php - https://github.com/bfren/docker

文档和使用指南

镜像概述和主要用途

Docker Apache PHP镜像为Apache2与PHP的组合镜像，支持PHP 5.6、7.4、8.0、8.1及8.2版本。该镜像不包含SSL支持，专为在代理服务器后方运行设计，安装了最小化的PHP核心组件，确保轻量级部署和高效运行。

核心功能和特性

• 多PHP版本支持：兼容PHP 5.6至8.2主流版本，满足不同PHP应用的版本需求。
• 精简设计：无SSL功能模块，减少不必要依赖，降低镜像体积。
• 最小化PHP包：仅包含核心运行组件，具体包括：
  • php：PHP基础运行环境
  • php-apache2：Apache2与PHP的集成模块
  • php-common：PHP通用组件
  • php-session：PHP会话管理模块
• 代理友好：优化用于代理服务器后方部署，可通过前端代理实现SSL终结、负载均衡等功能。

使用场景和适用范围

• 需在代理服务器（如Nginx、HAProxy）后方运行的PHP应用，由代理处理SSL、域名路由等功能。
• 轻量级PHP应用部署，对PHP扩展依赖较少的场景（如简单网站、API服务）。
• 开发或测试环境中需要快速切换不同PHP版本的场景。

使用方法和配置说明

获取镜像

从Docker Hub拉取最新版本或指定PHP版本：

bash
# 拉取最新版本
docker pull docker.xuanyuan.run/bfren/apache-php:latest

# 拉取指定PHP版本（如PHP 8.2）
docker pull docker.xuanyuan.run/bfren/apache-php:8.2

基本运行示例

将本地PHP应用代码挂载到容器内Apache默认网站目录（/var/www/html）：

bash
docker run -d \
  -p 8080:80 \  # 映射容器80端口到主机8080端口（仅HTTP）
  -v $(pwd)/app:/var/www/html \  # 挂载本地应用代码
  --name apache-php-app \
  bfren/apache-php:latest

自定义配置

如需修改Apache配置，可通过挂载自定义配置文件覆盖默认配置：

bash
docker run -d \
  -p 8080:80 \
  -v $(pwd)/app:/var/www/html \
  -v $(pwd)/custom-apache.conf:/etc/apache2/apache2.conf \  # 挂载自定义Apache配置
  bfren/apache-php:latest

配合代理服务器使用

建议前端部署Nginx作为反向代理，处理SSL并转发请求至该镜像容器：

nginx
# Nginx代理配置示例
server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://apache-php-app:80;  # 转发至容器80端口
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

许可证

MIT

版权

Copyright (c) 2020-2023 bfren (除非另有说明)