PHP-FPM Docker镜像文档

镜像概述

本镜像为基于Alpine的PHP-FPM镜像，用于提供运行PHP应用的FPM服务。支持通过环境变量自定义PHP.ini和FPM配置参数，提供持久化卷用于挂载应用代码，并允许设置运行权限，适用于作为Web服务器（如Nginx）的后端处理PHP请求。

核心功能与特性

• 轻量基础：基于Alpine构建，镜像体积小，资源占用低
• 灵活配置：通过环境变量自定义PHP核心参数（如内存限制、上传大小）和FPM进程管理配置
• 权限控制：支持设置运行用户ID（UID）和组ID（GID），适配不同权限需求
• 持久化存储：提供/var/www卷，用于挂载PHP应用代码，确保数据持久化

环境变量配置

可通过环境变量自定义PHP及FPM配置，以下为支持的环境变量、对应配置项及默认值：

卷配置

• /var/www：用于挂载PHP应用代码目录，容器内PHP进程将从该目录读取并执行应用代码

使用方法

基本运行命令

通过docker run命令启动容器，挂载应用目录并自定义配置：

docker run \
    -d \
    --name php-fpm \
    -v /本地应用目录:/var/www \  # 挂载本地PHP应用代码到容器内/var/www
    -e UPLOAD_MAX_FILESIZE=128M \  # 自定义上传文件大小限制
    gists/php

Docker Compose配置示例

以下为配合Nginx使用的docker-compose配置示例，实现PHP应用的完整部署：

version: '3'

services:
    php:
        container_name: php
        image: gists/php  # 使用本PHP-FPM镜像
        volumes:
            - /本地应用目录:/var/www  # 挂载PHP应用代码
            - phpsocket:/run/php  # 共享sock文件给Nginx
        environment:
            UPLOAD_MAX_FILESIZE: 128M  # 自定义上传文件大小
            MEMORY_LIMIT: 512M  # 自定义内存限制
        restart: always  # 容器退出后自动重启

    nginx:
        container_name: nginx
        image: nginx:stable-alpine  # Nginx镜像
        ports:
            - "80:80"   # 映射HTTP端口
            - "443:443" # 映射HTTPS端口
        volumes:
            - /本地应用目录:/var/www  # 共享应用代码目录
            - phpsocket:/run/php  # 共享PHP-FPM的sock文件
            # 可添加Nginx配置文件挂载：- /本地Nginx配置:/etc/nginx/conf.d
        depends_on:
            - php  # 依赖php服务，确保php先启动
        restart: always

volumes:
    phpsocket:  # 用于PHP和Nginx共享sock文件的命名卷

Nginx配置示例

需在Nginx配置中通过fastcgi_pass连接PHP-FPM，根据镜像标签（php8或php5）使用不同的sock路径：

• 使用gists/php（默认php8）：

  fastcgi_pass    unix:/run/php/php8-fpm.sock;
  

• 使用gists/php:5（php5）：

  fastcgi_pass    unix:/run/php/php5-fpm.sock;
  

适用场景

• 作为Web服务器（如Nginx、Apache）的后端PHP处理器
• 开发或生产环境中运行PHP应用（如WordPress、Laravel等）
• 需要自定义PHP配置参数的PHP应用部署场景