- 切换到维护模式以防止在升级过程中访问存储区。
- 在异步进程(如消息队列使用者)运行时启动升级过程可能会导致数据损坏。 要防止数据损坏,请禁用所有cron作业。
- 手动启动所有消息队列使用者,以确保使用所有消息。
等待cron作业完成。 您可以使用进程查看器或多次运行
ps aux | grep 'bin/magento queue'
命令来监视作业的状态,直到所有进程都完成为止。 - 创建
composer.json
文件的备份。 - 根据您的需求添加或删除特定包。例如,如果您要从Magento Open Source升级到Adobe Commerce,请删除Magento Open Source包。
您还可以升级示例数据。
- Magento Open Source:
- Magento Open Source:
- 使用以下
composer require-commerce
命令语法升级实例:命令选项包括:
<product>
— (必需)要升级的包。 对于内部部署,此值必须为product-community-edition
或product-enterprise-edition
。<version>
— (必需)要升级到的Adobe Commerce版本。 例如,2.4.3
。--no-update
— (必需)禁用依赖项的自动更新。--interactive-root-conflicts
— (可选)允许您以交互方式查看和更新以前版本的任何过期值,或与要升级到的版本不匹配的自定义值。--force-root-updates
— (可选)使用预期的Commerce值覆盖所有冲突的自定义值。--help
— (可选)提供有关插件的使用情况详细信息。
如果未指定
--interactive-root-conflicts
或--force-root-updates
,该命令将保留冲突的现有值并显示一条警告消息。 要了解有关该插件的更多信息,请参阅插件使用自述文件。 - 更新依赖关系。
示例 — 列出可用版本
要查看可用2.4.x版本的完整列表,请执行以下操作:
Magento Open Source:
示例 — 质量修补程序
质量修补程序主要包含功能性 和 安全修补程序。 但是,它们有时可以包含向后兼容的新功能。 使用Composer下载质量修补程序。
Magento Open Source:
示例 — 安全修补程序
安全修补程序仅包含安全修补程序。 它们旨在使升级过程更快、更轻松。 安全修补程序使用Composer命名约定2.4.x-px
。
Magento Open Source:
更新元数据
- 根据需要更新
composer.json
文件中的"name"
、"version"
和"description"
字段。注意更新composer.json
文件中的元数据完全是表面性的,无法正常使用。 - 应用更新。
- 清除
var/
和generated/
子目录:注意如果您使用文件系统以外的缓存存储,如Redis或Memcached,则也必须手动清除其中的缓存。 - 更新数据库架构和数据。
- 禁用维护模式。
- (可选) 重新启动Varnish。如果将Varnish用于页面缓存,请重新启动它:
检查您的工作
要检查升级是否成功,请在Web浏览器中打开店面URL。 如果升级不成功,您的店面将无法正确加载。
如果应用程序失败并出现We're sorry, an error has occurred while generating this email.
错误:
- 将文件系统所有权和权限重置为具有
root
权限的用户。 - 清除以下目录:
var/cache/
var/page_cache/
generated/code/
- 再次在Web浏览器中查看您的店面。