Download de Upgrade Compatibility Tool

Als u wilt beginnen met de Upgrade Compatibility Tool in een opdrachtregelinterface, downloadt u deze via de volgende opdracht:

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

U moet mogelijk uitvoerbare machtigingen voor het gereedschap opgeven met de opdracht chmod :

chmod +x ./uct/bin/uct

De Upgrade Compatibility Tool in een opdrachtregelinterface

Upgrade Compatibility Tool is een hulpmiddel dat een Adobe Commerce aangepaste instantie tegen een specifieke versie door alle modules controleert te analyseren die in het worden geïnstalleerd. Er wordt een lijst geretourneerd met kritieke problemen, fouten en waarschuwingen die moeten worden opgelost voordat u de upgrade naar de nieuwste versie van Adobe Commerce uitvoert.

Zie dit videoleerprogramma(06:02) om meer over Upgrade Compatibility Tool te leren.

Beschikbare opdrachten voor de Upgrade Compatibility Tool in een opdrachtregelinterface:

De opdracht upgrade:check gebruiken

De opdracht upgrade:check controleert op kerncodewijzigingen voor die specifieke Adobe Commerce-instantie en alle daarin geïnstalleerde aangepaste codewijzigingen.

De opdracht upgrade:check is de belangrijkste opdracht voor het uitvoeren van het gereedschap:

bin/uct upgrade:check <dir>

Waar <dir> -waarde de map is waarin uw Adobe Commerce-instantie zich bevindt.

Beschikbare opties voor de opdracht upgrade:check :

Met Upgrade Compatibility Tool kunt u de opdracht upgrade:check uitvoeren met een optie --ignore-current-version-compatibility-issues . Gebruik deze optie als u alleen nieuwe uitgaven wilt ophalen die worden geïntroduceerd met de update van uw huidige versie naar de doelversie in uw Upgrade Compatibility Tool -rapport:

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

De optie --coming-version toevoegen

Met de optie --coming-version kunt u de huidige Adobe Commerce-installatie vergelijken met elke Adobe Commerce-versie >=2.3 .

U moet de versie opgeven als parameter wanneer u de opdracht upgrade:check uitvoert:

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

Waar -c, --coming-version[=COMING-VERSION] verwijst naar de beoogde Adobe Commerce-versie.

Er zijn enkele beperkingen wanneer u --coming-version uitvoert:

De opdracht dbschema:diff gebruiken

U kunt het verschil tussen het databaseschema van twee Adobe Commerce-versies ophalen.

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

Waar de argumenten als volgt zijn:

Voorbeeld van uitvoering:

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

De opdracht core:code:changes gebruiken

U kunt uw huidige Adobe Commerce-installatie vergelijken om te valideren of de kerncode van Adobe Commerce is gewijzigd om een aanpassing te implementeren. Dit bevel toont een lijst van kernwijzigingen slechts:

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

Waar de argumenten als volgt zijn:

Beschikbare opties voor de opdracht core:code:changes :

Vanilla-installatie

A vanilla installatie is een schone installatie van een gespecificeerde versiemarkering of tak voor een specifieke versieversie.

De opdracht bin/uct core:code:changes controleert of er een vanilla-instantie in uw systeem is. Als dit de eerste keer gebruikend een vanilla installatie is, een interactieve bevel-lijn vraag u ertoe aanzet om het vanilleproject van de bewaarplaats van Adobe Commerce (https://repo.magento.com/) te downloaden.

U kunt een opdracht Upgrade Compatibility Tool uitvoeren met de optie --vanilla-dir om de installatiemap van Adobe Commerce vanilla op te geven.

Zie opstellen vanilla instantieonderwerp voor meer informatie.

De opdracht refactor gebruiken

Met Upgrade Compatibility Tool kunt u automatisch een beperkte set problemen verhelpen:

Hiervoor voert u de opdracht refactor uit:

bin/uct refactor <dir>

Waar <dir> -waarde de map is waarin uw Adobe Commerce-instantie zich bevindt.

Beschikbare opties voor de opdracht refactor :

De opdracht graphql:compare gebruiken

Deze opdracht biedt de Upgrade Compatibility Tool de mogelijkheid om twee GraphQL-eindpunten te bekijken en hun schema's te vergelijken op zoek naar onderbrekingen en gevaarlijke wijzigingen:

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

Waar de argumenten als volgt zijn:

Beschikbare opties voor de opdracht graphql:compare :

De opdracht list gebruiken

Voer de volgende handelingen uit om een lijst met de Upgrade Compatibility Tool beschikbare opdrachten te retourneren:

bin/uct list

De opdracht help gebruiken

Voer de volgende handelingen uit om de algemene opties en Help van de opdracht Upgrade Compatibility Tool weer te geven:

bin/uct --help

Dit retourneert een lijst met alle beschikbare help -opties voor de Upgrade Compatibility Tool in een opdrachtregelinterface:

- --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

--help kan als optie worden uitgevoerd wanneer een bepaalde opdracht wordt uitgevoerd. Er worden --help -opties voor de opgegeven opdracht geretourneerd.

Voorbeeld van de optie upgrade:check command met --help :

bin/uct upgrade:check --help

Hiermee worden specifieke opties geretourneerd die voor de opdracht upgrade:check kunnen worden uitgevoerd:

- -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.

Aanbevolen procedures voor Adobe Commerce volgen

De resultaten optimaliseren

Upgrade Compatibility Tool verstrekt een rapport dat resultaten met alle kwesties bevat die op uw project door gebrek worden geïdentificeerd. U kunt de resultaten optimaliseren om u te concentreren op de problemen die u moet verhelpen om de upgrade te voltooien: