Adobe Commerce 2.4.7發行說明

非產生之快取金鑰的行為變更：

• 區塊的非產生快取金鑰現在包含與自動產生之金鑰的前置詞不同的前置詞。 (未產生的快取索引鍵是透過範本指令語法或 setCacheKey 或 setData 方法。)
• 區塊未產生的快取金鑰現在只能包含字母、數字、連字型大小(-)和底線字元(_)。

自動產生優惠券代碼數目的限制. Commerce現在會限制自動產生的優惠券代碼數量。 預設最大值為250,000。 商家可以使用新的 Code Quantity Limit 組態選項(Stores > Settings:Configuration > Customers > Promotions)，以防止許多優惠券讓系統不堪重負。

最佳化預設管理員URL產生程式. 預設管理員URL的產生已針對增加的隨機性而最佳化，使產生的URL較難預測。

新增子資源完整性(SRI)支援 以符合PCI 4.0的要求，驗證付款頁面上的指令碼完整性。 子資源完整性(SRI)支援為駐留在本機檔案系統中的所有JavaScript資產提供完整性雜湊。 預設SRI功能僅在管理員和店面區域的付款頁面上實作。 不過，商家可以將預設設定延伸至其他頁面。 另請參閱 子資源完整性 在 Commerce PHP開發人員指南.

內容安全性原則(CSP)的變更—Adobe Commerce內容安全性原則(CSP)的設定更新和增強功能，以符合PCI 4.0需求。 如需詳細資訊，請參閱 內容安全性原則 在 Commerce PHP開發人員指南.

• Commerce管理員和店面區域的付款頁面的預設CSP設定現在是 restrict 模式。 對於所有其他頁面，預設設定為 report-only 模式。 在2.4.7之前的版本中，CSP是設定在 report-only 模式。

• 新增Nonce提供者，允許在CSP中執行內嵌指令碼。 Nonce提供者可協助為每個請求產生唯一的Nonce字串。 這些字串接著會附加至CSP標頭。

• 新增選項，可設定自訂URI以報告「管理員」中「建立訂單」頁面的CSP違規以及店面中的「結帳」頁面。 您可以從管理員新增設定，或將URI新增至 config.xml 檔案。

  note note
  NOTE
  將CSP設定更新至 restrict 模式可能會在「管理員」和「店面」的付款頁面上封鎖現有的內嵌指令碼，這會在頁面載入時導致下列瀏覽器錯誤： Refused to execute inline script because it violates the following Content Security Policy directive: "script-src. 更新白名單設定以允許必要的指令碼來修正這些錯誤。 另請參閱 疑難排除 在 Commerce PHP開發人員指南.

新的全頁快取設定有助於降低與HTTP相關的風險 {BASE-URL}/page_cache/block/esi 端點。 此端點支援來自Commerce配置控點和區塊結構的不受限制、動態載入的內容片段。 新的 Handles params size 組態設定會設定此端點的值 handles 引數，決定每個API允許的最大控制代碼數量。 此屬性的預設值為100。 商家可以從管理員(Stores > Settings:Configuration > System > Full Page Cache > Handles params size)。 另請參閱 設定Commerce應用程式以使用Varnish.

透過REST和GraphQL API傳輸的付款資訊的原生費率限制. 商戶現在可以 設定速率限制 以取得使用REST和GraphQL傳輸的付款資訊。 此新增的保護層可支援防止梳理攻擊，並可能會減少同時測試許多信用卡號碼的梳理攻擊的數量。 這是現有REST端點預設行為的變更。 另請參閱 速率限制.

的預設行為 isEmailAvailable GraphQL查詢和(V1/customers/isEmailAvailable) REST端點已變更。 依預設，API現在一律會傳回 true. 商家可以透過設定 啟用來賓簽出登入 管理員中的選項，用於 yes，但這麼做可能會將客戶資訊公開給未經驗證的使用者。

RabbitMQ 3.13支援. 此版本與最新版RabbitMQ 3.13相容。RabbitMQ 3.11和3.12仍支援相容性，分別持續至2024年8月和2024年12月，但Adobe建議僅將Adobe Commerce 2.4.7與RabbitMQ 3.13搭配使用。

Composer 2.7.x. 與Composer 2.2.x的相容性保持不變。

支援清漆快取7.4. 此版本相容於最新版的Varnish Cache 7.4。6.0.x和7.2.x版本仍維持相容性，但我們建議僅將Adobe Commerce 2.4.7與Varnish Cache 7.4或6.0版LTS搭配使用。

Elasticsearch8.11 相容性

Opensearch 2.12和OpenSearch 1.3支援

Redis 7.2

此 extjs 程式庫已取代為最新版本的 jsTree.

jquery/fileUpload 資料庫已移除。

