prestashop-update

PrestaShop - 更新到较新版本的 PrestaShop

要求

询问用户：

• 商店中模块 autoupgrade 的路径。它可能位于 Docker 容器中，也可能需要通过 SSH 会话访问。
• 如果不知道管理后台目录名称，请询问用户。运行命令时需要用到该名称。

用法：

• Update Assistant 的命令通过 [module_path]/bin/console 运行，
• 在末尾添加 --help 可查看命令详情。
• 参数 -q 可避免显示不必要的内容。如果需要查看备份、更新或还原后的日志，可在 [admin_path]/autoupgrade/logs/ 中找到，文件名格式为 [year]-[month]-[day]-[time]-[action].txt。

步骤

• 运行 update:check-new-version 并显示可用版本（GATE）。可能会显示 3 个渠道：online_recommended（默认）、online 或 local。online_recommended 和 online 不一定总会显示。local 要求较新版本的 PrestaShop 的 zip 和 xml 文件位于 [shop_admin]/autoupgrade/download/ 中。请用户选择后续步骤将使用的渠道
• 运行 update:check-requirements，检查商店的兼容性。显示具体反馈时，可以执行额外检查：
  • 如果核心文件已修改（index.php 文件和模块除外），可以通过将文件与 GitHub 上的原始文件进行差异比较，评估这些更改对商家的影响程度。原始文件 URL 为 https://raw.githubusercontent.com/PrestaShop/PrestaShop/refs/tags/[prestashop_source_version]/[path_to_file_from_root_store]（必须将占位符替换为实际值）。如果这些更改对业务至关重要，建议将其移至 模块，以免丢失；或者，作为最后的手段，使用 覆盖。
  • 如果主题文件已修改（index.php 文件除外），可以通过将文件与 GitHub 上的原始文件进行差异比较，评估这些更改对商家的影响程度。原始文件 URL 为 https://raw.githubusercontent.com/PrestaShop/[theme_name]/refs/tags/[version_in_config/theme.yml_of_the_theme]/[path_to_file_from_root_store]（必须将占位符替换为实际值）。如果这些更改对业务至关重要，建议将其移至 子主题，以免丢失。此操作仅适用于评估 PrestaShop 默认主题的更改：classic 和 hummingbird。
• 在 https://github.com/PrestaShop/autoupgrade/discussions/categories/known-issues?discussions_q=is%3Aopen+category%3A%22Known+issues%22+label%3A%22Impacts%3A+[version]%22 查看与当前版本的 Update Assistant 相关的帖子，将 [version] 替换为该模块当前的主版本号和次版本号。运行 [module_path]/bin/console（不带任何参数）即可找到该版本号。
• 使用下方的严重性级别，总结错误、警告和成功项，并明确给出是否可以继续的建议。如果存在错误，请调查并请求确认是否修复（如果有办法自动修复，则自动修复；等待用户提出修复方案；或等待用户自行修复），然后再次运行该命令（GATE）。
• 没有错误时（警告可以接受），询问用户是否要继续更新（GATE）。
• 使用 backup:create -q 备份商店。根据商店大小，此过程可能需要较长时间。
• 使用 update:start -q 运行更新（TODO：添加参数，以便在分析中获知该命令由 Agent 运行）。根据商店大小，此过程可能需要较长时间。
• 如果流程以成功消息结束，请告知用户可以使用商店，并确认一切运行正常（GATE）。
• 如果出现问题，可以使用 backup:restore 恢复 Update Assistant 创建的备份。根据商店大小，此过程可能需要较长时间。

严重性级别

标记	严重性	含义
🔴	错误	更新前必须解决的问题
🟡	警告	轻微问题，值得修复，但不会阻碍更新
🟢	正常	检查未发现需要修复的问题，或已确认准备就绪