Hämta Upgrade Compatibility Tool

Om du vill komma igång med Upgrade Compatibility Tool i ett kommandoradsgränssnitt hämtar du det genom att köra följande kommando:

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

Du kan behöva ge verktyget körbar behörighet med kommandot chmod:

chmod +x ./uct/bin/uct

Upgrade Compatibility Tool i ett kommandoradsgränssnitt

Upgrade Compatibility Tool är ett verktyg som kontrollerar en Adobe Commerce-anpassad instans mot en viss version genom att analysera alla installerade moduler. Den returnerar en lista med allvarliga problem, fel och varningar som måste åtgärdas innan du uppgraderar till den senaste versionen av Adobe Commerce.

Se den här videosjälvstudien (06:02) om du vill veta mer om Upgrade Compatibility Tool.

Tillgängliga kommandon för Upgrade Compatibility Tool i ett kommandoradsgränssnitt:

Använd kommandot upgrade:check

Kommandot upgrade:check söker efter kärnkodändringar för den specifika Adobe Commerce-instansen och alla anpassade kodändringar som är installerade i den.

Kommandot upgrade:check är huvudkommandot för att köra verktyget:

bin/uct upgrade:check <dir>

Värdet <dir> är den katalog där din Adobe Commerce-instans finns.

Tillgängliga alternativ för kommandot upgrade:check:

Med Upgrade Compatibility Tool kan du köra kommandot upgrade:check med ett --ignore-current-version-compatibility-issues-alternativ. Använd det här alternativet om du bara vill få nya utgåvor som introduceras med uppdateringen från den aktuella versionen till målversionen i din Upgrade Compatibility Tool-rapport:

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

Lägger till alternativet --coming-version

Du kan jämföra din nuvarande Adobe Commerce-installation med valfri Adobe Commerce-version >=2.3 genom att använda alternativet --coming-version.

Du måste ange versionen som en parameter när du kör kommandot upgrade:check:

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

Där -c, --coming-version[=COMING-VERSION] refererar till målversionen för Adobe Commerce.

Det finns vissa begränsningar när --coming-version körs:

Använd kommandot dbschema:diff

Du kan hämta skillnaden mellan databasschemat för två Adobe Commerce-versioner.

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

Där argumenten är följande:

Exempel på körning:

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

Använd kommandot core:code:changes

Du kan jämföra din nuvarande Adobe Commerce-installation för att kontrollera om Adobe Commerce kärnkod har ändrats för att implementera en anpassning. Det här kommandot visar endast en lista över viktiga ändringar:

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

Där argumenten är följande:

Tillgängliga alternativ för kommandot core:code:changes:

Vanilla-installation

En vanilj-installation är en ren installation av en angiven versionstagg eller gren för en specifik version.

Kommandot bin/uct core:code:changes kontrollerar om det finns en vanilj-instans i systemet. Om det här är första gången du använder en vanilj-installation uppmanas du av en interaktiv kommandoradsfråga att hämta vanilj-projektet från Adobe Commerce-databasen (https://repo.magento.com/).

Du kan köra ett Upgrade Compatibility Tool-kommando med alternativet --vanilla-dir för att ange Adobe Commerce vanilj-installationskatalogen.

Mer information finns i avsnittet Distribuera vanilj-instans.

Använd kommandot refactor

Upgrade Compatibility Tool kan automatiskt åtgärda en reducerad uppsättning problem:

För det kör du kommandot refactor:

bin/uct refactor <dir>

Värdet <dir> är den katalog där din Adobe Commerce-instans finns.

Tillgängliga alternativ för kommandot refactor:

Använd kommandot graphql:compare

Det här kommandot ger Upgrade Compatibility Tool möjlighet att granska två GraphQL-slutpunkter och jämföra deras scheman för att hitta brytningar och farliga ändringar mellan dem:

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

Där argumenten är följande:

Tillgängliga alternativ för kommandot graphql:compare:

Använd kommandot list

Om du vill returnera en lista över de Upgrade Compatibility Tool tillgängliga kommandona kör du:

bin/uct list

Använd kommandot help

Om du vill visa allmänna alternativ och hjälp för kommandot Upgrade Compatibility Tool kör du:

bin/uct --help

Den returnerar en lista med alla tillgängliga help-alternativ för Upgrade Compatibility Tool i ett kommandoradsgränssnitt:

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

Det går att köra --help som ett alternativ när ett specifikt kommando körs. Det returnerar --help alternativ för det angivna kommandot.

Exempel på kommandot upgrade:check med alternativet --help:

bin/uct upgrade:check --help

Detta returnerar specifika alternativ som kan köras för kommandot upgrade:check:

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

Följ Adobe Commerce metodtips

Optimera resultatet

Upgrade Compatibility Tool tillhandahåller en rapport som innehåller resultat med alla problem som identifieras i ditt projekt som standard. Du kan optimera resultaten för att fokusera på de problem som du måste åtgärda för att slutföra uppgraderingen: