foorschtbar/php-webserver

php-webserver - PHP Web服务器镜像

这是官方php:* -apache Docker镜像的增强版本，提供更多实用功能和扩展支持。

• GitHub: https://github.com/foorschtbar/php-webserver
• Docker Hub: https://hub.docker.com/r/foorschtbar/php-webserver

核心功能与改进

相比官方镜像，本镜像具有以下增强：

• PHP扩展：已预安装mysqli、mysql_pdo、imap、soap、imagick、yaml和op_cache
• Apache模块：包含mod_rewrite、mod_headers、mod_remoteip
• 支持在反向代理环境下使用
• 内置Composer依赖管理工具
• 提供Python 3支持（通过特定标签版本）

标签与版本说明

适用场景

适用于需要额外PHP扩展和Apache模块的Web应用，特别适合：

• 需要与MySQL数据库交互的PHP应用
• 需处理图像、使用SOAP服务或IMAP邮件协议的应用
• 在反向代理（如Nginx、Traefik）后运行的Web服务
• 需要Composer管理依赖的PHP项目
• 需集成Python脚本的混合环境应用

使用方法与配置

Docker Compose配置示例

yml
services:
  web:
    image: foorschtbar/php-webserver
    container_name: <changeme>-web  # 替换为自定义容器名称
    hostname: <changeme>  # 替换为自定义主机名
    restart: unless-stopped
    volumes:
      - ./data/web:/var/www/html/public  # 挂载本地Web文件到容器文档根目录
    environment:
      - "UID=1000"  # 运行服务的用户UID（默认1000）
      - "GID=1000"  # 运行服务的用户GID（默认1000）
    labels:
      - "com.centurylinklabs.watchtower.enable=true"  # 启用Watchtower自动更新
      - "traefik.enable=true"  # 启用Traefik反向代理
      # Traefik路由配置
      - "traefik.http.routers.<changeme>.entrypoints=https"
      - "traefik.http.routers.<changeme>.rule=Host(`<changeme>`)"  # 替换为实际域名
      - "traefik.http.routers.<changeme>.tls.certresolver=le"
      # Traefik服务配置
      - "traefik.http.services.<changeme>.loadbalancer.server.scheme=http"
      - "traefik.http.services.<changeme>.loadbalancer.server.port=80"
    networks:
      - internal  # 内部服务通信网络
      - reverse-proxy  # 反向代理网络
    depends_on:
      - db  # 依赖数据库服务

  db:
    image: mariadb
    command: --transaction-isolation=READ-COMMITTED --binlog-format=ROW
    restart: unless-stopped
    container_name: <changeme>-db  # 替换为数据库容器名称
    volumes:
      - ./data/db:/var/lib/mysql  # 数据库数据持久化
    environment:
      - MYSQL_ROOT_PASSWORD=<changeme>  # 数据库root密码
      - MYSQL_PASSWORD=<changeme>  # 应用数据库用户密码
      - MYSQL_DATABASE=<changeme>  # 应用数据库名称
      - MYSQL_USER=<changeme>  # 应用数据库用户名
    networks:
      - internal  # 仅加入内部网络
    ports:
      - 127.0.0.1:<changeme>:3306  # 本地端口映射（替换为自定义端口）
    labels:
      - "com.centurylinklabs.watchtower.enable=true"  # 启用数据库自动更新

networks:
  internal:
    external: false  # 内部网络（自动创建）
  reverse-proxy:
    external: true  # 反向代理网络（需提前创建）

关键配置说明

• 镜像选择：根据PHP版本需求和Python支持选择标签，如需要Python环境可使用python或8.4-python标签
• 文件挂载：Web应用文件需挂载到/var/www/html/public目录，该路径为Apache文档根目录
• 权限控制：通过UID和GID环境变量设置运行用户ID，避免容器内文件权限与宿主机冲突
• 网络隔离：建议使用内部网络隔离应用服务，仅通过反向代理网络对外暴露服务
• 依赖管理：容器内置Composer，可通过docker exec命令执行依赖安装：docker exec -it <容器名> composer install