Adobe 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)的攻擊。 依預設啟用strict模式可確保不會蓄意啟用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已棄用，不再受支援。 請參閱搜尋引擎必要條件。

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讓商家有機會透過Adobe Commerce部署MariaDB 10.4。 雖然商戶仍可使用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 Foundation的Laminas專案的轉換。 Zend框架已過時。 請參閱將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查詢結果快取。 這些增強功能包括：

• 快取inventory_stock_sales_channel資料表的SQL查詢（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命令現已移除。 此外，升級時，請移除crontab中此檔案的參照。

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最佳實務，且已修訂不一致的檔案名稱。 下列模組的測試受到影響：

• module-catalog-permissions
• module-shared-calog
• module-catalog-event
• module-banner
• module-admin-gws
• module-advanced-checkout
• 模組送貨
• 模組ui
• 模組送貨
• module-checkout-address-search
• module-sales
• module-calog
• module-catalog-rule-staging
• module-visual-merchandiser
• 模組 — 客戶

Lukasz Bajsarowicz在提取要求中提交的修正25800、26323、26321、26320、26319、26322、25828、26329 （以及提取要求104、105、106、107、108、109、111、120、12 1，在私有儲存庫合作夥伴 — magento2ee） ​中。 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上的合併個人資料連結。