kiweeteam/php-fpm

Shopware 6 优化的 PHP-FPM+NGINX 基础镜像

镜像概述

本镜像为结合 PHP-FPM 和 NGINX 的基础运行环境，专门针对 Shopware 6 电商平台进行深度优化。通过整合 PHP 处理能力与 NGINX 反向代理/静态资源服务，提供开箱即用的 Shopware 6 运行底座，减少环境配置复杂度，同时保障生产级性能与兼容性。

核心功能与特性

1. PHP-FPM 与 NGINX 深度集成

• 预配置 NGINX 虚拟主机规则，自动转发动态请求至 PHP-FPM
• 优化静态资源（图片、CSS、JS）处理策略，减轻 PHP 服务压力
• 内置请求超时控制、连接数限制等生产级安全配置

2. Shopware 6 专项优化

• 适配 Shopware 6 官方系统要求，预安装必要 PHP 扩展（如 opcache、redis、mysqli、gd、intl 等）
• 针对 Symfony 框架（Shopware 6 底层）优化 PHP 内存限制与执行时间
• 支持 Shopware 6 的多语言、多商店功能及 Elasticsearch 集成需求

3. 轻量与可扩展性

• 基于官方 PHP 和 NGINX 镜像构建，剔除冗余组件，最小化镜像体积
• 支持通过环境变量动态调整核心配置（如 PHP 内存限制、NGINX 工作进程数）
• 预留配置文件挂载点，支持自定义 PHP.ini、php-fpm.conf 及 NGINX 配置

使用场景与适用范围

• 开发环境：快速搭建本地 Shopware 6 开发环境，无需手动配置 PHP/NGINX 环境
• 测试环境：在 CI/CD 流程中作为测试载体，验证 Shopware 6 代码兼容性
• 生产环境：作为 Shopware 6 应用的基础运行层，配合数据库、缓存等服务构建完整电商平台

使用方法与配置说明

基本使用（docker run）

bash
docker run -d \
  --name shopware6-env \
  -p 80:80 \
  -v /path/to/shopware6/code:/var/www/html \
  -e PHP_MEMORY_LIMIT=512M \
  [镜像名称]:[标签]

说明：

• /path/to/shopware6/code 需替换为本地 Shopware 6 代码目录
• -p 80:80 映射容器 80 端口至宿主机，可根据需求调整

环境变量配置

支持通过 -e 参数自定义以下核心配置：

自定义配置挂载

如需覆盖默认配置，可通过 -v 挂载自定义文件：

bash
# 挂载自定义 PHP 配置
-v /path/to/custom/php.ini:/usr/local/etc/php/conf.d/custom.ini

# 挂载自定义 NGINX 站点配置
-v /path/to/custom/nginx-site.conf:/etc/nginx/conf.d/default.conf

docker-compose 部署示例

yaml
version: '3.8'

services:
  shopware-web:
    image: [镜像名称]:[标签]
    ports:
      - "80:80"
    volumes:
      - ./shopware6-code:/var/www/html
      - ./php-custom.ini:/usr/local/etc/php/conf.d/custom.ini
    environment:
      - PHP_MEMORY_LIMIT=512M
      - SHOPWARE_ENV=prod
    depends_on:
      - shopware-db
      - shopware-redis

  shopware-db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_DATABASE=shopware
      - MYSQL_USER=shopware
      - MYSQL_PASSWORD=shopwarepass
    volumes:
      - db-data:/var/lib/mysql

  shopware-redis:
    image: redis:alpine
    volumes:
      - redis-data:/data

volumes:
  db-data:
  redis-data:

注意事项

• 本镜像为基础运行环境，需自行准备 Shopware 6 源代码（可通过官方渠道下载或 Git 拉取）
• 生产环境中建议配合数据库（MySQL/MariaDB）、缓存（Redis）、搜索引擎（Elasticsearch）等服务使用
• 高并发场景下，建议通过 Docker Swarm 或 Kubernetes 进行容器编排，实现负载均衡
• 定期更新镜像以获取安全补丁及 PHP/NGINX 版本更新