Adobe Commerce 2.4.8發行說明

此版本包含下列安全性設定的增強功能：

• Duo Security 2FA：此變更會更新Adobe Commerce中的Duo Security雙因素驗證(2FA)實作，以使用最新的SDK (Web SDK v4)。 此升級可讓商家順暢地轉換至使用Duo Universal Prompt。 商家必須在管理員設定中更新其設定，以包含使用者端ID和密碼。
• 加密金鑰： 重新設計管理加密金鑰，以改善使用性，並消除先前的限制和錯誤。 新的CLI命令現在可用於變更金鑰和重新加密特定系統組態、付款和自訂欄位資料。 此版本不再支援變更管理員UI中的索引鍵。 您必須使用CLI指令。 如需詳細資訊，請參閱疑難排解加密金鑰輪換： CVE-2024-34102知識庫文章。
• 一次性密碼(OTP)設定：需要此更新才能解決2.4.7中回溯不相容變更所導致的錯誤。OTP Window 欄位的描述現在提供設定的正確說明，預設值已從1變更為29。

根據我們的支援生命週期原則，Adobe Commerce現在與下列資料庫技術的下列長期支援(LTS)版本相容：

• MariaDB 11.4 LTS _（支援至2029年）_：舊版(MariaDB 10.6)於2026年終止服務，因此此升級對於維持系統完整性和效能至關重要。 目前仍支援MariaDB 10.6，但Adobe建議在升級至Adobe Commerce 2.4.8時升級至MariaDB 11.4。
• MySQL 8.4 LTS _（支援到2032年）_：舊版(MySQL 8.0)於2026年結束生命週期，因此此升級對於維持系統完整性和效能至關重要。 目前仍支援MySQL 8.0，但Adobe建議在升級至Adobe Commerce 2.4.8時升級至MySQL 8.4

此版本包含下列資料庫增強功能：

• MySQL定序：系統現在預設為使用MySQL的utf8mb4定序，確保與MySQL 8相容，並防止utf8mb3被棄用。 以前，系統預設為使用utf8mb3定序，MySQL 8已棄用此定序。
• MySQL外部fey限制： MySQL 8.4預設會引入更嚴格的外部索引鍵驗證。 restrict_fk_on_non_standard_key設定現在預設為「開啟」，這會限制使用非唯一或部份金鑰作為外部金鑰。 從MySQL 8.0升級至MySQL 8.4的商家必須明確將此引數設定為OFF，或使用--skip-restrict-fk-on-non-standard-key伺服器選項來維持與現有資料庫結構的相容性。 如需詳細資訊，請參閱 升級指南。

此版本新增對RabbitMQ 4.x的支援。在升級至RabbitMQ 4之前，Adobe Commerce Cloud和內部部署客戶必須從classic mirrored queues移轉至quorum queues。 需要進行此移轉，因為：

• Classic mirrored queues RabbitMQ 4中不支援
• Quorum queues 透過跨多個節點複製佇列內容來維持高可用性

此發行版本包含下列PHP增強功能：

• PHP 8.4：此發行版本新增了Adobe Commerce、套件擴充功能和Adobe擁有的擴充功能、服務和工具的PHP 8.4相容性。 仍支援PHP 8.3。 PHP 8.2仍然相容，但僅用於升級目的。 PHP 8.4相容性需要中斷變更。
• PHP 8.1：此發行版本從所有Adobe Commerce專案程式庫、相依性、套件擴充功能和Adobe擁有的擴充功能、服務和工具中移除PHP 8.1。
• PHP 8.1：此發行版本移除了Adobe Commerce 2.4.8的PHP 8.1相容性。您必須先升級至PHP 8.3，才能升級至Adobe Commerce 2.4.8。
• PHP 8.2： PHP 8.2的重大變更之一涉及將null傳遞至不可為nullable的內部函式引數的淘汰。 此版本解決核心平台元件中已棄用的PHP 8.1功能，並確保與PHP 8.2的相容性。
• PHPUnit 10：此版本解決數項重要問題、增強相容性，並確保Adobe Commerce測試架構符合最新的業界標準。 Adobe建議所有擁有自訂功能的Commerce Marketplace供應商和客戶，確認其單位和整合測試會在PHPUnit 10 （而非9）上執行。

