dockware/shopware

Dockware for Shopware 镜像文档

镜像概述和主要用途

Dockware镜像是优化的Docker镜像，主要用于Web开发，尤其适用于Symfony和Shopware项目。本仓库包含两个镜像：dockware/shopware 和 dockware/shopware-essentials，是Shopware 6开发的理想选择。

• shopware-essentials：单容器内包含运行自定义Shopware版本所需的一切组件
• shopware：预装并配置好的Shopware 6实例，可立即开始开发

两个镜像均包含所有必要服务（如MySQL）及附加工具（如AdminerEVO、PimpMyLog等），开发者可直接使用Xdebug、切换PHP版本、Node版本等功能。

核心功能和特性

• 全栈开发环境：内置MySQL数据库、Web服务器及开发工具
• 灵活版本控制：支持切换PHP和Node版本（需与Shopware版本兼容）
• 开发工具集成：包含Xdebug调试工具、AdminerEVO数据库管理、PimpMyLog日志查看
• 即开即用：shopware镜像预装Shopware 6，无需手动安装配置
• 轻量级设计：仅包含Shopware版本支持的PHP、Node等依赖包，保持镜像精简

使用场景和适用范围

推荐使用场景

• 探索任何Shopware 6版本功能
• 开发Shopware 6插件、应用程序和主题
• 在CI/CD流水线中作为测试环境使用

特殊场景建议

• 开发完整Shopware 6商店：推荐使用shopware-essentials镜像
• 需本地重建生产环境：推荐使用dockware/web镜像（适合熟悉Docker的用户）

版本控制说明

版本策略

• dockware/shopware：使用Docker标签指示Shopware版本（如6.7.2.0），无需额外配置即可获取对应Shopware版本
• dockware/shopware-essentials：采用语义化版本控制

源码与更新

• 仓库源码始终对应最新Shopware版本，通过Git标签标记发布（如release-6.6.9.0）
• 旧版本修复会创建单独分支并生成新标签（如release-6.6.9.0-v2）

兼容性说明

• 仅包含Shopware版本支持的PHP、Node等依赖包
• 旧版Shopware可能在dockware/dev或dockware/play镜像中提供

使用方法和配置说明

快速启动

Docker Run

通过以下命令启动Shopware 6实例，映射80端口，访问地址：http://localhost。容器就绪状态可通过`docker logs`命令查看日志确认（通常下载镜像后仅需几秒）。

bash
docker run -p 80:80 dockware/shopware:6.7.2.0

Docker Compose

以下是等效的docker-compose.yml配置，包含可选的PHP和Node版本环境变量。注意：使用不存在于镜像版本中的PHP或Node版本会导致容器启动失败。

yaml
shop:
  image: dockware/shopware:6.7.2.0
  ports:
    - 80:80
  environment:
    - PHP_VERSION=8.4
    - NODE_VERSION=20

高级功能文档

有关Xdebug、Filebeat、PHP切换、Supervisor等功能的详细说明，请访问官方文档：[***]

贡献指南

欢迎贡献代码！更多信息请查看GitHub页面：https://github.com/dockware/shopware