prometherion/php7-nginx

prometherion/php7-nginx 镜像说明

镜像概述

该镜像为PHP7.1和NGINX优化的基础镜像，通过Supervisor统一管理php-fpm和nginx服务，提供符合12因素应用的运行环境。镜像不绑定SSL端口（443），由负载均衡器负责SSL处理；使用非特权端口8080运行，避免使用1024以下的特权端口。

核心功能

1. 服务管理：通过Supervisor启动、重启、停止php-fpm和nginx，支持添加自定义服务。
2. 日志处理：服务日志（错误、访问日志）重定向至STDOUT，便于利用Docker日志功能。
3. 优雅启停：捕获SIGTERM和SIGQUIT信号，实现服务优雅关闭。
4. 灵活配置：通过环境变量调整PHP-FPM参数、工作目录等。
5. 健康检查：每5秒检查PHP-FPM和NGINX运行状态。

使用场景

适用于需要PHP7.1和NGINX运行环境的Web应用部署，如PHP开发的网站、API服务、后台管理系统等。

配置说明

命令

• 启动服务：/usr/bin/start或start
  启动默认服务，可在/etc/supervisor/conf.d添加自定义服务。
• 重启服务：/usr/bin/restart或restart
  重启所有服务，适用于配置修改后生效。
• 停止服务：/usr/bin/stop或stop
  优雅关闭所有服务，支持docker stop触发。

环境变量

基础配置

• WORKDIR：工作目录，默认/var/www（NGINX默认服务/var/www/public）。
• ENV_FILE：可选dotEnv文件路径，存在则复制为.env。

PHP-FPM配置

• LISTEN：监听地址，默认127.0.0.1:9000。
• MAX_CHILDREN：子进程最大数量。
• START_SERVER：启动时子进程数量（需大于MIN_SPARE_SERVERS）。
• MIN_SPARE_SERVERS：空闲子进程最小数量。
• MAX_SPARE_SERVERS：空闲子进程最大数量。
• MAX_REQUESTS：每个子进程处理的最大请求数（0表示无限制）。

通用配置

• MAX_UPLOAD_SIZE：最大上传文件大小（PHP-FPM和NGINX共享）。

部署示例

Docker Run命令

bash
docker run -d -p 8080:8080 \
  -v /path/to/your/app:/var/www \
  -e MAX_UPLOAD_SIZE=10M \
  docker.xuanyuan.run/prometherion/php7-nginx

Docker Compose示例

yaml
version: '3'
services:
  web:
    image: prometherion/php7-nginx
    ports:
      - "8080:8080"
    volumes:
      - ./app:/var/www
    environment:
      - MAX_CHILDREN=5
      - MAX_UPLOAD_SIZE=20M