Laden Sie die Upgrade Compatibility Tool herunter.

Um mit dem Upgrade Compatibility Tool in einer Befehlszeilenschnittstelle zu beginnen, laden Sie es herunter, indem Sie den folgenden Befehl ausführen:

composer create-project magento/upgrade-compatibility-tool uct --repository https://repo.magento.com

Möglicherweise müssen Sie dem ausführbaren Tool Berechtigungen mit dem Befehl chmod erteilen:

chmod +x ./uct/bin/uct

Die Upgrade Compatibility Tool in einer Befehlszeilenschnittstelle

Der Upgrade Compatibility Tool ist ein Tool, das eine benutzerdefinierte Adobe Commerce-Instanz anhand einer bestimmten Version prüft, indem alle darin installierten Module analysiert werden. Es wird eine Liste kritischer Probleme, Fehler und Warnungen zurückgegeben, die behoben werden müssen, bevor auf die neueste Version von Adobe Commerce aktualisiert wird.

Weitere Informationen zum Upgrade Compatibility Tool finden Sie in diesem Video-Tutorial (06:02) .

Verfügbare Befehle für die Upgrade Compatibility Tool in einer Befehlszeilenschnittstelle:

Verwenden Sie den Befehl upgrade:check .

Der Befehl upgrade:check prüft, ob Kerncodeänderungen für diese bestimmte Adobe Commerce-Instanz und alle darin installierten Änderungen an benutzerdefiniertem Code vorgenommen wurden.

Der Befehl upgrade:check ist der Hauptbefehl zum Ausführen des Tools:

bin/uct upgrade:check <dir>

Dabei ist der Wert <dir> der Ordner, in dem sich Ihre Adobe Commerce-Instanz befindet.

Verfügbare Optionen für den Befehl upgrade:check :

Mit dem Upgrade Compatibility Tool können Sie den Befehl upgrade:check mit der Option --ignore-current-version-compatibility-issues ausführen. Verwenden Sie diese Option, wenn Sie nur neue Probleme erhalten möchten, die mit der Aktualisierung von Ihrer aktuellen Version auf die gewünschte Version in Ihrem Upgrade Compatibility Tool -Bericht eingeführt werden:

bin/uct upgrade:check --ignore-current-version-compatibility-issues <dir>

Hinzufügen der --coming-version-Option

Sie können Ihre aktuelle Adobe Commerce-Installation mit einer beliebigen Adobe Commerce-Version >=2.3 vergleichen, indem Sie die Option --coming-version verwenden.

Sie müssen die Version als Parameter angeben, wenn Sie den Befehl upgrade:check ausführen:

bin/uct upgrade:check <dir> -c 2.4.3

Dabei bezieht sich -c, --coming-version[=COMING-VERSION] auf die Targeting-Version von Adobe Commerce.

Beim Ausführen von --coming-version gibt es einige Einschränkungen:

Verwenden Sie den Befehl dbschema:diff .

Sie können den Unterschied zwischen dem Datenbankschema von zwei Adobe Commerce-Versionen abrufen.

bin/uct dbschema:diff <current-version> <target-version>

Wenn die Argumente wie folgt lauten:

Anwendungsbeispiel:

bin/uct dbschema:diff 2.4.3 2.4.3-p3

DB schema differences between versions 2.4.3 and 2.4.3-p3:

Table klarna_payments_quote constraint QUOTE_ID_KLARNA_PAYMENTS_QUOTE_QUOTE_ID_QUOTE_ENTITY_ID is present only in version 2.4.3-p3
Table klarna_payments_quote index KLARNA_PAYMENTS_QUOTE_SESSION_ID is present only in version 2.4.3-p3
Table customer_entity column session_cutoff is present only in version 2.4.3-p3
Table customer_visitor column session_id length value is different. 2.4.3: "64", 2.4.3-p3: "1"
Table customer_visitor column session_id comment value is different. 2.4.3: "Session ID", 2.4.3-p3: "Deprecated: Session ID value no longer used"
Table customer_visitor column created_at is present only in version 2.4.3-p3
Table oauth_consumer column secret length value is different. 2.4.3: "32", 2.4.3-p3: "128"
Table oauth_token column secret length value is different. 2.4.3: "32", 2.4.3-p3: "128"
Table admin_user_session column session_id nullable value is different. 2.4.3: "false", 2.4.3-p3: "true"
Table admin_user_session column session_id length value is different. 2.4.3: "128", 2.4.3-p3: "1"
Table admin_user_session column session_id comment value is different. 2.4.3: "Session ID value", 2.4.3-p3: "Deprecated: Session ID value no longer used"

Total detected differences between version 2.4.3 and 2.4.3-p3: 11

Verwenden Sie den Befehl core:code:changes .

Sie können Ihre aktuelle Adobe Commerce-Installation mit der Überprüfung vergleichen, ob der Kerncode von Adobe Commerce zur Implementierung einer Anpassung geändert wurde. Dieser Befehl zeigt nur eine Liste der wichtigsten Änderungen:

bin/uct core:code:changes <dir> <vanilla dir>