支援每筆訂單多張優惠券. 商戶現在可以 設定抵用券的最大數量 可依訂單套用且包含新的 Maximum number of coupons per order 組態選項。 此值預設為1。 您現在可以使用 REST 或 GraphQL 將多個優惠券套用至購物車。

Commerce UPS XML API閘道已移轉至新的 Commerce UPS REST API 以支援UPS對其 API安全性模型. (UPS正在針對所有API實作OAuth 2.0安全性模型（持有人權杖）。) 所有先前的Commerce UPS XML API已從Adobe Commerce 2.4.7程式碼基底中移除。

Adobe Commerce 整合 with FedEx已從舊版FedEx WSDL Web Services移轉至最新的FedEx RESTful API。 FedEx網站服務追蹤、地址驗證和驗證郵遞區號WSDLS將於2024年5月淘汰。

新增對新USPS Ground Advantage送貨方法的支援。 這是與USPS的新配送方法USPS Ground Advantage （於2023年7月發行）的開箱即用整合。 這項新整合可用於透過USPS配送服務擷取運費、排程交貨與退貨。 USPS Ground Advantage送貨方法取代這些在USPS Ground Advantage送貨方法發行時已淘汰的送貨方法：

• USPS零售場
• 第一級封裝服務
• 包裹選取基底

Temando送貨模組已從核心Commerce程式碼基底中移除。 Adobe Commerce 2.4.4已棄用此功能。

企業商家現在最多可設定 一百萬個使用中、以優惠券為基礎的購物車價格規則 在Adobe Commerce中，購物車和結帳作業的效能不會大幅降低。

增強索引器管理. 新的 indexer:set-status 命令支援索引器狀態的動態管理。 管理員使用者可以使用此命令將索引子狀態變更為 suspended， invalid，或 valid. 此功能在大量大量作業（例如產品匯入或更新）期間管理系統效能時，特別有用，因為它允許控制索引器何時由系統的cron作業自動觸發。 另請參閱 管理索引子.

具有許多選項的複雜產品的產品清單頁面. 針對產品清單頁面（包含具有超過100個選項的複雜產品），已改善載入時間。 GraphQL要求依類別列出產品的效能也有所改善。

REST現在支援JSON格式 匯入API. 商戶現在可以每分鐘將最多100,000筆記錄匯入JSON格式的Adobe Commerce。

銷售規則效能改善. 透過許多（約100,000個）有效的銷售規則，改善企業部署的效能。 大量實作促銷活動的企業部署通常會部署許多作用中的購物車規則。 在結帳操作期間，這些型別的企業部署執行Commerce 2.4.7時，不會看到任何與已設定購物車價格規則數量相關的效能降低。

針對許多商店的部署，更快速地儲存商店層級設定的作業. 在擁有超過500個存放區的部署中儲存組態設定可能很耗時。 新的 非同步設定 模組會透過執行使用取用者處理訊息佇列中的儲存作業的cron作業，來啟用非同步設定儲存作業。 AsyncConfig預設為停用。

加速產生大型設定的設定快取. 此 bin/magento cache:clean config 命令現在會在啟用設定快取時，預先預熱設定快取。 這能縮短產生大型組態之設定快取所需的停機時間。 設定儲存作業不再清除 config_scopes 將資料寫入快取之前先快取快取，這也會縮短寫入設定資料時其他請求鎖定的時間。

Vaulted PayPal和 Pay Later 變更 — 先前曾存放/儲存其PayPal帳戶的登入客戶可選擇以下方式付款：

• Pay Now (不需登入 PayPal 帳戶，使用者可以使用預設卡付款)
• 使用不同的資金來源付款
• 使用其他帳戶付款
• PayPal Pay Later 或 PayPal Credit 按鈕

3DS支援Google Pay — 包含的3DS驗證支援 Google Pay 非標籤化卡片。 請參閱 Braintree檔案 以取得詳細資訊。

Vault Apple Pay Payments — 允許登入的客戶儲存庫/儲存 Apple Pay 支付給其Commerce商店帳戶以用於未來交易的款項。 這可減少結帳的步驟數，並為回頭的客戶建立更快速的結帳體驗。

Vault Google Pay Payments — 允許登入的客戶儲存庫/儲存 Google Pay 支付給其Commerce商店帳戶以用於未來交易的款項。 這可減少結帳的步驟數，並為回頭的客戶建立更快速的結帳體驗。

Vault Venmo Payments — 允許登入的客戶儲存庫/儲存 Venmo 帳戶至其Commerce商店帳戶，以用於未來的交易。 這可減少結帳的步驟數，並為回頭的客戶建立更快速的結帳體驗。

Vault ACH Payments — 允許登入的客戶將其ACH付款儲存至其Commerce商店帳戶，以便用於未來的交易。 這可減少結帳的步驟數，並為回頭的客戶建立更快速的結帳體驗。

