使用 Laradock 在 Docker 中运行 Shopware 6:电商开发环境完整搭建指南
使用 Laradock 在 Docker 中运行 Shopware 6:电商开发环境完整搭建指南
本文以 Laradock 为核心,讲解如何在几分钟内用 Docker 容器跑起一个完整的 Shopware 6 电商环境:NGINX + PHP-FPM + MySQL 的最小可启动组合、workspace 容器内的 Composer 与 Node 工具链、以及消息队列、定时任务、Redis 缓存、OpenSearch 搜索和邮件捕获器的逐项接入。读完本文,你将掌握一套可复制、可切换 PHP 版本、可直接走向生产的 Shopware 容器化开发与部署方案,全程无需在宿主机安装任何 PHP 组件。
Shopware 是什么
Shopware 是一个基于 Symfony 的开源电商平台。Shopware 6 的后端构建在 Symfony 之上,店铺前台(Storefront)和管理后台(Administration)界面则使用 Vue.js 开发。从架构上看,一套 Shopware 安装本质上是一个 PHP 应用:后端依赖 MySQL 或 MariaDB 数据库,前端由 Web 服务器(NGINX/Apache)提供服务——仅凭这三样它就能启动。
在此基础上,Shopware 还可以按需接入更多基础设施:
- 一个后台工作进程(background worker)用于处理消息队列;
- 一个调度器(scheduler)用于执行周期性任务;
- Redis 用于缓存与会话存储;
- OpenSearch 或 Elasticsearch 用于目录增长后的店铺搜索;
- Node 用于构建店铺前台与后台的前端资源。
这些可选项正是 Docker 容器化最能发挥价值的地方。
为什么要在 Docker 中运行 Shopware
Docker 将上述每个组件(NGINX、PHP-FPM、MySQL,以及可选的 Redis、OpenSearch、Node)打包进相互隔离的容器,这些容器在任何机器上行为一致。与直接在笔记本上安装 PHP 和 MySQL 相比,容器化避免了多项目之间 PHP 版本冲突、以及“在我机器上能跑”这类问题:容器是即用即弃的,删除后环境干净地消失。
更关键的是多版本并存能力——同一个开发机上,一个项目可以运行当前 Shopware 6 版本所要求的 PHP 版本,另一个项目可以停留在旧版本,两者互不干扰,且宿主机上无需全局安装任何东西。
不过,自行把基础镜像、PHP 扩展、网络、权限这些容器拼接起来,往往是"一周的繁琐 Docker 工作"。这正是 Laradock 解决的问题。
为什么 Laradock 适合 Shopware
Shopware 官方文档会引导开发者使用 dockware——一个社区维护的、专门为 Shopware 6 本地开发设计的 Docker 方案。因此与大多数 PHP 项目不同,Shopware 并不"必须"依赖 Laradock。但 Laradock 仍然是最适合它的方案,原因如下:
- 不被单一生态锁定:Laradock 与框架无关。当你在 Shopware 店铺旁边新增一个 Laravel API、一个 WordPress 营销站点或一个纯 PHP 脚本时,它们可以在同一环境、用同一套命令运行,而 Shopware 专属工具做不到这一点。
- 灵活性更大:Laradock 提供 100+ 现成服务,PHP 版本覆盖 5.6 到 8.5,而 Shopware 专属镜像只提供一组固定的 Shopware 版本。
- 一切透明、完全自主:没有生成文件、没有魔法、没有介于你和 Docker 之间的包装二进制。每一个 Dockerfile 和 compose 文件都在仓库里,可读可改。
- 零学习成本:你使用的就是普通的
docker compose,这套知识可以直接迁移到生产环境和其他任何项目。可选的 CLI 只是便利工具,不是必需品。
具体到 Shopware,Laradock 提供了生产风格的 NGINX + PHP-FPM 栈、开箱即用的 MySQL/MariaDB、一个预装了 Composer、Node 和 npm 的 workspace 容器(用于执行 Symfony 控制台命令与资源构建),以及一条命令即可启动的 Redis、OpenSearch 和邮件捕获器。
用 Laradock 运行 Shopware 的完整流程
1. 把 Laradock 添加到项目
在项目目录中克隆 Laradock 并进入其目录:
cd my-shopware-app
git clone https://gitcode.com/gh_mirrors/la/laradock.git
cd laradock
如果你还没有 Shopware 项目,可以先克隆 Laradock,在后续步骤中从 workspace 容器里安装一个新项目。
2. 选择店铺所需的服务
Shopware 启动只需要两样东西:Web 服务器和数据库。Web 服务器会自动拉入 PHP-FPM,因此完整的最小栈是:
- Laradock CLI 方式:
./laradock start nginx mysql workspace
- Docker Compose 方式:
cp .env.example .env
docker compose up -d nginx mysql workspace
偏好 MariaDB 而非 MySQL?把服务名换成 mariadb 即可:./laradock start nginx mariadb workspace(或 docker compose up -d nginx mariadb workspace)。完整的服务目录见 Intro 文档。
希望逐步交互式选择?可选的 CLI 会引导你完成选择:先执行 ./laradock setup,再执行 ./laradock start,它会把执行的每一条真实命令打印出来。
一开始需要 Redis 或 OpenSearch 吗?不需要。 一套全新的 Shopware 店铺在
nginx mysql workspace上就能完美运行。Shopware 默认用内置的 admin worker 处理消息队列、用文件系统做缓存,所以开发初期不需要其他组件。Redis 和 OpenSearch 是针对繁忙店铺的性能增强项,等真正需要时再参考下文的可选章节接入。
从源码看,这三个服务各自的职责与依赖关系一目了然:
- nginx/compose.yml 挂载
APP_CODE_PATH_HOST(应用代码目录)与站点配置、SSL 目录,并通过depends_on: php-fpm保证 PHP-FPM 先行启动; - workspace/compose.yml 同样挂载应用代码目录,并暴露了 SSH、BrowserSync、Vue CLI 等开发端口;
- mysql/compose.yml 通过环境变量注入数据库名、用户、密码,并将数据持久化到
${DATA_PATH_HOST}/mysql。
3. 让 Shopware 指向容器
在应用(Shopware 项目)的 .env 中,使用服务名作为主机名:
DATABASE_URL="mysql://default:secret@mysql:3306/default"
APP_URL="http://localhost"
默认的数据库名、用户名和密码定义在 mysql/defaults.env:MYSQL_DATABASE=default、MYSQL_USER=default、MYSQL_PASSWORD=secret、MYSQL_ROOT_PASSWORD=root、端口 3306。在 Laradock 根目录的 .env 中新增对应行即可覆盖任意一项(Laradock 的 .env 优先级更高)。注意容器之间通过 Docker 内部网络通信,因此主机名直接写 mysql 而非 localhost——这与 mysql/compose.yml 中该服务接入 backend 网络的配置对应。
4. 安装并启动店铺
进入预装了 Composer 和 Node 的 workspace 容器:
- Laradock CLI 方式:
./laradock workspace
- Docker Compose 方式:
docker compose exec workspace bash
进入容器后执行:
composer create-project shopware/production my-shopware-app # 仅当你还没有项目时执行
php bin/console system:install --basic-setup # 创建 schema、storefront 销售渠道、admin 用户
./bin/build-storefront.sh # 用 Node 编译 storefront 资源
system:install --basic-setup 会完成三件事:建立数据库 schema、创建一个绑定到 APP_URL 的 Storefront 销售渠道、以及创建一个默认管理员用户(admin / shopware)。随后打开 http://localhost 查看店铺前台,打开 http://localhost/admin 进入管理后台——一套完整的 Shopware 店铺就这样跑在了 Docker 上。
workspace 镜像之所以能承担这些工作,是因为 workspace/Dockerfile 中内置了完整的开发工具链:Composer(含 composer.json、auth.json 配置与 PATH 导出)、Node(通过 nvm 安装,支持自定义 NODE_VERSION 与 npm 镜像源/重试参数),以及 MySQL 客户端(mysql-client)。
添加 Redis(缓存与会话,可选)
Redis 不是运行必需项,但在繁忙店铺上它能显著减轻 MySQL 压力:把缓存、HTTP 缓存和 PHP 会话保存在内存中,同时为消息队列提供持久化的传输通道。接入分三步:
- 启动 Redis 容器:
- Laradock CLI:
./laradock start redis - Docker Compose:
docker compose up -d redis
- 让 Shopware 指向它。在应用的
.env中使用redis服务名作为主机:
REDIS_URL="redis://redis:6379"
MESSENGER_TRANSPORT_DSN="redis://redis:6379/messages"
- 启用 Redis 适配器。在
config/packages/shopware.yaml中为缓存(cache)、自增计数(increment)和号码区间存储(number range)配置 Redis 适配器(参考 Shopware 官方的性能缓存指南),然后从 workspace 清空缓存:
php bin/console cache:clear
不执行以上步骤时 Redis 容器只是空转,这正是最小栈把它排除在外的原因。从 redis/compose.yml 可以看到,默认 REDIS_VERSION=7-alpine、端口 6379,并通过 --requirepass ${REDIS_PASSWORD} 设置了访问密码;数据持久化在 ${DATA_PATH_HOST}/redis。
添加 OpenSearch 搜索(可选)
Shopware 默认直接查询 MySQL 做搜索,这在目录较小时没有问题;对于大型目录和追求快速前台/后台搜索的场景,可以让 Shopware 指向 OpenSearch——Laradock 直接把它作为一个服务内置,是 Elasticsearch 的即插即用替代品。
- 启动 OpenSearch:
- Laradock CLI:
./laradock start opensearch - Docker Compose:
docker compose up -d opensearch
- 在应用的
.env中启用它,使用opensearch服务名作为主机:
OPENSEARCH_URL="opensearch:9200"
SHOPWARE_ES_ENABLED="1"
SHOPWARE_ES_INDEXING_ENABLED="1"
SHOPWARE_ES_INDEX_PREFIX="sw"
- 从 workspace 构建索引:
php bin/console es:index
此后 Shopware 就会使用 OpenSearch 处理店铺搜索。(偏好 Elasticsearch 或 Meilisearch?Laradock 同样内置了这两个服务:把服务名换成 elasticsearch 或 meilisearch 启动,并将上述变量指向对应主机即可。)
源码细节佐证:opensearch/compose.yml 使用 opensearchproject/opensearch:${OPENSEARCH_VERSION}(默认 OPENSEARCH_VERSION=2)镜像,单节点模式、关闭安全插件、固定 JVM 堆内存 512m,宿主端口默认 OPENSEARCH_HOST_PORT=9202、监控端口 9600。
添加邮件捕获器(可选)
Shopware 通过 SMTP 发送订单确认、密码重置和新闻简报邮件。开发阶段你不希望这些邮件真的发出去,可以把它们路由到一个捕获器,在 Web 收件箱里查看每一封邮件。
- 启动 MailHog:
- Laradock CLI:
./laradock start mailhog - Docker Compose:
docker compose up -d mailhog
- 在应用的
.env中把 Shopware 的 mailer 指向它:
MAILER_DSN="smtp://mailhog:1025"
此后 Shopware 发送的每一封邮件都会进入 http://localhost:8025](http://localhost:8025) 的 MailHog 收件箱,而不是真实邮箱。[mailhog/compose.yml 中的端口映射正是 SMTP 端口 1025 和 Web 界面端口 8025。
随时切换 PHP 版本
这正是原生安装最痛苦、而 Laradock 最出彩的地方。在 Laradock 的 .env 中设置版本并重建:
PHP_VERSION=8.3
- Laradock CLI:
./laradock rebuild php-fpm workspace - Docker Compose:
docker compose build php-fpm workspace
当前的 Shopware 6 版本要求 PHP 8.2 或更高(6.7 增加了对 8.4 的支持),而锁定在较早小版本的旧 Shopware 6 安装可能需要更早的 PHP 版本。Laradock 覆盖 PHP 5.6 到 8.5 的全部版本(php-fpm 目录下从 php5.6.ini 到 php8.5.ini 的配置即可佐证),所以同一个工具可以在同一台机器上并排运行一个旧 Shopware 店铺和一个新 Shopware 店铺,彼此隔离,宿主机上什么都不用装。.env.example 中 PHP_VERSION=8.4 是默认值,workspace 与 php-fpm 两个服务都通过 LARADOCK_PHP_VERSION 构建参数消费它。
运行后台队列 worker
Shopware 会把慢任务(索引、邮件发送、导入)推入消息队列。开发阶段内置的 admin worker 会在后台管理标签页打开时自动消费队列,因此全新安装无需额外配置。在接近生产的环境下,你应该禁用 admin worker 并运行真正的 CLI worker——它更快,且不依赖浏览器保持打开。
- 在
config/packages/shopware.yaml中禁用 admin worker:
shopware:
admin_worker:
enable_admin_worker: false
- 从 workspace 容器运行消费者(建议加上
--time-limit和--memory-limit以便干净地回收进程):
php bin/console messenger:consume async low_priority --time-limit=60 --memory-limit=512M
如果需要持久化队列,可以用 Redis 作为后端(参考上文"添加 Redis"章节并设置 MESSENGER_TRANSPORT_DSN),而不是默认的 MySQL 传输。要让 worker 无人值守地持续运行,可以把该命令放进容器内的 cron 条目或由 supervisor 进程管理——Laradock 的 php-worker 服务正是为这类常驻进程场景准备的。
运行定时任务(cron)
Shopware 有自己的调度器来处理周期性任务(清理、商品导出、缓存预热)。它依托于消息队列:一个命令派发到期任务,上文提到的 worker 负责执行。从 workspace 容器执行:
php bin/console scheduled-task:run
scheduled-task:run 会阻塞并随任务到期逐个派发,因此要作为长驻进程与 messenger:consume 一起运行。如果不想用常驻进程、而是偏好离散的 cron 触发,可以在宿主机的系统 cron 条目中用 scheduled-task:run --no-wait 并通过 exec 进入容器执行。
构建 storefront 与 admin 前端资源
Shopware 在项目根目录提供两个 Node 构建脚本。每当修改主题的 SCSS/JS 或插件的 admin 模块时,从 workspace 容器执行(Node 和 npm 已内置):
./bin/build-storefront.sh # 编译 storefront 主题资源
./bin/build-administration.sh # 编译管理后台 UI
php bin/console theme:compile # 配置变更后重新编译激活主题
需要热重载的活跃编辑循环时,用 watcher 替代完整构建:php bin/console watch:storefront 或 php bin/console watch:administration。它们会在容器内启动一个 dev server;把打印出来的端口添加到 workspace/compose.yml 的 ports 映射即可从宿主机访问。
CLI 与后台管理工具
Shopware 提供的每一个 Symfony 控制台命令都可以从 workspace 容器执行。下面几个是日常高频命令:
php bin/console cache:clear # 清空应用缓存
php bin/console dal:refresh:index # 重建搜索 + SEO 索引
php bin/console plugin:refresh # 检测新添加的插件
php bin/console plugin:install --activate MyPlugin
php bin/console user:create admin --admin # 添加另一个管理员用户
php bin/console system:config:set ... # 读取/写入店铺配置
Composer、Node、npm 和 git 都在同一个容器里,所以插件安装(composer require store.shopware.com/...)和版本控制可以直接在容器内完成,宿主机完全不参与。
首次管理员登录
执行 system:install --basic-setup 之后,打开 http://localhost/admin 并用它创建的默认凭据登录:
- 用户名:
admin - 密码:
shopware
请立即从后台用户菜单修改该密码。后续需要添加更多管理员时,在 workspace 中执行 php bin/console user:create <name> --admin。
导入已有店铺数据库
要把店铺从其他环境迁移过来?把 SQL dump 放进 Laradock 目录(该目录已挂载进 workspace 容器),然后用容器内自带的 MySQL 客户端导入:
mysql -h mysql -u default -psecret default < my-store-dump.sql
这里的 -h mysql 即容器服务名,default/secret 对应 mysql/defaults.env 中的默认用户与密码。然后把应用的 .env 中 DATABASE_URL 指向同一个 default 数据库,重建派生索引并预热缓存:
php bin/console dal:refresh:index
php bin/console cache:clear
如果 dump 期望的是不同的数据库名,先创建它(mysql -h mysql -u root -proot -e "CREATE DATABASE mystore"),再让 DATABASE_URL 与之匹配。
将店铺上线
店铺就绪后,同一套 Laradock 栈就变成了你的部署方案。构建一个加固过的应用镜像并推送到你选择的主机:
./laradock ship
然后选择目标平台并跟随其简短指南——无论是单台服务器、托管平台还是 Kubernetes:生产部署文档 列出了每个提供商(Fly.io、Render、Railway、DigitalOcean、AWS、Google Cloud、Azure、Kamal、Kubernetes)并为每个提供一份现成的配置文件。没有针对特定提供商的魔法需要学习:Docker 镜像在任何地方运行方式都一样。别忘了在生产环境中把消息队列 worker 和调度器作为独立的长驻进程运行,正如上文所示。
常见问题(FAQ)
用 Laradock 运行 Shopware 需要安装 PHP、Composer 或 Node 吗?
不需要。所有东西都在容器内。Composer、Node 和 npm 都在 workspace 容器中;宿主机上永远不需要安装 PHP。
典型的 Shopware 店铺应该启动哪些服务?
nginx mysql workspace 就是 Shopware 启动所需的全部:Web 服务器、数据库,以及一个带 Composer 和 Node 的 shell。偏好 MariaDB 就把 mysql 换成 mariadb。只有真正接线时才添加 redis、opensearch 或 mailhog(参考上文可选章节);全新店铺不装它们也运行得很好。
能否在同一台机器上运行多个不同 PHP 版本的 Shopware 店铺?
可以。每个店铺使用独立的 Laradock 实例,配以唯一的 COMPOSE_PROJECT_NAME 和 DATA_PATH_HOST,并在各自的 .env 中设置不同的 PHP_VERSION(这两个变量在 .env.example 中默认为 laradock 与 ~/.laradock/data),它们就能在同一台机器上独立运行、互不干扰。
在 macOS、Windows 和 Linux 上表现一致吗?
一致。Laradock 可以在任何能运行 Docker 的地方运行。在 macOS/Windows 上,文件同步速度取决于 Docker Desktop(对 Shopware 这类 vendor/ 目录很重的应用,VirtioFS 帮助很大);这是 Docker Desktop 的特性,并非 Laradock 特有。
这和生产环境的 Docker 方案一样吗?
容器本身是生产风格的(真正的 NGINX + PHP-FPM),因此比原生安装更接近生产环境。加固步骤见生产环境准备文档。
想对比不同环境方案?完整对比见 Laradock vs Others。准备上手?Getting Started 大约五分钟即可完成。