下列協力廠商元件和相依性已更新至最新穩定版本，以提升平台穩定性和效能：

• Composer 2.8.x
• glob 11.0.0
• grunt-contrib-connect 5.0.0
• grunt-eslint 25.0.0
• imagemin-svgo 11.0.1
• jquery/bootstrap 5.3.3
• jquery/jstree 3.3.17
• jquery.tabs.js 5.3.2
• jquery/validate 1.20.x
• js-cookie/js-cookie 3.0.5
• moment.js 2.30.1
• monolog/monolog 3.x
• monolog/Require.js 2.3.7
• nginx 1.26
• phpunit/phpunit 10.x
• 伺服 — 靜態1.16.2
• TinyMCE 6.8.5
• 底線1.13.7
• 更新4.4.0
• 亮漆7.6.x
• wikimedia/less.php 5.x

下列元件已移除：

• TinyMCE 5

所有Laminas相依性都已升級至最新版本，但下列專案除外，已取代為替代套件或原生PHP功能：

• laminas/laminas-file
• 層疊/層疊 — 郵件
• 層板/層板MIME
• 雷米納斯/雷米納斯 — 奧auth

Adobe Commerce現已針對OpenSearch 2.19最佳化，不再與Elasticsearch相容。 程式碼基底現在已不建議使用所有Elasticsearch 7和8模組及類別。 Adobe強烈建議針對內部部署和雲端基礎結構部署轉換至OpenSearch，以確保持續的支援和相容性。 請參閱移轉至OpenSearch。

• Elasticsearch 7和Elasticsearch 8選項現在在管理員設定中標示為「（已棄用）」。
• 當使用者在管理員設定中選取Elasticsearch作為搜尋引擎時，Commerce會顯示通知，指出： 「Adobe不再支援此搜尋引擎選項。 我們建議改用OpenSearch做為搜尋引擎。"

• 已將下列新欄位新增至CartItemPrices型別，以支援精確的定價顯示和折扣計算：

  • original_item_price
  • original_row_total
  • row_total_including_catalog_discounts_only

• 更新GraphQL的結帳程式，在訂單總計為零時僅顯示「免費」付款方式。 此增強功能可減少購物者的困惑，並確保更順暢的購買體驗。

• 新增透過StoreConfig GraphQL查詢擷取條款與條件組態設定的支援。 可用的新設定： Stores > Settings > Configuration > Checkout > Checkout Options > Enable Terms and Conditions。 這些設定可讓前端應用程式透過結帳頁面中的存放區檢視，動態啟用及設定條款與條件。

• 更新updateCartItems突變，傳回包含錯誤詳細資料（而非例外）的成功回應。 增強錯誤對應以提高使用者通知的清晰度。

• 新增新的InsufficientStockError型別以處理庫存量不足的情況。 已調整結構描述以支援新的錯誤型別，進而增強錯誤報告功能。

• 已針對數量不足且無法使用的通知完善傳訊。

• 已將grand_total_excluding_tax欄位新增至CartPrices型別，提供明確的含稅定價。

• 已新增not_available_message至CartItemInterface。

此版本包含下列客戶管理增強功能：

• 改進generateCustomerToken突變中的錯誤處理，為未確認的電子郵件提供特定訊息。 支援更佳的使用者指引和錯誤解決方案。
• 新增重新傳送電子郵件確認的resendConfirmationEmail突變。
• 已在customer查詢中新增customer.addressesV2欄位，新增客戶地址的分頁功能。

此版本包含下列使用者訂單管理增強功能：

