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 Developer Guide ​中的內容安全性原則。

• 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。 商戶可以透過將Admin中的​ Enable Guest Checkout Login ​選項設定為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 與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中設定最多​ 1百萬個使用中、以優惠券為基礎的購物車價格規則，購物車和結帳作業的效能不會大幅降低。

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

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

REST 匯入API現在支援 JSON格式。 商戶現在可以每分鐘將最多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按鈕

Google Pay​ 的 3DS支援 — 包含Google Pay非標籤化卡片的3DS驗證支援。 如需詳細資訊，請參閱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付款來付款。

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

GraphQL支援除Venmo ​之外的所有Braintree付款方法 — 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

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

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

對自訂屬性的增強支援。 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 ​按鈕。