報表
分析之後,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
輸出檔案的路徑目錄。
var/output/[TIME]-results.json
。HTML報表
在命令列介面中或透過Site-Wide Analysis Tool執行工具時,您可以取得HTML報表。 HTML報表也包含:
- 已識別問題的清單。
- 分析的摘要。
您可以在Upgrade Compatibility Tool分析期間輕鬆瀏覽已識別的問題。
您可以根據最低問題層級篩選報告中顯示的問題(預設值為WARNING
)。
右上角有一個下拉式清單,可讓您選取不同層級。 識別的問題清單會據此篩選。
HTML報表也包含四個不同的圖表:
- 依問題嚴重程度的模組:依模組顯示嚴重程度的分佈。
- 依問題嚴重程度的檔案:依檔案顯示嚴重程度的分佈。
- 依問題總數排序的模組:顯示前10個危害最大的模組,並考量警告、錯誤和嚴重錯誤。
- 具有相對大小和問題的模組:模組包含的檔案越多,其圓圈越大。 模組出現的問題越多,其圓圈就越紅。
這些圖表可讓您識別最容易受損的模組,以及執行升級需要更多工作的模組。
HTML報表圖表也會隨之更新,但Modules with relative sizes and issues
的唯一例外情況(由原本設定的min-issue-level
產生)。
如果要檢視Modules with relative sizes and issues
圖表的不同結果,您必須重新執行命令,為--min-issue-level
選項提供另一個值。
若要將此HTML報表匯出至其他輸出資料夾:
bin/uct upgrade:check <dir> --html-output-path[=HTML-OUTPUT-PATH]
其中引數如下:
<dir>
: Adobe Commerce安裝目錄。[=HTML-OUTPUT-PATH]
:匯出.html
輸出檔案的路徑目錄。
var/output/[TIME]-results.html
。