• 增強錯誤傳訊功能，以包含可用的詳細目錄數量。 在訂單更新期間，為使用者提供更清楚的存貨層次深入分析。
• 已新增新的date_of_first_order欄位至CustomerOrders型別。
• 擴充OrderAddress型別以包含自訂屬性，增強訂單詳細資料的可見度。 支援在訂單確認頁面上顯示的其他資訊。
• 已將is_virtual欄位新增至CustomerOrder型別，支援虛擬產品識別。 藉由區分虛擬與實體產品來增強訂單處理能力。
• 已新增類似於CartItemPrices的OrderItemPrices型別至OrderItemInterface，其中包含數個新的價格欄位。
• 改善API功能，以根據電子郵件比對來合併來賓訂單與客戶帳戶。 簡化回頭客戶的訂單管理。
• 已擴充CustomerOrder型別以包含available_actions欄位，以便進行更好的訂單管理。 「available_actions」欄位對應至列示可針對訂單執行之可能動作的列舉。
• 已將customer_info欄位新增至CustomerOrder型別。 此欄位需要OrderCustomerInfo型別，其中包含有關客戶名稱的詳細資料。
• 已將詳細的錯誤碼新增至CancelOrderOutput型別。 改善訂單取消流程的錯誤處理和使用者回饋。
• 新增新的confirmCancelOrder突變，方便訪客購物者取消訂單。
• 更新OrderStatusChangeDate解析程式，以預設格式傳回訂單狀態變更日期，而不需進行額外的重新格式化，確保回應的一致性。
• 更新order.availableActions欄位，以確保在商人停用管理員中的重新排序功能時，不會傳回REORDER動作。
• 已更新guestOrder和guestOrderByToken查詢以使用lastname而非postcode，因為有些國家/地區將郵遞區號視為選用。 因此，某些訪客使用者在訂購期間擷取代號，或使用代號擷取已下訂單時遇到問題。
• 更新cancelOrder突變，僅供註冊客戶存取。 新增新的requestGuestOrderCancel突變，此突變需要順序權杖（類似於guestOrderByToken輸入）。
• 新增order_status_change_date欄位以追蹤訂單狀態變更的日期。
• 已新增OrderCustomerInfo至CustomerOrder型別。
• 已新增CustomerOrder.available_actions欄位以顯示訂單可用的動作。
• 已對應錯誤代碼，以及訂單取消的對應錯誤訊息。
• 已根據created_at欄位新增訂單歷史記錄篩選器，並公開具有CustomerOrders型別的date_of_first_order。
• 已將is_virtual欄位新增至CustomerOrder型別，類似於Cart型別。 這可讓客戶有條件地隱藏只包含虛擬產品的訂單的送貨資訊。
• 已更新guestOrder和guestOrderByToken查詢回應，以納入遺漏的購物車摘要相關欄位以進行訂單確認。 已將OrderItemPrices型別和original_price及original_price_including_tax欄位新增至OrderItemPrices及CartItemPrices型別。 「價格」欄位現在包含詳細的訂價資訊，讓訂單確認頁面顯示更完整的購物車摘要，包括總數量、專案詳細資料和折扣前價格。
• 更新API，當電子郵件地址相符時，支援將訪客訂單與客戶帳戶合併。 現在，在註冊時或找到具有相同電子郵件的現有帳戶時，來賓下單的訂單會自動與相應的客戶帳戶相關聯。
• 更新CustomerOrder型別以包含套用至訂單總計的商店點數和獎勵點數。 現在，訂單裝載會傳回商店評分和獎勵點的標籤和值，以確保完整的成本摘要詳細資料。

• 已在ProductInterface中新增quantity欄位，以提供庫存等級詳細資料。 它會根據管理員設定顯示可用庫存或Null。
• 修正套件產品的定價顯示，確保價格與貨幣資訊準確無誤。
• 已新增grouped_product_image和configurable_product_image欄位至StoreConfig型別。

• 更新GiftOptionsPrices和OrderTotal型別，以包含贈品包裝（依料號與訂單）與列印卡片的price_excluding_tax和price_including_tax欄位。 此增強功能可確保根據購物車和訂單查詢的商店組態設定，準確顯示稅捐。
• 更新storeConfig查詢以包含printed_card_priceV2以傳回價格物件而非字串。
• 已新增gift_wrapping_available和gift_wrapping_price欄位至products查詢。 gift_wrapping_price欄位現在會傳回為價格物件。
• 已新增gift_message和gift_wrapping欄位至GiftCardCartItem型別；已更新邏輯以捨棄虛擬產品的贈品包裝。
• 已更新customerOrders查詢以正確處理gift_message欄位。
• 更新customerOrders查詢以包含applied_gift_cards欄位，允許擷取類似applied_coupons的已套用禮品卡資料。

• 更新RMA專案輸入的requestReturn突變，以解決傳回屬性相關查詢與突變之間的不一致。
• 更新requestReturn突變以支援客體訂單退貨。

