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 類別. 此類別提供給 .phtml 範本和負責產生HTML的PHP類別。 此類別包含與多個內容相關的HTML清理方法。 此 $escaper 區域變數可在內部使用 .phtml 範本和的使用時機，而非過時的 $block->escape{method}. 使用 $escaper 而非 $block 作為使用 $block->escape{method} 已被取代。

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

增強內容安全性原則(CSP)支援. SecureHtmlRenderer 已新增至Framework，並可在以下位置取得： .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執行。

Elasticsearch 7.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框架上的相依性移轉至 Laminas專案 以反映Zend Framework轉換為Linux Foundation的Laminas專案。 Zend框架已過時。 請參閱 Zend架構移轉至Laminas專案 DevBlog文章。

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

移除重大詐騙保護碼的核心整合. 不再支援此核心功能。 商戶應移轉至 顯著的詐騙和借項衝回保護延伸功能 Commerce Marketplace上可用的資訊。

此 已從程式碼庫中移除核心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升級至最新版本可讓商家存取最新功能與安全性增強功能。

棄用並移除網頁設定精靈. 您必須使用命令列來安裝或升級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 命令現已移除。 此外，升級時，請移除crontab中此檔案的參照。

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

修正GraphQL中應用程式在產品查詢上使用片段時未傳回所有必要資訊的問題。 Riccardo Tempesta在提取請求中提交的修正 26218. GitHub-26217

GraphQL突變 setShippingMethodsOnCart 不再擷取中錯誤的資料 available_shipping_methods 屬性。 Vadim Malesh在提取請求中提交的修正 27004. GitHub-26742

應用程式不再顯示空白頁面，而是在下拉式/多選方塊中顯示所有出貨承運商。 先前， toOptionArray 中的函式 vendor/magento/module-shipping/Model/Config/Source/Allmethods.php 已發生。 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 （以及私人存放庫合作夥伴magento2ee中的提取請求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上的合併個人資料連結。