omegaup/php Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

omegaup.com PHP容器镜像文档

镜像概述

本镜像为omegaup.com平台专用的PHP运行容器，旨在为该在线编程竞赛平台提供稳定、兼容的PHP运行环境。镜像基于特定版本的PHP构建，预配置了运行omegaup.com应用所需的扩展、依赖及环境参数，确保与平台代码无缝集成。

核心功能与特性

• 专用环境适配：针对omegaup.com平台的代码特性优化，确保PHP版本及扩展与应用完全兼容
• 预安装依赖：包含运行omegaup.com所需的PHP扩展（如mysqli、curl、json、gd、mbstring等）
• 配置优化：内置针对生产环境的PHP配置参数（如内存限制、执行时间、缓存设置等）
• 多环境支持：可通过环境变量切换开发/测试/生产模式，满足不同部署场景需求
• 轻量级设计：基于官方PHP镜像精简构建，减少冗余依赖，提升运行效率

使用场景

• 生产环境部署：运行omegaup.com平台的PHP后端服务，处理用户访问、竞赛管理、代码提交等核心业务
• 开发环境搭建：供开发人员本地调试omegaup.com代码，无需手动配置PHP环境及依赖
• 测试环境验证：在CI/CD流程中作为测试容器，验证代码变更对PHP运行环境的兼容性

使用方法与配置说明

基础运行命令

通过docker run直接启动容器，需挂载omegaup.com代码目录并配置必要参数：

bash
docker run -d \
  --name omegaup-php \
  -v /path/to/omegaup/code:/var/www/html \
  -p 9000:9000 \
  -e PHP_ENV=production \
  -e DB_HOST=mysql-host \
  -e DB_USER=omegaup \
  -e DB_PASSWORD=your-password \
  -e DB_NAME=omegaup \
  omegaup/php

参数说明：

• -v /path/to/omegaup/code:/var/www/html：挂载omegaup.com的PHP代码目录到容器内web根目录
• -p 9000:9000：暴露PHP-FPM端口（若使用FPM模式），供Web服务器（如Nginx）反向代理
• -e PHP_ENV：指定运行环境，可选值：production（默认）、development、testing
• -e DB_*：数据库连接参数，需与omegaup平台的数据库配置匹配

Docker Compose配置示例

在多容器部署场景（如配合Nginx、MySQL）中，可使用docker-compose.yml统一管理：

yaml
version: '3'
services:
  php:
    image: omegaup/php
    container_name: omegaup-php
    volumes:
      - ./omegaup-code:/var/www/html
      - ./php-config:/usr/local/etc/php/conf.d  # 自定义PHP配置覆盖
    environment:
      - PHP_ENV=production
      - DB_HOST=mysql
      - DB_USER=omegaup
      - DB_PASSWORD=secure-password
      - DB_NAME=omegaup
      - PHP_MEMORY_LIMIT=512M
      - PHP_MAX_EXECUTION_TIME=300
    depends_on:
      - mysql
    restart: unless-stopped

  mysql:
    image: mysql:8.0
    container_name: omegaup-mysql
    volumes:
      - mysql-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=root-password
      - MYSQL_DATABASE=omegaup
      - MYSQL_USER=omegaup
      - MYSQL_PASSWORD=secure-password
    restart: unless-stopped

  nginx:
    image: nginx:alpine
    container_name: omegaup-nginx
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx-conf:/etc/nginx/conf.d
      - /path/to/omegaup/code:/var/www/html
      - ./ssl:/etc/nginx/ssl
    depends_on:
      - php
    restart: unless-stopped

volumes:
  mysql-data:

环境变量配置

容器支持以下关键环境变量自定义配置：

自定义配置

如需覆盖默认PHP配置，可通过挂载配置文件实现：

• 将自定义.ini配置文件（如custom.ini）放置于宿主机目录（如./php-config）
• 在docker run或docker-compose中挂载该目录到容器内PHP配置目录：-v ./php-config:/usr/local/etc/php/conf.d

示例custom.ini内容：

ini
upload_max_filesize = 64M
post_max_size = 64M
max_input_vars = 5000

注意事项

• 确保挂载的omegaup.com代码版本与容器PHP版本兼容（具体支持的PHP版本请参考镜像标签）
• 生产环境中需配置SSL证书（通过Nginx等Web服务器实现），并设置PHP_ENV=production以启用安全配置
• 数据库连接参数需与实际部署的数据库服务匹配，首次启动前需确保数据库已初始化（可通过omegaup提供的初始化脚本完成）
• 容器日志默认输出到stdout，可通过Docker日志驱动配置持久化或集中管理日志