Wenn die Argumente wie folgt lauten:

Verfügbare Optionen für den Befehl core:code:changes :

Vanilla-Installation

Bei einer Installation von Vanilla handelt es sich um eine saubere Installation eines angegebenen Versions-Tags oder Zweigs für eine bestimmte Release-Version.

Der Befehl bin/uct core:code:changes prüft, ob sich in Ihrem System eine Vanilla-Instanz befindet. Wenn Sie zum ersten Mal eine Vanilla-Installation verwenden, werden Sie bei einer interaktiven Befehlszeilenfrage aufgefordert, das Vanilla-Projekt aus dem Adobe Commerce-Repository (https://repo.magento.com/) herunterzuladen.

Sie können den Befehl Upgrade Compatibility Tool mit der Option --vanilla-dir ausführen, um den Installationsordner für Adobe Commerce Vanilla anzugeben.

Weitere Informationen finden Sie im Thema Vanilla-Instanz bereitstellen .

Verwenden Sie den Befehl refactor .

Der Upgrade Compatibility Tool kann eine reduzierte Anzahl von Problemen automatisch beheben:

Führen Sie dazu den Befehl refactor aus:

bin/uct refactor <dir>

Dabei ist der Wert <dir> der Ordner, in dem sich Ihre Adobe Commerce-Instanz befindet.

Verfügbare Optionen für den Befehl refactor :

Verwenden Sie den Befehl graphql:compare .

Dieser Befehl bietet die Möglichkeit für die Upgrade Compatibility Tool, zwei GraphQL-Endpunkte zu überprüfen und ihre Schemas zu vergleichen, um nach riskanten und gefährlichen Änderungen zwischen ihnen zu suchen:

bin/uct graphql:compare <schema1> <schema2>

Wenn die Argumente wie folgt lauten:

Verfügbare Optionen für den Befehl graphql:compare :

Verwenden Sie den Befehl list .

Um eine Liste der verfügbaren Upgrade Compatibility Tool -Befehle zurückzugeben, führen Sie Folgendes aus:

bin/uct list

Verwenden Sie den Befehl help .

Um den Befehl Upgrade Compatibility Tool mit allgemeinen Optionen und Hilfe anzuzeigen, führen Sie Folgendes aus:

bin/uct --help

Dadurch wird eine Liste mit allen verfügbaren help -Optionen für die Upgrade Compatibility Tool in einer Befehlszeilenschnittstelle zurückgegeben:

- --raw             To output raw command list
- --format=FORMAT   The output format (txt, xml, json, or md) [default: "txt"]
- --short           To skip describing commands' arguments
- -h, --help            Display help for the given command. When no command is given display help for the list command
- -q, --quiet           Do not output any message
- -V, --version         Display this application version
- --ansi|--no-ansi  Force (or disable --no-ansi) ANSI output
- -n, --no-interaction  Do not ask any interactive question
- -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

Es ist möglich, --help als Option auszuführen, wenn ein bestimmter Befehl ausgeführt wird. Es werden --help -Optionen für den angegebenen Befehl zurückgegeben.

Beispiel des Befehls upgrade:check mit der Option --help:

bin/uct upgrade:check --help

Dadurch werden bestimmte Optionen zurückgegeben, die für den Befehl upgrade:check ausgeführt werden können:

- -a, --current-version[=CURRENT-VERSION]: Current Adobe Commerce version, version of the Adobe Commerce installation will be used if omitted.
- -c, --coming-version[=COMING-VERSION]: Target Adobe Commerce version, latest released version of Adobe Commerce will be used if omitted. Provides a list of all available Adobe Commerce versions.
- --json-output-path[=JSON-OUTPUT-PATH]: Path of the file where the output will be exported in json format.
- --html-output-path[=HTML-OUTPUT-PATH]: Path of the file where the output will be exported in HTML format.
- --min-issue-level[=MIN-ISSUE-LEVEL]            Minimal issue level you want to see in the report (warning, error or critical). [default: "warning"]
- -i, --ignore-current-version-compatibility-issues  Ignore common issues for current and coming version
- --context=CONTEXT: Execution context. This option is for integration purposes and does not affect the execution result.
- -h, --help: Display help for that specific command. If no command is provided, `list` command is the default result.
- -q, --quiet: Do not output any messages while executing the command.
- -v, --version: Display application version.
- --ansi, --no-ansi: Enable ANSI output.
- -n, --no-interaction: Do not ask any interactive question while executing the command.
- -v, --vv, --vvv, --verbose: Increase verbosity of output communications. 1 for normal output, 2 for verbose output, and 3 for DEBUG output.

Befolgen Sie die Best Practices für Adobe Commerce

Ergebnisse optimieren

Der Upgrade Compatibility Tool stellt einen Bericht mit Ergebnissen bereit, in dem alle in Ihrem Projekt standardmäßig identifizierten Probleme aufgeführt sind. Sie können die Ergebnisse optimieren, um sich auf die Probleme zu konzentrieren, die Sie beheben müssen, um das Upgrade abzuschließen: