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。