Adobe Systems Commerce 2.4.0 發行說明

為管理員帳戶、magento.com使用者帳戶和雲端SSH存取實作2FA

• 保護您的系統管理員帳戶。 現在，管理員需要雙因素驗證(2FA)。 管理員使用者必須先設定其2FA，才能透過UI或網頁API登入管理員。 2FA預設為啟用。 我們強烈建議不要停用2FA模組。 這個額外的驗證步驟使得惡意使用者更難以在未獲得授權的情況下登入Admin。 請參閱雙因素驗證(2FA)。

• 保護您的帳戶。 雙因素驗證(2FA)提供新增的可選安全性層，更能保護您的magento.com帳戶，使未經授權的使用者不會以您不想要的方式使用您的帳戶。 請參閱保護您的帳戶。

• 保護雲端SSH存取。 雲端基礎結構上的Adobe提供多重要素驗證(MFA)強制執行，以管理對雲端環境的SSH存取的驗證需求。 專案預設不會啟用2FA的多重驗證。 Adobe強烈建議啟用此功能。 請聯絡支援以尋求協助。 請參閱為SSH存取啟用多重驗證。

範本篩選嚴格模式現在預設為啟用。 在舊模式下使用範本篩選器的元件（包括 CMS 頁面和塊）可能容易受到遠端代碼執行 （RCE） 的影響。默認情況下啟用嚴格模式可確保無法故意啟用 RCE 攻擊。

UI資料提供者的資料呈現現在預設為停用。 這可移除惡意使用者執行任意JavaScript的機會。

新\Magento\Framework\Escaper類別。 這個類別是提供給負責產生HTML的.phtml範本和PHP類別。 此類別包含與多個內容相關的HTML清理方法。 $escaper區域變數可在.phtml範本內使用，且應取代已棄用的$block->escape{method}來使用。 使用$escaper而非$block，因為$block->escape{method}的使用已被取代。

支援 security.txt檔。 此檔是伺服器上的行業標準檔，可説明安全研究人員向網站管理員報告潛在的安全問題。

內容安全策略 （CSP） 支援的 ​增強功能。 SecureHtmlRenderer已新增至框架，並可用於範本中.phtml以將內嵌style script和標記列入白名單。預設 CSP 配置不允許內聯腳本和樣式，XML 檔可以覆蓋該配置。

PHP 7.4支援已推出，PHP 7.1和7.2已過時。 2.4.0引入對PHP 7.4的支援。

支援PHPUnit 9.x及淘汰PHPUnit 6.5。 PHP 7.4需要使用最新的PHPUnit測試架構，即PHPUnit 9.x。Commerce Marketplace擴充功能廠商必須確認所有新的擴充功能版本都與PHP 7.4相容，且所有單位和整合測試都已設定為使用PHPUnit 9執行。

Elasticsearch7.6.x支援。 Elasticsearch 7.6.x現在是Adobe Commerce和Adobe Commerce的預設目錄搜尋引擎。 您必須同時安裝Elasticsearch7.6.x，才能安裝或升級至2.4.0版。Elasticsearch版本2.x程式碼已移除。 Elasticsearch版本 5.x 和 6.x 已淘汰，不再受支援。 請參閱 Search引擎先決條件。

MySQL 8.0 支援。 2.4.x版支援MySQL 8.x。（2.4.0已使用MySQL 8.0.20進行測試。） 建議商戶將部署移轉至MySQL 8.x，以善用其改良的效能、安全性和可靠性。 雖然Magento2.4.x仍支援MySQL 5.7，但已不再支援MySQL 5.6。 您無法以MySQL 5.6資料庫託管2.4.x。 請參閱MySQL。

MariaDB 10.4支援。 對MySQL 8.0的支援為商家部署MariaDB 10.4和Adobe Systems Commerce提供了商機。 儘管商家仍然可以將MariaDB 10.2與2.4.0一起使用，但我們建議升級到MariaDB 10.4以提高性能和可靠性。 不再支援 MariaDB 10.0 和 10.1（由於在此版本中刪除了對 MySQL 5.6 的支援）。

刪除 MySQL 目錄搜尋引擎。 MySQL 搜尋引擎已從 2.4.0 中刪除，並替換為 Elasticsearch 的預設搜尋引擎。 Elasticsearch 提供卓越的搜尋功能以及目錄性能優化。 所有商家必須具有Elasticsearch才能安裝和部署2.4.0。請參閱 驗證是否已安裝Elasticsearch。

