Upgrade Compatibility Tool エラーメッセージ
このエラーメッセージのリファレンスでは、Upgrade Compatibility Tool の実行中に発生する可能性のあるエラーに関する情報を提供します。
エラーメッセージはレベル(重大な問題、エラー、警告)およびタイプ(コアコード、カスタムコード、GraphQL スキーマ)別に分類されます。 各タイプには、次の情報が含まれます。
- エラーコード:エラーメッセージにAdobe Commerceによって割り当てられた識別情報。
- エラーの説明: エラーの原因を要約した説明。
- エラーの推奨アクション:該当する場合は、エラーのトラブルシューティングと解決に関するガイダンスを提供します。
重大な問題
コアコード
これらのエラーは、一部のコアファイルが欠落しているか、元のファイルと一致しない場合に報告されます。
composer install コマンドを実行します。composer install コマンドを実行します。composer require package_name を実行して依存関係を復元します。composer install コマンドを実行します。カスタムコード
対象のAdobe Commerce バージョンに存在しないエンティティをカスタムコードが参照している場合、重大なエラーが発生します。 これらのエラーは、重要なコーディング標準が破られている場合にも報告されます。
@api とマークされたクラスを使用するようにコードを更新します。 存在しないAdobe Commerce クラス/インターフェイスをインスタンス化しています。@api とマークされたクラスを使用するようにコードを更新します。@api とマークされたクラスを使用するようにコードを更新します。@api とマークされたクラスを使用するようにコードを更新します。@api とマークされたクラスを使用するようにコードを更新します。@api とマークされたクラスを使用するようにコードを更新します。@api とマークされたクラスを使用するようにコードを更新します。@api とマークされたクラスを使用するようにコードを更新します。@api とマークされたクラスを使用するようにコードを更新します。 単一のクラス内でのみ使用できる場合は、プロパティアクセスレベルを private に更新します。DB スキーマ
削除されたコアテーブルまたは列がカスタム制約によって参照されている場合、DB スキーマの重大な問題が報告されます。
GraphQL スキーマ
ターゲットバージョンにスキーマ項目が存在しない場合、GraphQL スキーマの重大な問題が発生します。
エラー
カスタムコード
カスタムコードエラーは、カスタムコードが @api と見なされないまたはマークされたAdobe Commerce エントリポイントを使用している場合に発生します。 このようなエントリポイントの動作は保証されません。 このカスタマイズは、代わりに @api のエントリポイントに依存する必要があります。 API 以外のAdobe Commerce コードに基づく機能は、アップグレード後にテストする必要があります。 これらのエラーは、主要なコーディング標準が機能しなくなった場合にも報告されます。
@api としてマークされていないクラスは変更できます。 コードを更新して、@api とマークされたインターフェイスに依存することを検討してください。 そうでない場合は、この実装に依存する機能をアップグレード後にテストする必要があります。@api とマークされたクラスを使用するようにコードを更新します。@api とマークされたクラスを使用するようにコードを更新します。 そうでない場合は、この実装に依存する機能をアップグレード後にテストする必要があります。@api とマークされたクラスを使用するようにコードを更新します。 そうでない場合は、この実装に依存する機能をアップグレード後にテストする必要があります。@api とマークされたクラスを使用するようにコードを更新します。 そうでない場合は、この実装に依存する機能をアップグレード後にテストする必要があります。@api とマークされていない定数は変更できます。 代わりに、カスタムコード内で必要な値のプライベート定数を導入して使用することを検討してください。@api とマークされていない定数は変更できます。 代わりに、カスタムコード内で必要な値のプライベート定数を導入して使用することを検討してください。@api とマークされていない定数は変更できます。 代わりに、カスタムコード内で必要な値のプライベート定数を導入して使用することを検討してください。@api としてマークされていないインターフェイスは変更できます。 この継承を削除するか、@api とマークされているAdobe Commerce インターフェイスまたはカスタマイズコードの範囲に導入されているインターフェイスから継承に置き換えることを検討してください。@api としてマークされていないインターフェイスは変更できます。 この継承を削除するか、@api とマークされているAdobe Commerce インターフェイスまたはカスタマイズコードの範囲に導入されているインターフェイスから継承に置き換えることを検討してください。@api とマークされていない定数は変更できます。 代わりに、カスタムコード内で必要な値のプライベート定数を導入して使用することを検討してください。@api としてマークされていないインターフェイスは変更できます。 この継承を削除するか、@api とマークされているAdobe Commerce インターフェイスまたはカスタマイズコードの範囲に導入されているインターフェイスから継承に置き換えることを検討してください。@api としてマークされていないクラスは変更できます。 コードを更新して、@api とマークされたインターフェイスに依存することを検討してください。 そうでない場合は、この実装に依存する機能をアップグレード後にテストする必要があります。 また、クラスのインスタンスを取得する場合は、DI を使用することをお勧めします。 クラスの新しいインスタンスが必要な場合は、ファクトリの使用を検討してください。@api としてマークされていないクラスは変更できます。 コードを更新して、@api とマークされたインターフェイスに依存することを検討してください。 そうでない場合は、この実装に依存する機能をアップグレード後にテストする必要があります。@api としてマークされていないメソッドや、API クラス/インターフェイス内で宣言されていないメソッドは変更できます。 メソッドのインターフェイスが新しいバージョンで更新されていない場合でも、動作や出力は異なる場合があります。 インターフェイスメソッドを利用することを検討します。 そうでない場合は、この実装に依存する機能をアップグレード後にテストする必要があります。@api としてマークされていないプロパティの値は変更される場合があります。 代わりに、API インターフェイスメソッドを利用することを検討してください。@api としてマークされていないプロパティの値は変更される場合があります。 代わりに、API インターフェイスメソッドを利用することを検討してください。@api としてマークされていないプロパティの値は変更される場合があります。 代わりに、API インターフェイスメソッドを利用することを検討してください。@vars コメント ブロックに無効な JSON が含まれています@vars コメント ブロックに無効なラベルが含まれています@vars コメント ブロックに、テンプレートで使用されている変数がありません"active" 属性は廃止されました<param> ノードは廃止されました<argument name="..." xsi:type="..."> を使用します。<instance> ノードは廃止されました<argument name="..." xsi:type="object"> を使用します。<array> ノードは廃止されました<argument name="..." xsi:type="array"> を使用します。<item key="..."> ノードは廃止されました<item name="..." xsi:type="..."> を使用します。<value> ノードは廃止されました<supported_blocks><supported_containers> に置き換える必要があります。<block_name><container_name> に置き換える必要があります。"text/javascript" ないBlock クラスの protected メンバと private メンバへのアクセスは廃止されていますgetConnection() メソッドを使用します。Zend_Db_Select は制限されています\Magento\Framework\DB\Select。Zend_Db_Adapter_Pdo_Mysql は制限されています\Magento\Framework\DB\Adapter\Pdo\Mysql。Magento\Framework\Serialize\Serializer\Serialize は制限されていますMagento\Framework\Serialize\SerializerInterface。ArrayObject は制限されていますArrayObject から拡張されたカスタムクラス。Magento\Framework\View\Element\UiComponent\ArrayObjectFactory は制限されていますArrayObject から拡張されたカスタムクラスを作成するファクトリ。output="toHtml" は廃止されましたoutput="1" を使用します。\Magento\Framework\View\Element\Text\ListText は、レイアウトでは使用できなくなりました\Magento\Framework\View\Element\Text\ListText を削除します。<action> を使用したメソッドの呼び出しは許可されていません<action> で問題のあるメソッドを使用しないでください。helper 属性に / が含まれています/ を削除します。helper 属性に :: が含まれていません:: を追加します。{{htmlescape}} は廃止されています{{var}} を使用します。{{escapehtml}} は廃止されています{{var}} を使用します。getChildHtml() には、3 番目のパラメーターは不要になりましたgetChildHtml() への呼び出しから 3 番目のパラメーターを削除します。getChildHtml() には不要になりましたgetChildHtml() への呼び出しから 4 番目のパラメーターを削除します。final private が見つかりましたfinal private から private のみに変更します。__set_state は static として定義されていません__set_state は static として定義する必要があります。__toString() れていないメソッド Stringable 持つクラスStringable 使用して、クラスにインターフェイス __toString() 追加します。is_resource() 返す関数に使用されるメソッドis_resource() を instanceof Object に変更します。jQuery.andSelf() が削除されましたjQuery.addBack() を使用します。$.bind および $.unbind は非推奨(廃止予定)です。$.on と $.off を使用します。.on("event name", fn) メソッドを使用して、そのイベントを購読します。.trigger("event name")トリガーにするには、代わりにメソッドを使用します。$.delegate および $.undelegate は非推奨(廃止予定)です。$.on と $.off を使用します。jQuery.load() / jQuery.unload() / jQuery.error())が削除されました.on("load", fn)/.on("unload", fn)/.on("error", fn))を使用してください。jQuery.size() が削除されましたjQuery.length を使用します。jQuery.trim は非推奨ですString.prototype.trim を使用します。addButton、addContextToolbar、addMenuItem、addSidebar、file_browser_callback、insert_button_items、「インライト」テーマ、「モバイル」テーマ、「モダン」テーマ)が削除されましたjQuery.isFunction() は非推奨ですjQuery.type() は非推奨ですjQuery.isArray() は非推奨ですjQuery.parseJSON() は非推奨ですjQuery.expr[":"]、jQuery.expr.filters)は非推奨ですDB スキーマ
対象のAdobe Commerce バージョンで追加または削除されたデータベーステーブル、列、インデックス、または制約が、カスタムデータベーススキーマと競合する可能性がある場合に、DB スキーマエラーが発生します。
警告
コアコード
これらの警告は、コアコードベースに軽微な不一致がある場合に報告されます。
composer update <package_name> を実行して依存関係を更新します。カスタムコード
非推奨コードへの参照が検出されると、カスタムコードの警告が発生します。 このような参照は、サポートされる拡張ポイントに置き換える必要があります。 レコメンデーションについては、非推奨(廃止予定)の項目の @see 注釈に注意してください。 これらのエラーは、マイナーなコーディング標準が壊れている場合にも報告されます。
@deprecated クラスからの拡張@api とマークされたクラスを使用するようにコードを更新します。@deprecated クラスの読み込み@api とマークされたAdobe Commerce クラスの使用を検討してください。@deprecated クラスを読み込み中@api とマークされたAdobe Commerce クラスの使用を検討してください。@deprecated クラスの使用@api とマークされたAdobe Commerce クラスの使用を検討してください。@deprecated 定数の使用@api またはプライベート定数としてマークされた定数を使用することを検討してください。@deprecated 上書き@api またはプライベート定数としてマークされた定数を使用することを検討してください。@deprecated 定数の割り当て@api またはプライベート定数としてマークされた定数を使用することを検討してください。@deprecated インターフェイス@api とマークされたインターフェイスまたはクラスの使用を検討してください。@deprecated インターフェイスの使用@api とマークされたインターフェイスまたはクラスの使用を検討してください。@deprecated インターフェイスから継承@api とマークされたインターフェイスまたは実装内に導入されたインターフェイスを使用することを検討してください。@deprecated インターフェイスの実装@api とマークされたインターフェイスまたは実装内に導入されたインターフェイスを使用することを検討してください。@deprecated メソッドの呼び出し@deprecated プロパティの使用@deprecated プロパティの上書き@deprecated プロパティの割り当てgetResource() の使用により、データが(保存/読み込み/削除)検出されました。GraphQL スキーマ
新しいバージョンでスキーマに項目が追加されると、GraphQL スキーマの警告が発生します。 実装をレビューして、リクエストに使用する必要があるかどうかを確認することをお勧めします。