Express Payment結帳頂端的按鈕 — 為了提供更快速的結帳體驗，我們推出了 Express Payment 開始出庫的選項。 客戶現在可以依以下方式付款： PayPal， PayPal Pay Later， Apple Pay、和 Google Pay Express 付款。

BraintreeAdmin Configuration中的發行說明和支援連結 — 商家現在可以直接從Commerce Admin連結到線上的Braintree支援和發行說明。

GraphQL對所有人的支援 Braintree 付款方式除外Venmo—GraphQL API會公開更多設定。 這對Headless應用程式特別有用。

Vaulting帳戶區域中的付款 — 登入客戶現在可以 儲存庫/存放區 新信用卡/借記卡及 PayPal 客戶帳戶區域中的帳戶。 以前，客戶只能在儲存付款以供稍後在結帳時完成交易時進行儲存和儲存，現在他們可以在無需建立新交易的情況下儲存新的信用卡/借記卡和PayPal帳戶。

順暢交易 — 順暢交易可減少客戶完成線上信用卡/借記卡交易的點按/步驟數，加速付款流程。 以前（啟用3DS時），每個客戶都會受到3DS的挑戰。 有了新的「順暢交易」功能，客戶只有在銀行要求3DS時才會受到挑戰。 這會減少購物車放棄率、增加轉換率，並帶來更多銷售額。

爭議Webhook — 當客戶在Braintree中爭議交易時，爭議狀態現在會傳遞給Commerce。 您可在 Sales > Order 格線並附加至每個訂單。

更彈性的購物車管理. 此 clearCart 突變現在會以單一動作清除指定購物車的內容。 它會取代 clearCustomerCart 突變，已淘汰。

改良建立購物車變動. 此 createGuestCart 已新增變數，以取代已過時的 createEmptyCart 突變。 先前，如果您使用 createEmptyCart，您無法判斷購物車是給訪客還是登入的客戶。

訂單專案現在包含產品影像. OrderItemInterface 會公開產品影像，讓影像可與訂購的產品建立關聯，並更有效率地載入。 GitHub-32369

擴大對解析器快取的支援. 下列GraphQL查詢解析器現在可在GraphQL解析器結果快取中快取，以改進隨POST請求提交查詢時的效能：

• Magento\CustomerGraphQl\Model\Resolver\Customer::resolve
• Magento\CustomerGraphQl\Model\Resolver\CustomerAddress::resolve
• Magento\CustomerGraphQl\Model\Resolver\IsSubscribed::resolve
• Magento\CatalogGraphQl\Model\Resolver\Product\MediaGallery::resolve

支援訂單取消. 此 cancelerorder 突變可讓客戶取消訂單，傳遞其識別碼和取消原因。

• 新的 order_cancellation_enabled 和 order_cancellation_reasons.description 中的回應欄位 storeConfig
  查詢支援使用者啟動的訂單取消請求。 另請參閱 查詢商店的訂單取消設定

增強對自訂屬性的支援. GraphQL已透過豐富API資料來支援所有屬性型別，進而增強自訂屬性支援。 GraphQL EAV屬性方案現在支援在管理員中擴充客戶屬性和客戶位址物件，以及使用GraphQL擷取它們。 特定的增強功能包括：

• 擴充/新增自訂屬性對特定領域的支援，例如客戶和客戶地址
• 新增自訂屬性的快取
• 增強產品的現有自訂屬性支援

增強的GraphQL快取功能可改善頁面載入速度. 快取功能已新增到這些查詢，改善了大部分PWA頁面的頁面載入時間速度：

• availableStores
• countries 和 國家/地區
• storeConfig
• currency
• customAttributeMetadata

改善GraphQL剖析器效能. 透過減少每個請求呼叫剖析方法的次數，GraphQL剖析器效能已有所改善。 現在只呼叫一次。 之前，至少呼叫過剖析器三次。

已新增 quickorder_active 欄位至 storeConfig 和 availableStores 查詢。 此欄位指出是否啟用快速訂購功能。

已將下列欄位新增至 setBillingAddressOnCart 和 setShippingAddressesOnCart 變異：

• fax
• middlename
• prefix
• suffix

已針對除Venmo外的所有支付方式核心作業新增GraphQL支援。 有關支付服務的新GraphQL端點的說明，請參見 簽出.

已針對除Venmo以外的所有付款方式加強信用卡存放。 購物者現在可以儲存或儲存其ACH付款，並從其帳戶頁面檢視或刪除這些付款。 商戶可從「管理員」啟用或停用ACH存放的付款。

結帳工作流程現在包含快速付款區段，提供PayPal、Google Pay和Apple Pay Express 按鈕。