基于Symfony Flex的Shopware 6.4升级至6.5的Composer命令行方案

数据老陈

2026-7-22

基于Symfony Flex模板的Shopware 6.4.20.0升级至6.5的Composer/命令行操作指南

备份项目与数据库
开发环境也别偷懒，先把整个项目文件夹打包备份，同时导出数据库快照，避免升级出问题后回滚麻烦。
更新composer.json的版本约束
打开项目根目录的composer.json，找到所有以shopware/开头的依赖项，把它们的版本约束从6.4.*（或其他锁定6.4版本的规则，比如~6.4.20）修改为6.5.*。示例修改：
```
// 原内容
"shopware/core": "6.4.*",
"shopware/administration": "6.4.*",
// 修改后
"shopware/core": "6.5.*",
"shopware/administration": "6.5.*",
```
执行Composer升级
在项目根目录的命令行中运行以下命令，精准升级Shopware相关包及其依赖：
```
composer update shopware/* --with-all-dependencies
```
这个命令会专门处理Shopware包的版本升级，同时自动更新关联的依赖库，比直接composer update更高效，避免无关包的不必要更新。
执行Shopware系统升级操作
依赖更新完成后，运行Shopware自带命令处理数据库迁移和系统配置：
- 准备升级环境：
```
bin/console system:update:prepare
```
- 执行全量数据库迁移：
```
bin/console database:migrate --all
```
- 清理缓存：
```
bin/console cache:clear
```
- 编译主题（若使用自定义主题）：
```
bin/console theme:compile
```
更新前端资源（建议执行）
Shopware 6.5对前端资源有更新，进入vendor/shopware/administration/Resources/app/administration目录，运行：
```
npm install
npm run build
```
若项目有自定义前端代码，同步更新依赖并重新构建即可。
验证升级结果
启动本地开发服务器，访问后台和前台，检查功能是否正常、有无报错。如果出现问题，直接用之前的备份回滚排查。