antoinevdsk/php

镜像概述

本Docker镜像集成了PHP FPM（FastCGI Process Manager）和ssmtp（简单邮件传输协议客户端），旨在为PHP应用提供轻量级、易部署的运行环境。PHP版本通过镜像标签指定（如7.4、8.0等），ssmtp组件提供基础邮件发送能力，适用于需要PHP运行环境且依赖邮件功能的应用场景。

核心功能和特性

1. PHP FPM支持

• 多版本可选：通过镜像标签指定PHP版本（如php-fpm-ssmtp:7.4对应PHP 7.4，php-fpm-ssmtp:8.2对应PHP 8.2），满足不同应用的PHP版本需求。
• FastCGI协议：支持与Nginx等Web服务器配合，高效处理PHP请求，适合生产环境的并发场景。
• 可扩展配置：支持通过挂载php.ini或环境变量调整PHP配置（如内存限制、执行时间等）。

2. ssmtp集成

• 轻量级邮件发送：集成ssmtp作为邮件传输代理（MTA），无需复杂的邮件服务器配置，支持通过SMTP协议发送邮件。
• 灵活配置：支持通过环境变量或配置文件自定义SMTP服务器、端口、认证信息等参数。

3. 易用性与兼容性

• 开箱即用：无需额外安装PHP或ssmtp依赖，拉取镜像后即可快速启动PHP应用。
• 标准兼容：遵循Docker最佳实践，支持数据卷挂载、环境变量注入等标准容器操作。

使用场景和适用范围

• 开发/测试环境：快速搭建PHP应用运行环境，支持本地调试和功能验证。
• 轻量级PHP服务：部署中小型PHP应用（如博客、CMS、企业内部系统），减少服务器资源占用。
• 邮件依赖型应用：需发送通知邮件（如注册验证、密码重置、业务告警）的PHP服务。
• 容器化迁移：将传统PHP应用容器化，简化部署流程并提高环境一致性。

使用方法和配置说明

1. 获取镜像

通过docker pull命令获取镜像，指定所需PHP版本标签（以PHP 7.4为例）：

bash
docker pull [镜像仓库地址]/php-fpm-ssmtp:7.4

注：实际使用时需替换[镜像仓库地址]为镜像所在的仓库（如Docker Hub、私有仓库等）。

2. 基本运行示例

2.1 启动容器并运行PHP应用

挂载本地PHP应用目录（如./app），暴露PHP FPM端口（默认9000）：

bash
docker run -d \
  --name php-fpm-app \
  -v $(pwd)/app:/var/www/html \  # 挂载PHP应用代码目录
  -p 9000:9000 \                # 映射PHP FPM端口（供Web服务器反向代理）
  [镜像仓库地址]/php-fpm-ssmtp:7.4

2.2 配合Nginx使用

通过Docker Compose实现PHP FPM与Nginx联动（示例docker-compose.yml）：

yaml
version: '3'
services:
  php-fpm:
    image: [镜像仓库地址]/php-fpm-ssmtp:7.4
    volumes:
      - ./app:/var/www/html
    environment:
      - SMTP_SERVER=smtp.example.com  # ssmtp SMTP服务器
      - SMTP_PORT=587                 # SMTP端口
      - SMTP_USER=user@example.com    # SMTP认证用户名
      - SMTP_PASS=password            # SMTP认证密码
    restart: always

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf  # Nginx反向代理配置
      - ./app:/var/www/html                          # 共享PHP应用目录
    depends_on:
      - php-fpm
    restart: always

Nginx配置示例（nginx.conf）：

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

    location ~ \.php$ {
        fastcgi_pass php-fpm:9000;  # 连接PHP FPM容器
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

3. ssmtp配置

ssmtp通过/etc/ssmtp/ssmtp.conf文件配置，支持通过环境变量或挂载配置文件自定义参数：

3.1 环境变量配置（推荐）

启动容器时注入环境变量，自动生成ssmtp.conf：

bash
docker run -d \
  --name php-fpm-with-email \
  -v $(pwd)/app:/var/www/html \
  -e SMTP_SERVER=smtp.example.com \    # SMTP服务器地址（必填）
  -e SMTP_PORT=587 \                   # SMTP端口（默认25，SSL通常为465，TLS为587）
  -e SMTP_USER=user@example.com \      # SMTP认证用户名（如需要）
  -e SMTP_PASS=password \              # SMTP认证密码（如需要）
  -e FROM_LINE_OVERRIDE=yes \          # 是否允许覆盖发件人地址（yes/no）
  -e FROM_ADDR=noreply@example.com \   # 默认发件人地址
  [镜像仓库地址]/php-fpm-ssmtp:7.4

3.2 自定义配置文件

挂载本地ssmtp.conf文件覆盖默认配置：

bash
docker run -d \
  --name php-fpm-custom-ssmtp \
  -v $(pwd)/app:/var/www/html \
  -v $(pwd)/ssmtp.conf:/etc/ssmtp/ssmtp.conf \  # 挂载自定义ssmtp配置
  [镜像仓库地址]/php-fpm-ssmtp:7.4

ssmtp.conf示例配置：

ini
mailhub=smtp.example.com:587
AuthUser=user@example.com
AuthPass=password
FromLineOverride=yes
FromAddr=noreply@example.com
UseTLS=yes

4. PHP配置调整

4.1 挂载自定义php.ini

通过挂载本地php.ini覆盖默认配置：

bash
docker run -d \
  --name php-fpm-custom-phpini \
  -v $(pwd)/app:/var/www/html \
  -v $(pwd)/php.ini:/usr/local/etc/php/php.ini \  # 挂载自定义php.ini
  [镜像仓库地址]/php-fpm-ssmtp:7.4

4.2 通过环境变量调整（部分配置）

部分PHP配置支持通过环境变量调整（具体取决于镜像实现），例如：

bash
docker run -d \
  --name php-fpm-env-config \
  -e PHP_MEMORY_LIMIT=256M \          # 设置内存限制
  -e PHP_MAX_EXECUTION_TIME=60 \      # 设置最大执行时间（秒）
  [镜像仓库地址]/php-fpm-ssmtp:7.4

注意事项

• 生产环境建议：生产环境中建议结合持久化存储、健康检查和日志收集（如挂载日志目录至宿主机）。
• 安全配置：避免将SMTP密码等敏感信息直接暴露在命令行中，可通过Docker Secrets或环境变量文件（.env）管理。
• 版本选择：根据应用兼容性选择合适的PHP版本标签，优先使用官方支持的稳定版本（如PHP 7.4、8.1等）。