報表

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 檔案包含的資訊與 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報表

在指令行介面上執行工具或透過以下方式執行,即可取得HTML報表: Site-Wide Analysis Tool. 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