將 Zend Framework 上的依賴遷移到 Laminas 專案 ，以反映 Zend Framework 向 Linux 基金會的 Laminas 專案的過渡。 Zend Framework 已被棄用。 請參閱將Zend架構移轉至Laminas專案 DevBlog文章。

控制器的分解 ​可讓擴充功能開發人員直接實作ActionInterface，而不使用「階層超型別」類別。 請參閱控制器的分解 DevBlog文章。 增強功能由Vinai Kopp在提取要求16268中啟動，並由Lukasz Bajsarowicz在提取要求26778 ​中完成。 GitHub-9582

移除Signifyd詐騙保護碼的核心整合。 不再支援此核心功能。 商戶應移轉至Commerce Marketplace上可用的Signifyd Fraud & Chargeback Protection擴充功能。

已從程式碼基底​ 移除 ​核心Braintree模組。 「Braintree付款」模組現在提供相同的功能集。 請參閱Braintree付款。

不再支援Internet Explorer 11.x瀏覽器。

移除第三方付款方法的核心整合。 在此版本中，已從核心程式碼中移除Authorize.Net付款方法整合。 商戶應移轉至Commerce Marketplace上提供的官方擴充功能。 請參閱付款整合淘汰 devblog文章。

支援Elasticsearch的部分文字搜尋（新的預設搜尋引擎）。 Elasticsearch現在支援在使用快速搜尋時，在產品名稱和SKU的搜尋詞中使用部分字詞。 MySQL搜尋引擎支援此功能，此版本已棄用，並由Elasticsearch取代。

PayPal JavaScript SDK升級 我們已將PayPal Express Checkout整合移轉至最新的PayPal JavaScript SDK，此SDK會自動收集必要的風險引數並傳遞給PayPal。 PayPal Express結帳付款方式的行為保持不變。 不過，將此SDK升級至最新版本可讓商家存取最新功能與安全性增強功能。

棄用並移除Web設定精靈。 您必須使用命令列來安裝或升級2.4.0。請參閱安裝Magento。

撰寫器更新外掛程式。 Composer外掛程式可解決在更新為新版本之前必須對根專案composer.json檔案進行的變更，藉此簡化升級程式。 此外掛程式可防止覆寫自訂。 請參閱使用撰寫器根外掛程式升級。

賣家輔助購物。 此功能可讓商家代表其客戶檢視店面。 客戶選擇允許店面存取其帳戶。 這個社群開發的功能包含由MAGEFAN開發的原始擴充功能。 請參閱賣家輔助購物。 功能包括：

• ACL可控制哪些管理員可登入客戶帳戶，並可根據網站進行設定
• 與多個網站和客戶帳戶範圍的相容性
• 代表客戶下的訂單會登入店面並管理
• 所有工作階段會在管理員登出後銷毀，而且管理員無法存取客戶密碼。

改善客戶資料區段失效邏輯。 此發行版本引入了一種讓所有客戶區段資料失效的新方式，可避免自訂sections.xml失效作用中時本機儲存體的已知問題。 (先前當您的自訂​ etc/frontend/sections.xml ​具有動作無效時，未正確填入私人內容（本機儲存空間）。) 檢視私人內容。

多重最佳化Redis效能。 增強功能可將每個請求上執行的Redis查詢數量減至最少。 這些最佳化包括：

• 減少 Redis 和 Magento 之間的網路資料傳輸大小

• 通過提高適配器自動確定需要載入的內容的能力，減少 Redis 對 CPU 週期的消耗

• 減少 Redis 寫入操作上的爭用條件

請参閱 對頁面和默認緩存 使用 Redis 和 配置快取。

改進了對清單表 ​的 SQL 查詢結果快取。 這些增強功能包括：

• 將 SQL 查詢緩存到inventory_stock_sales_channel表中（1 查詢而不是 16）

• 緩存對表的 inventory_stock查詢結果（1 查詢而不是 16）

提高高達 25-30% 的快速訂單添加到購物車性能。

商家現在 可以使用延遲載入 來載入影像。

現在，當您與 Redis 的連接中斷時，應用程式會顯示以下行為。 以前，應用程式不會重新載入當前頁面並显示此錯誤： An error has happened during application run. See exception log for details。

• 管理員和店面會話過期
• 管理員和店面用戶必須重新登入
• 會話數據會儲存至 var/session/
• 不會記錄任何錯誤或例外狀況。

