yannice92/lumen-php-fpm-nginx-base-image

lumen-php-fpm-nginx-base-image

镜像概述

该镜像为Lumen框架应用提供容器化运行环境，基于官方PHP镜像或Alpine镜像构建，集成php-fpm8和nginx服务，旨在简化Lumen应用的部署流程，确保运行环境的一致性和可靠性。

核心功能与特性

• 基础镜像：基于官方PHP镜像或Alpine镜像，确保底层环境的稳定性
• 组件集成：内置php-fpm8和nginx，满足Lumen应用的Web服务需求
• 配置路径明确：提供固定的php-fpm和PHP扩展配置文件路径，便于自定义配置
• 权限优化：预设nginx相关目录的权限配置，确保容器内服务正常运行

使用场景

• Lumen框架应用的开发、测试及生产环境部署
• 需要php-fpm与nginx组合运行的轻量级PHP应用容器化场景
• 对镜像体积有要求（选择Alpine基础镜像时）的Lumen应用部署

配置与使用说明

核心配置路径

• php-fpm池配置：/etc/php8/php-fpm.d/www.conf
  用于配置php-fpm进程池参数，如进程数、用户权限、超时设置等。

• PHP扩展配置：/etc/php8/conf.d/
  存放PHP扩展的配置文件（如mysqli.ini、redis.ini等），可通过挂载自定义配置文件扩展PHP功能。

启动php-fpm服务

运行php-fpm8服务的命令：

bash
php-fpm8 -F

（-F参数表示前台运行，适合容器化环境）

Nginx权限配置

为确保nginx服务在容器内正常访问相关目录，需执行以下权限设置命令：

bash
chgrp -R 0 /var/lib/nginx /var/lib/nginx/logs /var/log/nginx && chmod -R g=u /var/lib/nginx /var/lib/nginx/logs /var/log/nginx

• chgrp -R 0：将指定目录的组ID设置为0（root组）
• chmod -R g=u：使组权限继承用户权限，确保容器内非root用户可访问

部署示例

基础运行命令

bash
docker run -d \
  -p 80:80 \
  -v /path/to/your/lumen/app:/var/www/html \
  -v /path/to/custom/php-fpm.conf:/etc/php8/php-fpm.d/www.conf \
  -v /path/to/nginx.conf:/etc/nginx/nginx.conf \
  lumen-php-fpm-nginx-base-image

docker-compose配置示例

yaml
version: '3'
services:
  lumen-app:
    image: lumen-php-fpm-nginx-base-image
    ports:
      - "80:80"
    volumes:
      - ./your-lumen-app:/var/www/html
      - ./php-fpm-conf:/etc/php8/php-fpm.d
      - ./php-ext-conf:/etc/php8/conf.d
      - ./nginx-conf:/etc/nginx
    command: sh -c "chgrp -R 0 /var/lib/nginx /var/lib/nginx/logs /var/log/nginx && chmod -R g=u /var/lib/nginx /var/lib/nginx/logs /var/log/nginx && php-fpm8 -F"

注意事项

• 若需使用Alpine基础镜像，建议提前确认应用依赖的PHP扩展在Alpine环境中的兼容性
• 自定义配置文件时，需确保配置参数与php-fpm8及nginx版本匹配
• 生产环境中建议挂载日志目录到宿主机，便于日志收集和分析