報表

NOTE
Upgrade Compatibility Tool僅適用於Adobe Commerce執行個體。

分析之後,Upgrade Compatibility Tool可以匯出一份報告,其中包含每個檔案的問題清單,指定其嚴重性、錯誤碼和錯誤描述。 Upgrade Compatibility Tool將報告匯出為兩種不同的格式:

請參閱下列報告的命令列介面範例:

File: /app/code/Custom/CatalogExtension/Controller/Index/Index.php
------------------------------------------------------------------
 * [WARNING][1131] Line 10: Extending from class 'Magento\Framework\App\Action\Action' that is @deprecated on version '2.4.4'
 * [ERROR][1328] Line 10: Implemented interface 'Magento\Framework\App\Action\HttpGetActionInterface' that is non API on version '2.4.4'

檢查錯誤訊息參考主題,以取得關於此報告可以產生的不同錯誤的詳細資訊。

此報表也包含詳細摘要,其中顯示:

  • 目前的版本:目前安裝的版本。
  • 目標版本:您要升級的目標版本。
  • 執行時間:分析建立報告所花費的時間(mm:ss)。
  • 需要更新的模組:包含相容性問題且需要更新的模組百分比。
  • 需要更新的檔案:包含相容性問題且需要更新的檔案百分比。
  • 嚴重錯誤總數:找到嚴重錯誤的數目。
  • 錯誤總數:找到的錯誤數。
  • 警告總數:找到的警告數目。
  • 記憶體尖峰使用量: Upgrade Compatibility Tool在執行期間達到的記憶體數量上限。

請參閱下列命令列介面範例:

 ----------------------------- -----------------
  Current version               2.4.1
  Target version                2.4.4
  Execution time                1m:8s
  Modules that require update   71.67% (43/60)
  Files that require update     18.05% (96/532)
  Total critical issues         24
  Total errors                  159
  Total warnings                53
  Memory peak usage             902.00 MB
 ----------------------------- -----------------

JSON檔案

在命令列介面上執行Upgrade Compatibility Tool時,您可以取得JSON檔案輸出。 JSON檔案包含與Upgrade Compatibility Tool輸出完全相同的資訊:

  • 已識別問題的清單。
  • 分析的摘要。

對於每個遇到的問題,報告都會提供詳細資訊,例如問題的嚴重性和說明。

若要將此JSON檔案匯出至其他輸出資料夾:

bin/uct upgrade:check <dir> --json-output-path[=JSON-OUTPUT-PATH]

其中引數如下:

  • <dir>: Adobe Commerce安裝目錄。
  • [=JSON-OUTPUT-PATH]:匯出JSON輸出檔案的路徑目錄。
NOTE
輸出資料夾的預設路徑為var/output/[TIME]-results.json

HTML報表

在命令列介面中或透過Site-Wide Analysis Tool執行工具時,您可以取得HTML報表。 HTML報表也包含:

  • 已識別問題的清單。
  • 分析的摘要。

HTML報告 — 摘要

您可以在Upgrade Compatibility Tool分析期間輕鬆瀏覽已識別的問題。

您可以根據最低問題層級篩選報告中顯示的問題(預設值為WARNING)。

右上角有一個下拉式清單,可讓您選取不同層級。 識別的問題清單會據此篩選。

HTML報告 — 下拉式清單使用量

NOTE
較低問題層級的問題會被刪除,但您會收到通知,讓您一律知道每個模組的已識別問題。

HTML報表也包含四個不同的圖表:

  • 依問題嚴重程度的模組:依模組顯示嚴重程度的分佈。
  • 依問題嚴重程度的檔案:依檔案顯示嚴重程度的分佈。
  • 依問題總數排序的模組:顯示前10個危害最大的模組,並考量警告、錯誤和嚴重錯誤。
  • 具有相對大小和問題的模組:模組包含的檔案越多,其圓圈越大。 模組出現的問題越多,其圓圈就越紅。

這些圖表可讓您識別最容易受損的模組,以及執行升級需要更多工作的模組。

HTML報告 — 圖表

HTML報表圖表也會隨之更新,但Modules with relative sizes and issues的唯一例外情況(由原本設定的min-issue-level產生)。

如果要檢視Modules with relative sizes and issues圖表的不同結果,您必須重新執行命令,為--min-issue-level選項提供另一個值。

HTML報告 — 泡泡圖圖表

若要將此HTML報表匯出至其他輸出資料夾:

bin/uct upgrade:check <dir> --html-output-path[=HTML-OUTPUT-PATH]

其中引數如下:

  • <dir>: Adobe Commerce安裝目錄。
  • [=HTML-OUTPUT-PATH]:匯出.html輸出檔案的路徑目錄。
NOTE
輸出資料夾的預設路徑為var/output/[TIME]-results.html
recommendation-more-help
83a60e0e-8849-4685-a8cd-c129ecd795ea