webvariants/php

webvariants/php

镜像概述

本镜像提供多版本PHP运行环境，支持PHP 5.6及7.0-7.4系列版本，包含FPM、Alpine等变体，集成常用扩展并提供丰富的环境变量配置能力，满足不同场景下PHP应用的容器化需求。

核心功能

• 覆盖PHP 5.6、7.0-7.4版本，适配不同应用兼容性要求
• 支持通过环境变量自定义PHP扩展、php.ini参数及目录权限
• 集成xhgui性能分析工具，可追踪应用性能指标
• 提供定时任务（cron）配置选项，满足周期性任务需求
• 支持初始化目录创建、文件权限设置等自动化操作

使用场景

1. PHP应用的本地开发与调试
2. 多PHP版本兼容性测试
3. 生产环境PHP应用的容器化部署
4. PHP应用性能分析与优化

配置说明

标签（Tags）

• 7.4：PHP 7.4版本
• 7.4-fpm-alpine：PHP 7.4 FPM Alpine版本
• 7.3：PHP 7.3版本（安全支持截止2021年12月6日）
• 7.3-fpm-alpine：PHP7.3 FPM Alpine版本（安全支持截止2021年12月6日）
• 7.2：PHP7.2版本（安全支持截止2020年11月30日）
• 7.1：PHP7.1版本（安全支持截止2019年12月1日）
• 7.0：PHP7.0版本（已停止维护）
• 5.6：PHP5.6版本（已停止维护）

环境变量

• PHP_IMAGE_VERSION：设置为2启用最新模式，避免legacy模式
• WEB_ROOT：应用根目录，默认/app
• APP_DATA：应用数据目录，默认/app/data
• PHP_EXTENSIONS：需要启用的PHP扩展
• PHP_ZEND_EXTENSIONS：Zend扩展（多个用空格分隔，如xdebug.so）
• PHPINI_*：自定义php.ini参数（用__替换.，如PHPINI_XDEBUG__REMOTE_ENABLE=1对应xdebug.remote_enable=1）
• PHP_UPLOAD_MAX_FILESIZE：上传文件最大大小，默认64M
• MINICRON_CRONTAB：定时任务配置（如10 * * * * php cron.php）

xhgui配置

xhgui位于/xhgui，启用需设置：

• PHPINI_AUTO_PREPEND_FILE=/xhgui/header.php
• 可选环境变量：XHGUI_FULL_PROFILING（启用完整分析）、XHGUI_PROBABILITY（采样概率）等

部署示例

Docker Run示例

bash
docker run -d \
  -p 8080:80 \
  -v /本地应用目录:/app \
  -e PHP_EXTENSIONS="gd mysqli" \
  -e PHPINI_XDEBUG__REMOTE_ENABLE=1 \
  webvariants/php:7.4

Docker Compose示例

yaml
version: '3'
services:
  php:
    image: webvariants/php:7.4-fpm-alpine
    volumes:
      - ./app:/app
    environment:
      - WEB_ROOT=/app/public
      - PHP_UPLOAD_MAX_FILESIZE=128M
      - PHP_POST_MAX_SIZE=128M
    depends_on:
      - db
  db:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=app_db
    volumes:
      - db_data:/var/lib/mysql
volumes:
  db_data: