Upgrade Compatibility Tool Fehlermeldungen
Diese Fehlermeldungsreferenz enthält Informationen zu Fehlern, die beim Ausführen der Upgrade Compatibility Tool auftreten können.
Fehlermeldungen werden nach Ebene (kritische Probleme, Fehler und Warnungen) und Typ (Kern-Code, benutzerdefinierter Code und GraphQL-Schemata) kategorisiert. Jeder Typ enthält die folgenden Informationen:
- Fehlercode: Die von Adobe Commerce zugewiesene Kennung für die Fehlermeldung.
- Fehlerbeschreibung: Eine Beschreibung, die die Ursache des Fehlers zusammenfasst.
- Vorgeschlagene Fehleraktion: Bietet gegebenenfalls Anleitungen zur Fehlerbehebung und Fehlerbehebung.
Kritische Probleme
Kerncode
Diese Fehler werden gemeldet, wenn einige der Kerndateien fehlen oder nicht mit dem Original übereinstimmen.
composer install Befehl im Stammverzeichnis des Projekts aus.composer install Befehl im Stammverzeichnis des Projekts aus.composer require package_name wieder her.composer install Befehl im Stammverzeichnis des Projekts aus.Benutzerdefinierter Code
Kritische Fehler treten auf, wenn der benutzerdefinierte Code auf Entitäten verweist, die in der Adobe Commerce-Zielversion nicht vorhanden sind. Diese Fehler werden auch gemeldet, wenn kritische Codierungsstandards verletzt wurden.
@api markierte Klasse zu verwenden. Instanziieren einer nicht vorhandenen Adobe Commerce-Klasse/-Schnittstelle.@api markierte Klasse zu verwenden.@api markierte Klasse zu verwenden.@api markierte Klasse zu verwenden.@api markierte Klasse zu verwenden.@api markierte Klasse zu verwenden.@api markierte Klasse zu verwenden.@api markierte Klasse zu verwenden.@api markierte Klasse zu verwenden. Aktualisieren Sie die Zugriffsebene der Eigenschaft auf „Privat“, wenn sie nur innerhalb einer einzelnen Klasse verwendet werden kann.DB-Schema
Wichtige Probleme mit dem DB-Schema werden gemeldet, wenn entfernte Kerntabellen oder -spalten durch benutzerdefinierte Einschränkungen referenziert werden.
GraphQL-Schema
GraphQL-Schemakritische Probleme treten auf, wenn die Schemaelemente in der Zielversion nicht vorhanden sind.
Fehler
Benutzerdefinierter Code
Fehler mit benutzerdefiniertem Code werden ausgelöst, wenn benutzerdefinierter Code die Adobe Commerce-Einstiegspunkte verwendet, die nicht als @api betrachtet/markiert sind. Das beibehaltene Verhalten solcher Einsprungspunkte ist nicht garantiert. Die Anpassung sollte stattdessen auf @api Einstiegspunkten basieren. Die Funktion, die auf Nicht-API-Adobe Commerce-Code basiert, sollte nach dem Upgrade getestet werden. Diese Fehler werden auch gemeldet, wenn wichtige Codierungsstandards verletzt wurden.
@api gekennzeichnet sind, können geändert werden. Aktualisieren Sie den Code ggf. so, dass stattdessen die als @api markierte Schnittstelle verwendet wird. Andernfalls sollten die Funktionen, die sich auf diese Implementierung stützen, nach dem Upgrade getestet werden.@api markierte Klasse zu verwenden.@api markierte Klasse zu verwenden. Andernfalls sollten die Funktionen, die sich auf diese Implementierung stützen, nach dem Upgrade getestet werden.@api markierte Klasse zu verwenden. Andernfalls sollten die Funktionen, die sich auf diese Implementierung stützen, nach dem Upgrade getestet werden.@api markierte Klasse zu verwenden. Andernfalls sollten die Funktionen, die sich auf diese Implementierung stützen, nach dem Upgrade getestet werden.@api gekennzeichnet sind, können geändert werden. Stattdessen sollte eine private Konstante des erforderlichen Werts im benutzerdefinierten Code eingeführt und verwendet werden.@api gekennzeichnet sind, können geändert werden. Stattdessen sollte eine private Konstante des erforderlichen Werts im benutzerdefinierten Code eingeführt und verwendet werden.@api gekennzeichnet sind, können geändert werden. Stattdessen sollte eine private Konstante des erforderlichen Werts im benutzerdefinierten Code eingeführt und verwendet werden.@api gekennzeichnet sind, können geändert werden. Erwägen Sie, diese Vererbung zu entfernen oder durch eine Vererbung von der als @api markierten Adobe Commerce-Schnittstelle oder einer im Umfang des Anpassungscodes eingeführten Schnittstelle zu ersetzen.@api gekennzeichnet sind, können geändert werden. Erwägen Sie, diese Vererbung zu entfernen oder durch eine Vererbung von der als @api markierten Adobe Commerce-Schnittstelle oder einer im Umfang des Anpassungscodes eingeführten Schnittstelle zu ersetzen.@api gekennzeichnet sind, können geändert werden. Stattdessen sollte eine private Konstante des erforderlichen Werts im benutzerdefinierten Code eingeführt und verwendet werden.@api gekennzeichnet sind, können geändert werden. Erwägen Sie, diese Vererbung zu entfernen oder durch eine Vererbung von der als @api markierten Adobe Commerce-Schnittstelle oder einer im Umfang des Anpassungscodes eingeführten Schnittstelle zu ersetzen.@api gekennzeichnet sind, können geändert werden. Aktualisieren Sie den Code ggf. so, dass stattdessen die als @api markierte Schnittstelle verwendet wird. Andernfalls sollten die Funktionen, die sich auf diese Implementierung stützen, nach dem Upgrade getestet werden. Die empfohlene Methode zum Abrufen einer Instanz der -Klasse ist auch die Verwendung von ID. Erwägen Sie die Verwendung einer Factory, wenn eine neue Instanz der Klasse erforderlich ist.@api gekennzeichnet sind, können geändert werden. Aktualisieren Sie den Code ggf. so, dass stattdessen die als @api markierte Schnittstelle verwendet wird. Andernfalls sollten die Funktionen, die sich auf diese Implementierung stützen, nach dem Upgrade getestet werden.@api gekennzeichnet oder nicht in der API-Klasse/-Schnittstelle deklariert sind, können geändert werden. Selbst wenn die Schnittstelle der Methode in der neuen Version nicht aktualisiert wird, kann ihr Verhalten oder ihre Ausgabe unterschiedlich sein. Erwägen Sie, sich auf eine Schnittstellenmethode zu verlassen. Andernfalls sollten die Funktionen, die sich auf diese Implementierung stützen, nach dem Upgrade getestet werden.@api gekennzeichnet sind, können geändert werden. Stattdessen sollte die API-Schnittstellenmethode verwendet werden.@api gekennzeichnet sind, können geändert werden. Stattdessen sollte die API-Schnittstellenmethode verwendet werden.@api gekennzeichnet sind, können geändert werden. Stattdessen sollte die API-Schnittstellenmethode verwendet werden.@vars Kommentarblock enthält ungültige JSON-Dateien@vars Kommentarblock enthält ungültige Beschriftung@vars fehlt eine in der Vorlage verwendete Variable"active" ist veraltet<param> ist veraltet<argument name="..." xsi:type="..."> .<instance> ist veraltet<argument name="..." xsi:type="object"> .<array> ist veraltet<argument name="..." xsi:type="array"> .<item key="..."> ist veraltet<item name="..." xsi:type="..."> .<value> ist veraltet<supported_blocks><supported_containers> zu ersetzen.<block_name><container_name> zu ersetzen."text/javascript" Typ-Attribut nicht verwendenBlock Klasse ist in HTML-Vorlagen veraltetgetConnection() Methode .Zend_Db_Select ist eingeschränkt\Magento\Framework\DB\Select.Zend_Db_Adapter_Pdo_Mysql ist eingeschränkt\Magento\Framework\DB\Adapter\Pdo\Mysql.Magento\Framework\Serialize\Serializer\Serialize ist eingeschränktMagento\Framework\Serialize\SerializerInterface.ArrayObject ist eingeschränktArrayObject mit überschriebenen serialize/unserialize-Methoden.Magento\Framework\View\Element\UiComponent\ArrayObjectFactory ist eingeschränktArrayObject mit überschriebenen serialize/serialize-Methoden erweitert wurde.output="toHtml" ist veraltetoutput="1" verwenden.\Magento\Framework\View\Element\Text\ListText sollte nicht mehr im Layout verwendet werden\Magento\Framework\View\Element\Text\ListText aus dem Layout.<action> ist nicht zulässig<action>.helper Attribut enthält // aus dem Hilfsattribut.helper Attribut enthält keine :::: zum Helper-Attribut hinzu.{{htmlescape}} ist überholt{{var}} .{{escapehtml}} ist überholt{{var}} .getChildHtml() nicht mehr benötigtgetChildHtml().getChildHtml() nicht mehr benötigtgetChildHtml().final private gefundenfinal private in nur private.__set_state ist nicht als static definiert__set_state muss als static definiert werden.__toString() Methode erbt nicht von Stringable SchnittstelleStringable Methode __toString() Schnittstelle zur Klasse hinzu.is_resource() Methode, die für Funktionen verwendet wird, die jetzt Object zurückgebenis_resource() in instanceof -Objekt.jQuery.andSelf() entferntjQuery.addBack() verwenden.$.bind und $.unbind sind veraltet$.on und $.off..on("event name", fn) -Methode, um dieses Ereignis zu abonnieren..trigger("event name") -Methode, um dieses Ereignis in einen Trigger aufzunehmen.$.delegate und $.undelegate sind veraltet$.on und $.off.jQuery.load() / jQuery.unload() / jQuery.error()) wurde entfernt.on("load", fn) / .on("unload", fn) / .on("error", fn)).jQuery.size() entferntjQuery.length verwenden.jQuery.trim ist veraltetString.prototype.trim verwenden.addButton, addContextToolbar, addMenuItem, addSidebar, file_browser_callback, insert_button_items, Design „inlite“, Design „mobile“, Design „modern„) wird entferntjQuery.isFunction() ist veraltetjQuery.type() ist veraltetjQuery.isArray() ist veraltetjQuery.parseJSON() ist veraltetjQuery.expr[":"], jQuery.expr.filters) ist veraltetDB-Schema
DB-Schemafehler werden ausgelöst, wenn die Datenbanktabellen, -spalten, -indizes oder -einschränkungen, die in der Zielversion von Adobe Commerce hinzugefügt oder entfernt wurden, zu Konflikten mit dem benutzerdefinierten Datenbankschema führen können.
Warnungen
Kerncode
Diese Warnungen werden gemeldet, wenn kleinere Inkonsistenzen in der Code-Basis des Kerns vorliegen.
composer update <package_name> ausführen.Benutzerdefinierter Code
Warnhinweise für benutzerspezifischen Code werden ausgelöst, wenn Verweise auf veralteten Code erkannt werden. Solche Verweise sollten durch die unterstützten Erweiterungspunkte ersetzt werden. Achten Sie bei Empfehlungen auf die @see Anmerkung veralteter Elemente. Diese Fehler werden auch gemeldet, wenn kleinere Codierungsstandards verletzt wurden.
@deprecated@api markierte Klasse zu verwenden.@deprecated-Klasse importieren@api markierte Adobe Commerce-Klasse verwenden.@deprecated-Klasse wird geladen@api markierte Adobe Commerce-Klasse verwenden.@deprecated@api markierte Adobe Commerce-Klasse verwenden.@deprecatedKonstante@api markiert ist, oder eine private Konstante in Ihrer Implementierung.@deprecatedKonstante@api markiert ist, oder eine private Konstante in Ihrer Implementierung.@deprecated Konstante@api markiert ist, oder eine private Konstante in Ihrer Implementierung.@deprecated@api gekennzeichnet ist.@deprecatedBenutzeroberfläche@api gekennzeichnet ist.@deprecated geerbt@api markierte Schnittstelle oder eine innerhalb Ihrer Implementierung eingeführte Schnittstelle verwenden.@deprecated@api markierte Schnittstelle oder eine innerhalb Ihrer Implementierung eingeführte Schnittstelle verwenden.@deprecated aufrufen@deprecated-Eigenschaft@deprecated-Eigenschaft@deprecated Adobe CommercegetResource() zum Speichern/Laden/Löschen von Daten erkannt.GraphQL-Schema
GraphQL-Schemawarnungen werden ausgelöst, wenn die zusätzlichen Elemente in der neuen Version zum Schema hinzugefügt werden. Es wird empfohlen, die Implementierung zu überprüfen, um festzustellen, ob sie für Anfragen verwendet werden sollten.