qonstrukt/php

镜像概述和主要用途

本镜像基于Ubuntu 22.04 LTS构建，是一套开发者友好的通用PHP Docker解决方案。旨在提供灵活、可配置的PHP运行环境，支持x86_64和ARM64架构，可在Linux、Windows和MacOS系统稳定运行。通过多样化的类型和变体设计，满足从开发到生产环境的不同需求，同时解决Docker环境中常见的文件权限问题。

核心功能和特性

• 灵活配置管理：通过环境变量启用/禁用PHP扩展及修改php.ini设置，无需手动编辑配置文件
• 两种镜像类型：
  • slim：无预加载扩展，适合需要最小化镜像体积的场景
  • fat：内置大多数常见PHP扩展，开箱即用
• 三种运行变体：
  • CLI：命令行接口，适用于脚本执行和任务处理
  • apache：集成Apache服务器，直接提供Web服务
  • fpm：FastCGI进程管理器，适用于配合Nginx等反向代理使用
• 增强工具集成：
  • fat镜像捆绑Supercronic（Cron兼容任务运行器），支持通过环境变量配置定时任务
  • fat镜像预装Composer，便于PHP依赖管理
• NodeJS支持：所有变体可通过添加-node标签包含NodeJS，满足静态资源构建需求
• 权限优化：专门设计以减少Docker环境中常见的文件权限冲突问题
• 跨平台兼容：在Linux、Windows和MacOS系统经过严格测试
• 多架构支持：提供x86_64和ARM64架构镜像，适配不同硬件环境

使用场景和适用范围

• 开发环境：快速搭建可定制的PHP开发环境，通过环境变量灵活调整扩展和配置
• 生产部署：根据需求选择slim（轻量）或fat（全功能）类型，配合apache或fpm变体部署Web应用
• 任务调度：使用fat镜像的Supercronic功能运行定时任务（如数据备份、日志清理）
• 静态资源构建：选择带NodeJS的变体，满足前端资源构建（如Vue、React项目）需求
• 多架构部署：支持x86_64服务器和ARM64设备（如Apple Silicon、树莓派）部署

详细使用方法和配置说明

基础使用示例

1. CLI变体（命令行执行）

bash
# 查看PHP版本
docker run --rm -it docker.xuanyuan.run/my-php-image:latest-cli php -v

# 执行PHP脚本
docker run --rm -v $(pwd):/app docker.xuanyuan.run/my-php-image:latest-cli php /app/script.php

2. Apache变体（Web服务）

bash
# 启动Apache服务并映射8080端口
docker run -p 8080:80 -v $(pwd):/var/www/html docker.xuanyuan.run/my-php-image:latest-apache

访问 http://localhost:8080 即可查看Web应用

3. FPM变体（配合Nginx）

典型docker-compose配置示例：

yaml
version: '3'
services:
  php-fpm:
    image: docker.xuanyuan.run/my-php-image:latest-fpm
    volumes:
      - ./app:/var/www/html
    environment:
      - PHP_EXTENSIONS="pdo_mysql redis"
      - PHP_INI_memory_limit="512M"

  nginx:
    image: docker.xuanyuan.run/nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./app:/var/www/html
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - php-fpm

高级配置说明

启用/禁用PHP扩展

通过PHP_EXTENSIONS环境变量指定需要加载的扩展（空格分隔多个扩展）：

bash
docker run -e PHP_EXTENSIONS="mysqli pdo_mysql redis gd" docker.xuanyuan.run/my-php-image:latest-apache

修改php.ini设置

使用PHP_INI_前缀的环境变量直接修改PHP配置，格式为PHP_INI_<配置项名>=<值>：

bash
docker run -e PHP_INI_memory_limit="256M" \
           -e PHP_INI_upload_max_filesize="10M" \
           -e PHP_INI_post_max_size="15M" \
           docker.xuanyuan.run/my-php-image:latest-apache

配置Cron任务（仅fat镜像）

通过CRON_TASKS环境变量配置定时任务，多个任务用|分隔，格式为标准Cron表达式+命令：

bash
docker run -e CRON_TASKS="* * * * * echo '每分钟执行' >> /var/log/cron.log | 0 3 * * * php /var/www/html/backup.php" \
           docker.xuanyuan.run/my-php-image:latest-fat-cli

包含NodeJS环境

在镜像标签中添加-node后缀即可使用包含NodeJS的版本：

bash
# 使用带NodeJS的apache变体
docker run docker.xuanyuan.run/my-php-image:latest-apache-node

# 验证NodeJS安装
docker run --rm docker.xuanyuan.run/my-php-image:latest-cli-node node -v