sparkpos/docker-nginx-php

sparkpos/docker-nginx-php 镜像文档

概述

该Docker镜像整合了nginx和php-fpm服务，提供针对Drupal、Laravel等常见PHP应用的预定义nginx配置，旨在简化PHP应用的部署流程，减少配置复杂度。

核心功能和特性

• 整合nginx和php-fpm于单一镜像，无需单独部署两个服务
• 内置针对Drupal、Laravel的预定义nginx配置
• 支持通过环境变量自定义多种配置参数（PHP内存限制、上传文件大小、nginx工作进程数等）
• 内置cron支持，包含默认Drupal定时任务
• 轻量级Alpine基础镜像，减小镜像体积

使用场景和适用范围

适用于需要快速部署Drupal、Laravel等PHP应用的开发或生产环境，尤其适合：

• 快速原型开发和测试
• 简化的PHP应用部署流程
• 需要统一管理nginx和php-fpm配置的场景

使用方法和配置说明

快速启动示例

Drupal应用

bash
# 基本Drupal运行
docker run -d -p 8080:80 -v /本地Drupal代码路径:/var/www/html -e APP=drupal sparkpos/docker-nginx-php:7.4-alpine

# 指定Drupal web根目录（适用于compose初始化的项目）
docker run -d -p 8080:80 -v /本地Drupal代码路径:/var/www/html -e APP=drupal -e DRUPAL_WEB_ROOT=web sparkpos/docker-nginx-php:7.4-alpine

Laravel应用

bash
docker run -d -p 8080:80 -v /本地Laravel代码路径:/var/www/html -e APP=laravel sparkpos/docker-nginx-php:7.4-alpine

Docker Compose示例

完整示例文件请参见 https://github.com/sparkpos/docker-nginx-php/blob/master/docker-compose-example.yml

环境变量配置

通用配置

PHP & PHP-FPM配置

Cron支持

• 提供默认Drupal定时任务，每日运行
• 如需自定义cron命令，可通过Docker卷挂载到以下目录：

  /etc/periodic/min
  /etc/periodic/15min
  /etc/periodic/hourly
  /etc/periodic/daily
  /etc/periodic/weekly
  /etc/periodic/monthly
  

• 详细信息参见 https://github.com/sparkpos/docker-nginx-php/blob/master/conf/crontab-root