• 已更新StoreConfig型別（包含欄位），以符合管理員設定中的稅捐顯示設定。
• 已新增subtotal_excl_tax和subtotal_incl_tax欄位至OrderTotal型別。 已將subtotal欄位標示為已棄用。

• 已在CartAddressInterface型別中新增送貨或帳單購物車位址的通訊錄識別碼。
• 已將same_as_billing欄位新增至ShippingCartAddress型別，以指出送貨地址與帳單地址是否相同。
• 更新guestOrder和guestOrderByToken查詢以包含自訂地址屬性，確保新帳戶的完整地址資訊。

• 已新增theme欄位至recaptchaV3Config查詢。 此欄位可讓您指定用於轉譯reCaptcha的主題名稱，以確保精確的價格和貨幣資訊。
• 透過確保具有過期客戶Token的請求現在傳回401 Unauthorized回應來提高安全性。

此版本包含Braintree擴充功能的下列一般增強功能：

• 為了提供真正的快速付款體驗，Braintree擴充功能現在包含PayPal強制回應視窗中的送貨方法，讓客戶只需按一下較少的次數即可結帳。 系統會根據儲存在客戶PayPal帳戶中的送貨地址列出並計算送貨選項。 以前，客戶會登陸檢閱頁面，並選擇送貨方式完成付款。 評論頁面現在為選用，可讓商家啟用/停用此使用者歷程。 PDP、迷你購物車、購物車和結帳頂端都有PayPal Express按鈕。
• Braintree SDK現已發佈新版本。 PHP SDK版本是6.21.0。JavaScript SDK版本為3.112.0。最新版本有一些必要的變更，以便未來與新功能和特性相容。
• Braintree擴充功能中的一般程式碼最佳化。
• 為了判斷客戶啟動PayPal結帳體驗（PDP、購物車或結帳）的頁面，Braintree擴充功能現在將data-page-type屬性傳遞至JavaScript SDK。 此屬性用於呈現頁面上的按鈕。
• 依照新的PayPal品牌指導方針，Braintree擴充功能現在將PayLater訊息放置在PDP、迷你購物車和購物車上。 訊息現在與價格/總計更接近/並存。 擴充功能現在也會將PayLater訊息顯示為結帳按鈕的一部分，而非個別顯示。
• 為了改善快速付款體驗，Braintree擴充功能將配送方式直接整合至Google付款模式，讓客戶只需按一下較少的次數即可完成結帳。 系統會根據客戶的Google付款帳戶中儲存的地址，自動顯示並計算出貨選項。 以前，客戶在完成付款之前會被重新導向到複查頁面以選擇送貨方法。 現在，複查頁面是選用的，可讓商家彈性地在結帳程式中啟用/停用此步驟。 Google Pay Express按鈕位於迷你購物車、購物車和結帳頂端。
• 將目前的Apple Pay標籤更新至最新版本。
• 將目前的Google Pay標籤更新至最新版本。
• 移除Sofort和Giropay付款方法，因為這些方法已不再受支援。

提供追蹤資訊和料號層級詳細資訊，可大幅改善客戶體驗，同時降低商家的營運成本。 客戶可以輕鬆登入其PayPal帳戶、檢視訂單，並存取追蹤連結。 商戶可自動解決「未收到商品」的PayPal爭議、更快速地存取付款和爭議保留中的資金、即時追蹤更新、商品層級爭議（而非整個訂單的爭議），以及提升商戶風險設定檔。

此版本包含行專案的下列增強功能：

• 套用付款 ：客戶使用Apple Pay Express結帳時，Braintree擴充功能現在會在Apple Pay強制回應視窗中顯示購物車明細專案。 按一下工具提示(？) 在價格旁邊，客戶可以檢視個別購物車專案、折扣、送貨和稅捐詳細資料，無須退出強制回應視窗以確認其專案。
• Google Pay ：客戶使用Google Pay Express結帳時，Braintree擴充功能現在會直接在Google Pay強制回應視窗中顯示購物車明細專案。 按一下工具提示(？) 在價格旁邊，客戶可以檢視個別購物車專案、折扣、送貨和稅捐詳細資料，而不需要退出強制回應視窗來驗證其專案。