php bin/magento cron:run 不再多次處理變更記錄表中的專案。 以前，當更改日誌表中的新版本超過 100000 個時，可以對同一 entity id.

該 php bin/magento setup:cron:run 命令現已被刪除。 此外，在升級時，請移除crontabs中對此檔案的引用。

update/cron.php檔案已在2.4.0中移除，若此檔案存在於您的安裝中，則可安全地移除它。 此外，升級時，請移除crontab中此檔案的參照。

更正了 GraphQL 中的問題，在該中，應用程式在產品查詢上使用片段時未返回所有必需的信息。 Riccardo Tempesta 在 提取 請求 26218 中提交的修復。 GitHub-26217

GraphQL 突變 setShippingMethodsOnCart 不再檢索屬性中的 available_shipping_methods 錯誤數據。 修復由 Vadim Malesh 在 提取 請求 27004 中提交。 GitHub-26742

應用程式不再顯示空白頁面，而是在下拉/多選框中顯示所有承運商。 之前，函數vendor/magento/module-shipping/Model/Config/Source/Allmethods.php中toOptionArray發生錯誤。修復由 Marc Rodriguez 在 提取 請求 25315 中提交。 GitHub-13136

當客戶創建將運送到多個地址的訂單時，應用程式不再多次應用固定金額折扣。 修復由 Mahesh Singh 在 提取 請求 26419 中提交。 GitHub-25834

測試中的每個操作群組都已移動到單獨的文件中，以追隨 MFTF 最佳做法，並修訂了不一致的文件名。 以下模組的測試受到影響：

• 模組-catalog-permissions
• 模組-shared-catalog
• 模組-catalog-事件
• 模組-橫幅
• 模組-admin-gws
• 模組-advanced-checkout
• 模組運輸
• 模組-ui
• 模組送貨
• module-checkout-address-search
• module-sales
• 模組目錄
• 模組-catalog-規則-staging
• 模組-visual-merchantr
• 模組-客戶

Lukasz Bajsarowicz 在私下存放庫合作夥伴-magento2ee提取請求 25800🔗、26323🔗、26321 🔗、26320、26319、🔗26322🔗、25828🔗、26329 和提取請求 104、105、106、107、108、109、111、119、120、121 中提交的修復。GitHub-22853

問題：當客戶在使用Amazon Pay結帳期間按一下​ 返回標準結帳 ​時，結帳工作流程中遺漏付款方法。 因應措施：重新整理結帳頁面以顯示遺漏的方法。

問題：應用程式在「付款方式」下拉式清單中顯示兩種相同的Amazon付款方式，可在建立新的購物車價格規則時使用。

問題：當管理員嘗試存取Braintree結算報告頁面時，應用程式會顯示錯誤（管理員 > 報告 ）。 目前，應用程式顯示此訊息： An error has happened during application run. See exception log for details。 請參閱Braintree結算報告無法載入知識庫文章。 此問題的​ BUNDLE-2683_SettlementReport.patch Hotfix現在可從版本取得。

問題：商戶無法在已啟用Venmo且已停用​ 啟用信用卡付款儲存庫 ​設定的部署中，建立訂單的部分發票。 目前，應用程式顯示此錯誤： The "vault_capture" command doesn't exist. Verify the command and try again。

問題：應用程式會在「付款方式」下拉式清單中顯示兩種相同的PayPal方式，建立新的購物車價格規則時可使用此下拉式清單。

問題：應用程式開啟​ 銷售 > Braintree虛擬終端機 ​時發生錯誤。 雖然表單包含損壞的UI元素，但仍接受付款。 因應措施：儲存正確的Braintree認證，這會修正摺疊的輸入欄位。 請參閱Braintree虛擬終端機頁面已損毀知識庫文章。 此問題的​ BUNDLE-2670_VirtualTerminal.patch Hotfix現在可從版本取得。

問題：當客戶在結帳期間選取當地付款方式時，應用程式會在下列國家/地區顯示錯誤訊息：比利時、荷蘭、義大利、西班牙及波蘭。 因應措施：忽略錯誤訊息並繼續付款。

如果社群成員已提供此版本的修正，我們會在這些備註的「已修正問題」區段中以「社群成員提供的修正」這個短語來識別修正。

社群工程團隊Magento貢獻者會依月、季和年維護最佳貢獻個人和合作夥伴的清單。 從該貢獻者頁面，您可以前往GitHub上的合併個人資料連結。