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）。表示されるチャンネルは、デフォルトの online_recommended、online、local の3つです。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]（プレースホルダーは実際の値に置き換える必要があります）。変更がビジネスにとって重要な場合は、変更を失わないよう、[モジュール](https://devdocs.prestashop-project.org/9/modules/creation/)に移すことを推奨します。最後の手段として、[オーバーライド](https://devdocs.prestashop-project.org/9/modules/concepts/overrides/)を使用することもできます。
  • テーマファイル（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]（プレースホルダーは実際の値に置き換える必要があります）。変更がビジネスにとって重要な場合は、変更を失わないよう、[子テーマ](https://devdocs.prestashop-project.org/9/themes/reference/template-inheritance/parent-child-feature/)に移すことを推奨します。これは、PrestaShop のデフォルトテーマである classic と hummingbird の変更を評価する場合に限ります。
• 現在の Update Assistant のバージョンに関連する投稿を、https://github.com/PrestaShop/autoupgrade/discussions/categories/known-issues?discussions_q=is%3Aopen+category%3A%22Known+issues%22+label%3A%22Impacts%3A+[version]%22 で確認します。[version] をモジュールの現在の major.minor バージョンに置き換えてください。このバージョンは、パラメーターを指定せずに [module_path]/bin/console を実行すると確認できます。
• 以下の重要度レベルを使用して、エラー、警告、成功の概要を示し、更新の実施可否を明確に推奨します。エラーがある場合は調査し、修正するための確認を求めます（自動で修正する方法があれば自動で修正する、ユーザーから修正案が提示されるまで待つ、ユーザー自身が修正するまで待つ）。その後、コマンドを再実行します（GATE）。
• エラーがなくなった場合（警告は許容されます）、更新を続行するかユーザーに確認します（GATE）。
• backup:create -q でストアをバックアップします。ストアのサイズによっては、時間がかかる処理です。
• update:start -q で更新を実行します（TODO: 分析でエージェントがコマンドを実行したことを識別するためのパラメーターを追加）。ストアのサイズによっては、時間がかかる処理です。
• 処理が成功メッセージで終了した場合は、ストアを使用できることをユーザーに伝え、すべてが想定どおりに動作することを確認します（GATE）。
• 問題が発生した場合は、Update Assistant が作成したバックアップを backup:restore で復元できます。ストアのサイズによっては、時間がかかる処理です。

重要度レベル

マーカー	重要度	意味
🔴	エラー	更新前に修正が必要な問題
🟡	警告	軽微な問題です。修正が望ましいものの、更新を妨げるものではありません
🟢	OK	修正すべき点が見つからなかった、または準備が整っていることを確認したチェック