php-fpm 8.x 镜像文档

镜像概述

本镜像为基于php8.3.12-fpm的Docker容器，专为Nextcloud应用设计，需配合Web服务器（如Nginx）和数据库容器（如MariaDB）协同工作。容器内部通过9000端口提供PHP-FPM服务，支持通过配置文件实现邮件发送功能，适用于构建稳定的Nextcloud运行环境。

核心功能与特性

• PHP环境：内置php8.3.12-fpm运行环境，满足Nextcloud对PHP的版本及扩展需求
• 服务端口：内部固定通过9000端口提供PHP-FPM服务，供Web服务器反向代理连接
• 邮件支持：集成heirloom-mailx工具，通过配置mail.rc文件可实现应用内邮件发送功能
• 灵活挂载：支持挂载应用代码、数据目录及配置文件，实现数据持久化和自定义配置

使用场景与适用范围

主要用于Nextcloud部署环境中的PHP处理层，作为动态请求处理服务，需与Nginx等Web服务器（处理静态资源及反向代理）、MariaDB/MySQL等数据库（存储应用数据）配合使用，构建完整的Nextcloud服务架构。

使用方法与配置说明

前置条件

• 已安装Docker及Docker Compose
• 主机已创建并配置以下目录/文件：
  • Nextcloud数据存储目录
  • Web应用根目录
  • Nginx配置目录及日志目录
  • 邮件配置文件mail.rc（用于配置SMTP服务器信息实现邮件发送）
  • 数据库数据存储目录

Docker Compose配置示例

以下为配合Nginx和MariaDB部署Nextcloud的完整配置示例（需将/HOST/...替换为实际主机路径）：

version: '3'

services:
  web:
    image: nginx:latest
    ports:
      - "80:80"   # HTTP端口映射
      - "443:443" # HTTPS端口映射
    volumes:
      - /HOST/NEXTCLOUD_DATA_DIR:/CONTAINER/cloud      # Nextcloud数据目录（主机:容器）
      - /HOST/webroot:/var/www/htdocs                  # Web应用根目录（主机:容器）
      - /HOST/serverconfig/nginx:/etc/nginx            # Nginx配置文件目录（主机:容器）
      - /HOST/logs/nginx:/var/log/nginx                # Nginx日志目录（主机:容器）
      - /HOST/DHPARAMS_FILE:/etc/ssl/nginx:ro          # DH参数文件（只读挂载，主机:容器）
      - /HOST/SSLCERTIFICATES:/etc/letsencrypt:ro      # SSL证书目录（只读挂载，主机:容器）
    links:
      - php   # 连接php服务容器
      - mysql # 连接数据库服务容器
    restart: always  # 容器退出时自动重启

  php:
    image: fezzz/php-fpm  # 使用本php-fpm镜像
    volumes:
      - /HOST/serverconfig/mailx/mail.rc:/etc/mail.rc  # 挂载邮件配置文件（主机:容器）
      - /HOST/NEXTCLOUD_DATA_DIR:/CONTAINER/cloud      # Nextcloud数据目录（主机:容器）
      - /HOST/webroot:/var/www/htdocs                  # Web应用根目录（主机:容器）
    links:
      - mysql # 连接数据库服务容器
    restart: always  # 容器退出时自动重启

  mysql:
    image: mariadb:latest  # 使用MariaDB最新版镜像
    volumes:
      - /HOST/DATABASES:/var/lib/mysql  # 数据库数据持久化目录（主机:容器）
    restart: always  # 容器退出时自动重启

启动与验证步骤

1. 配置文件准备
   将上述Docker Compose配置保存为docker-compose.yml，并将所有/HOST/...路径替换为实际主机路径（例如将/HOST/webroot替换为/data/nextcloud/webroot）。

2. 启动服务
   在docker-compose.yml所在目录执行以下命令启动所有服务：

   docker-compose up -d
   

3. 状态验证
   执行以下命令检查服务状态，确保php、web、mysql三个服务均处于Up状态：

   docker-compose ps
   

关键配置说明

• 邮件配置：php服务中/etc/mail.rc挂载自主机/HOST/serverconfig/mailx/mail.rc，需在主机配置文件中填写正确的SMTP服务器地址、端口、认证信息等，否则邮件发送功能无法使用。
• 数据持久化：所有核心数据（Nextcloud数据、Web代码、数据库文件）均通过主机目录挂载实现持久化，需确保主机目录权限正确（建议设置权限为755或根据应用需求调整）。
• 服务依赖：web服务依赖php和mysql服务，php服务依赖mysql服务，Docker Compose会自动处理启动顺序。

注意事项

• 本镜像仅包含PHP-FPM服务，无法独立提供Web服务，必须配合Web服务器使用。
• 如修改配置文件或目录结构，需重启对应服务使配置生效：docker-compose restart <服务名>（如docker-compose restart php）。
• 生产环境中建议为数据库服务添加访问密码，并通过环境变量或配置文件注入，增强安全性。