eonxcom/rewards-php-fpm

rewards-php-fpm 镜像文档

镜像概述

rewards-php-fpm是专为Rewards项目设计的PHP-FPM容器镜像，基于PHP 7.4版本构建。该镜像提供了FastCGI进程管理功能，旨在为Rewards相关PHP应用程序提供稳定、高效的运行环境，适用于与Web服务器（如Nginx）配合部署PHP应用。

核心功能与特性

• PHP 7.4环境：基于PHP 7.4版本，支持该版本的所有核心特性及扩展
• FPM进程管理：集成PHP-FPM（FastCGI Process Manager），提供进程池管理、请求处理等功能
• 轻量级设计：优化的镜像大小，适合快速部署和资源受限环境
• 兼容性：专为Rewards项目设计，确保与该项目的PHP应用代码兼容

使用场景与适用范围

• Rewards项目的PHP应用部署
• 需要PHP 7.4环境的Web应用服务搭建
• 与Nginx等Web服务器配合构建LAMP/LNMP架构
• 开发、测试及生产环境中的Rewards应用运行

使用方法与配置说明

基本使用（docker run）

bash
docker run -d \
  --name rewards-php-fpm \
  -v /path/to/rewards/app:/var/www/html \
  rewards-php-fpm

与Nginx配合使用示例

1. 创建docker-compose.yml文件：

yaml
version: '3'
services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
      - /path/to/rewards/app:/var/www/html
    depends_on:
      - php-fpm

  php-fpm:
    image: rewards-php-fpm
    volumes:
      - /path/to/rewards/app:/var/www/html

2. 创建Nginx配置文件nginx.conf：

nginx
server {
    listen 80;
    server_name localhost;
    root /var/www/html;
    index index.php index.html;

    location ~ \.php$ {
        fastcgi_pass php-fpm:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

3. 启动服务：

bash
docker-compose up -d

配置参数说明

该镜像支持通过环境变量调整PHP-FPM配置，常用参数如下：

• PHP_FPM_MAX_CHILDREN：设置FPM进程池最大子进程数，默认值为5
• PHP_FPM_START_SERVERS：设置启动时的子进程数，默认值为2
• PHP_FPM_MIN_SPARE_SERVERS：设置最小空闲进程数，默认值为1
• PHP_FPM_MAX_SPARE_SERVERS：设置最大空闲进程数，默认值为3

示例（调整FPM进程数）：

bash
docker run -d \
  --name rewards-php-fpm \
  -e PHP_FPM_MAX_CHILDREN=10 \
  -v /path/to/rewards/app:/var/www/html \
  rewards-php-fpm