Adobe Commerce 2.4.7發行說明

最後更新： 2024年11月25日
  • 主題：

建立對象：

  • 經驗豐富
  • 管理員
  • 開發人員

Adobe Commerce 2.4.7引入對PHP 8.3的支援。此版本引進了數百項品質修正和增強功能。 核心撰寫器相依性和協力廠商程式庫已升級至最新可用版本。 此版本包含顯著的效能改善，包括針對包含許多索引器管理選項和增強功能的複雜產品，更快速地載入產品清單頁面。 此版本提高GraphQL對自訂屬性和GraphQL解析器快取的涵蓋範圍。 此外，也推出對最近更新的FedEx和UPS服務的支援。

NOTE
Adobe Commerce版本可能包含與舊版不相容的變更(BIC)。 若要檢閱回溯不相容的變更，請參閱BIC參考。 在BIC重點專案中說明嚴重的回溯不相容問題。 並非所有發行版本都會推出主要BIC。

其他發行資訊

雖然這些功能的程式碼與Adobe Commerce核心程式碼的發行版本搭配使用，但其中幾個專案(例如B2B和Progressive Web Application (PWA) Studio)也獨立發行。 這些專案的錯誤修正記錄在每個專案檔案中提供的個別專案特定發行資訊中。

Adobe Commerce 2.4.7重要功能

請檢視此版本中的下列重點專案。

安全性增強功能

此發行版本包含與Adobe Commerce 2.4.6-p5、2.4.5-p7和2.4.4-p8中包含的相同安全性修正和平台安全性改善。 請參閱Adobe安全性公告，瞭解這些已修正問題的最新討論內容。

目前尚未發生與這些問題相關的已確認攻擊。 但是，某些漏洞可能會被用來存取客戶資訊或接管管理員工作階段。 這些問題大多需要攻擊者先取得Admin的存取權。 因此，我們提醒您採取一切必要步驟來保護您的管理員，包括但不限於這些工作：

  • IP允許清單
  • 雙因素驗證
  • 使用VPN
  • 使用唯一位置而非/admin
  • 良好的密碼衛生

其他安全性增強功能

此版本的安全性改善專案可改善對最新安全性最佳實務的合規性。

  • 未產生快取金鑰的行為變更：

    • 區塊的非產生快取金鑰現在包含與自動產生之金鑰的前置詞不同的前置詞。 （未產生的快取金鑰是透過範本指示詞語法或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
      將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來啟用原始行為，但這麼做可能會將客戶資訊公開給未經驗證的使用者。

平台增強功能

此版本的平台升級可改善對最新安全性最佳實務的合規性。

Adobe Commerce 2.4.7包含下列平台升級：

  • PHP 8.3相容性。 此發行版本引入對PHP 8.3的支援。Commerce現在同時支援PHP 8.3和8.2。PHP 8.2將受支援直到其服務結束(EOS)日期為2025年12月。 在2025年12月之後，所有執行2.4.7部署的商家都應移轉至PHP 8.3。

Adobe Commerce 2.4.7仍與PHP 8.1相容，僅供升級之用。 PHP 8.1不受支援，也不建議使用。 Adobe Commerce 2.4.7核心程式碼、所有隨附的擴充功能，以及所有Adobe擁有的擴充功能和SaaS服務都與PHP 8.3相容。

  • 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資料庫。

Adobe Commerce核心程式碼中的所有JavaScript程式庫和NPM相依性均已更新至最新可用版本。 所有Laminas程式庫相依性都已更新為與PHP 8.3相容的最新版本。

其他升級

  • 每個訂單支援多張優惠券。 商戶現在可以使用新的​ 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已棄用此功能。

效能與擴充性增強功能

Commerce 2.4.7包含下列Commerce效能和擴充性的增強功能：

  • 企業商家現在可以在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快取，因此也減少了寫入組態資料時其他要求鎖定的時間。

GraphQL應用程式伺服器

GraphQL Application Server可讓Adobe Commerce在Commerce GraphQL API要求之間維持狀態，並免除啟動載入需求，進而提高所有GraphQL API的輸送量、降低延遲及有效率地使用資源。 透過在處理程式之間共用應用程式狀態，GraphQL API要求的效率會大幅提升，而GraphQL API回應的速度平均可加快30%。

GraphQL Application Server僅適用於Adobe Commerce。 它無法用於Magento Open Source。 您必須提交Adobe Commerce支援票證，才能在Pro專案上啟用GraphQL應用程式伺服器。

NOTE
GraphQL Application Server目前與Amazon Simple Storage Service (AWS S3)不相容。 目前將AWS S3用於遠端存放區的雲端基礎結構上的Adobe Commerce客戶在Adobe於2024年稍後發行Hotfix之前，無法使用GraphQL Application Server。

Adobe Commerce擴充功能中繼資料

此發行版本推出Adobe Commerce擴充功能中繼套件v2.0.0，自動將特定Adobe Commerce擴充功能與此核心發行版本整合。 執行composer update時，會安裝此中繼封裝中包含的這些擴充功能版本，在升級至最新核心版本時，可簡化升級這些擴充功能的程式。 這些擴充功能會維護獨立的發行排程。

Adobe Commerce 2.4.7的Adobe Commerce擴充功能中繼資料包含下列擴充功能：

此擴充功能中繼資料包的未來版本可能包含其他擴充功能。

Adobe Commerce webhook

Commerce webhook (v1.2.0)可讓開發人員設定同步邏輯，以在Adobe Commerce事件觸發時執行對外部系統的呼叫。 當Commerce必須立即使用協力廠商端點計算或驗證訂單總計、稅額或付款等值時，以及隨後將結果寫回Adobe Commerce，則需要同步呼叫。

Commerce webhook現已預設安裝。 請參閱Adobe Commerce Webhook概觀

Adobe Stock

Adobe Stock套件(adobe-stock-integration)現在封裝在Commerce擴充功能中繼套件(extensions-metapackage)中，以支援更頻繁的更新。

B2B

NOTE
2.4.7版本與B2B 1.4.2相容。不過，Adobe建議客戶在升級之前等待即將發行的B2B 1.5.0 GA版本，該版本包含對PHP 8.3的支援。請參閱B2B發行說明。

Braintree

  • 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 ​格線中搜尋並附加至每個訂單。

Commerce與Adobe IMS整合

Adobe IMS整合套件(adobe-commerce/adobe-ims-metapackage)現在封裝在Commerce擴充功能中繼套件(extensions-metapackage)中，以支援更頻繁的更新。

GraphQL

Commerce 2.4.7包含增強的GraphQL快取功能、支援GraphQL架構的自訂屬性、支援headless訂單取消，以及改善解析器快取。

  • 更靈活的購物車管理。 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頁面的頁面載入時間速度：

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

現有變動的新欄位

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

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

    • fax
    • middlename
    • prefix
    • suffix

新的查詢和變動

已棄用的查詢和變動

Inventory management

Inventory management (v1.2.7)提供管理產品詳細目錄的工具。 這項社群開發的功能與Adobe Commerce和Magento Open Source核心程式碼整合。

付款

  • 已針對除Venmo外的所有支付方式核心作業新增GraphQL支援。 付款服務的新GraphQL端點在結帳中說明。

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

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

付款選項引進支援的付款方法。

PWA Studio

PWA Studio v14.0與Adobe Commerce 2.4.7相容。其中包含多項改善協助工具的增強功能。 如需有關錯誤修正的資訊，請參閱PWA Studio版本。 如需PWA Studio版本及其相容的Adobe Commerce核心版本的清單，請參閱版本相容性。