[內部部署]{class="badge informative" title="僅適用於Adobe Commerce內部部署專案。"}

效能最佳化的L2快取記憶體設定

最後更新： 2026年9月16日

主題：
合規性
設定
架構

建立對象：

中繼
管理員
開發人員

L2 （兩級）快取會藉由在每個Web節點上新增本機快取層，減少遠端快取服務與Commerce應用程式之間的網路流量。標準Commerce執行個體可針對每個請求傳輸約300 KB。在高請求量下，產生的網路流量可能會相當龐大。

透過L2快取，每個Web節點都會將經常存取的資料儲存在本機，並使用遠端快取有兩個用途：

檢查快取資料版本，確保最新的快取儲存在本機
正在將更新的快取資料從遠端快取服務傳輸至本機電腦

Commerce會將雜湊資料版本儲存在遠端快取中，並將尾碼附加至一般金鑰:hash。當本機快取已過期時，會透過快取配接器從遠端快取服務擷取資料。

可用的L2快取實作取決於Commerce版本和修補程式等級：

實施

Commerce版本

遠端快取服務

說明

RemoteSynchronizedCache

2.4.9之前（若支援）

Redis或Valkey，視發行版本和修補程式層級而定

Zend型兩級快取，具有Cm_Cache_Backend_File用於本機儲存

Symfony L2 (symfony_l2)

2.4.9和更新版本

Valkey

符合PSR-6規範的現代Symfony快取式L2實作

RemoteSynchronizedCache L2快取設定

NOTE

本節涵蓋2.4.9之前Adobe Commerce內部部署版本的RemoteSynchronizedCache L2設定，這些版本由確切的Commerce發行版本和修補程式層級支援矩陣所支援。

若是Adobe Commerce 2.4.9和更新版本，請使用Valkey搭配Symfony L2快取。

針對雲端基礎結構上的Adobe Commerce，請透過.magento.env.yaml中的部署變數設定L2快取。請勿直接編輯app/etc/env.php。請參閱設定L2快取。

快取設定指示取決於您的Commerce版本：

對於支援Redis的Adobe Commerce內部部署版本，請使用以下範例來修改或取代app/etc/env.php檔案中的現有快取區段。

'cache' => [
    'frontend' => [
        'default' => [
            'backend' => '\\Magento\\Framework\\Cache\\Backend\\RemoteSynchronizedCache',
            'backend_options' => [
                'remote_backend' => '\\Magento\\Framework\\Cache\\Backend\\Redis',
                'remote_backend_options' => [
                    'persistent' => 0,
                    'server' => 'localhost',
                    'database' => '0',
                    'port' => '6379',
                    'password' => '',
                    'compress_data' => '1',
                ],
                'local_backend' => 'Cm_Cache_Backend_File',
                'local_backend_options' => [
                    'cache_dir' => '/dev/shm/'
                ]
            ],
            'frontend_options' => [
                'write_control' => false,
            ],
        ]
    ],
    'type' => [
        'default' => ['frontend' => 'default'],
    ],
]

其中：

backend是L2快取實作。
backend_options是L2快取設定。
- remote_backend是遠端快取實作： Redis或Valkey，視Commerce版本和修補程式層級的支援而定。
- remote_backend_options是遠端快取設定。
- local_backend是本機快取實作： Cm_Cache_Backend_File。
- local_backend_options是本機快取設定。
- cache_dir是檔案快取特定選項，定義儲存本機快取的目錄。

對於支援Redis或Valkey的2.4.9之前Adobe Commerce版本，Adobe建議使用Redis或Valkey進行遠端快取（如確切版本所支援），並使用Cm_Cache_Backend_File進行本機快取。本機快取通常儲存在暫存檔案系統上，例如/dev/shm/：

'local_backend_options' => [
    'cache_dir' => '/dev/shm/'
]

Adobe建議使用[cache preload](redis-pg-cache.md#redis-preload-feature)功能，因為它可降低Redis上的負載。請確定您為預先載入金鑰新增尾碼:hash。

過時的快取選項

從Commerce 2.4開始，use_stale_cache選項可在平行程式中產生新快取資料時，提供先前快取的資料，藉此改善特定情況下的效能。本節中說明的建議快取型別和取捨適用於RemoteSynchronizedCache和symfony_l2實作。如需symfony_l2組態範例，請參閱具有過時快取的Symfony L2快取。

一般而言，從效能的角度來看，鎖定等待的權衡是可接受的。不過，隨著區塊或快取專案數量增加，鎖定需要更多時間。在某些情況下，等待最多可以是金鑰數目 x 處理程式查詢逾時。在極少數的情況下，使用者的Block/Config快取中可能會有數百個金鑰，因此即使是小型的鎖定查閱逾時也可能需要幾秒鐘。

IMPORTANT

過時的快取只適用於L2快取記憶體。若要啟用它，請將'use_stale_cache' => true新增至L2快取前端的最上層設定。

Adobe建議僅對從中獲益最大的快取型別啟用use_stale_cache選項，包括：

block_html
config_integration_api
config_integration
full_page
layout
reflection
translate

Adobe不建議為default快取型別啟用use_stale_cache選項。

下列程式碼顯示RemoteSynchronizedCache後端的設定範例。如需symfony_l2範例，請參閱具有過時快取的Symfony L2快取。

'cache' => [
    'frontend' => [
        'default' => [
            'backend' => '\\Magento\\Framework\\Cache\\Backend\\RemoteSynchronizedCache',
            'backend_options' => [
                'remote_backend' => '\\Magento\\Framework\\Cache\\Backend\\Redis',
                'remote_backend_options' => [
                    'persistent' => 0,
                    'server' => 'localhost',
                    'database' => '0',
                    'port' => '6379',
                    'password' => '',
                    'compress_data' => '1',
                ],
                'local_backend' => 'Cm_Cache_Backend_File',
                'local_backend_options' => [
                    'cache_dir' => '/dev/shm/'
                ]
            ],
            'frontend_options' => [
                'write_control' => false,
            ],
        ],
         'stale_cache_enabled' => [
            'backend' => '\\Magento\\Framework\\Cache\\Backend\\RemoteSynchronizedCache',
            'backend_options' => [
                'remote_backend' => '\\Magento\\Framework\\Cache\\Backend\\Redis',
                'remote_backend_options' => [
                    'persistent' => 0,
                    'server' => 'localhost',
                    'database' => '0',
                    'port' => '6379',
                    'password' => '',
                    'compress_data' => '1',
                ],
                'local_backend' => 'Cm_Cache_Backend_File',
                'local_backend_options' => [
                    'cache_dir' => '/dev/shm/'
                ],
                'use_stale_cache' => true,
            ],
            'frontend_options' => [
                'write_control' => false,
            ],
        ]
    ],
    'type' => [
        'default' => ['frontend' => 'default'],
        'layout' => ['frontend' => 'stale_cache_enabled'],
        'block_html' => ['frontend' => 'stale_cache_enabled'],
        'reflection' => ['frontend' => 'stale_cache_enabled'],
        'config_integration' => ['frontend' => 'stale_cache_enabled'],
        'config_integration_api' => ['frontend' => 'stale_cache_enabled'],
        'full_page' => ['frontend' => 'stale_cache_enabled'],
        'translate' => ['frontend' => 'stale_cache_enabled']
    ],
],

Symfony L2快取實作

在Commerce 2.4.9+版中，請使用Symfony L2快取實作（symfony_l2後端）而非RemoteSynchronizedCache。 Symfony L2快取可使用Valkey提供符合PSR 6的快取實作。

IMPORTANT

下列Adobe Commerce發行版本中不支援Redis的快取設定：

Adobe Commerce 2.4.9和更新版本
Adobe Commerce 2.4.8-p4和更新版本的修補程式
Adobe Commerce 2.4.7-p9及更新版本的修補程式
Adobe Commerce 2.4.6-p14和更新版本的修補程式
Adobe Commerce 2.4.5-p16和更新版本的修補程式

對於這些版本，請設定Valkey。

如果您在Adobe Commerce 2.4.9或更新版本上設定symfony_l2進行L2快取，則必須使用Valkey進行遠端快取服務。請參閱設定Valkey。

從RemoteSynchronizedCache移轉至Symfony L2

如果您要將內部部署安裝從RemoteSynchronizedCache後端升級至symfony_l2，請先檢閱下列專案，然後再更新app/etc/env.php。僅變更backend值是不夠的。組態結構、金鑰名稱及某些預設行為會有所不同。

組態結構變更。 remote_backend、remote_backend_options和local_backend在symfony_l2下使用不同的值。例如，remote_backend會變成'valkey'，而非完整類別名稱。使用下方的設定範例作為您的起點，而非就地編輯您現有的RemoteSynchronizedCache設定。
不建議將 preload_keys與symfony_l2. 搭配使用如果您的RemoteSynchronizedCache設定包含preload_keys，請在移轉時將其移除。預先載入金鑰不會改善symfony_l2下的效能，而且會觸發其他不必要的金鑰查閱，增加Valkey的負載。
壓縮需要明確的旗標。 單獨設定compression_lib不會啟用symfony_l2下的壓縮。如需必要的compress_data設定，請參閱Symfony L2快取的後端選項。
手動設定的內部部署預設不會啟用過時的快取。 symfony_l2底下的use_stale_cache預設為false （請參閱後端選項表）。如果您的RemoteSynchronizedCache設定使用stale_cache_enabled前端，您必須使用Symfony L2快取中的模式明確重新建立它，並搭配過時的快取。

NOTE

設定VALKEY_BACKEND: symfony_l2部署變數的雲端環境上的Adobe Commerce具有其完整的L2設定，包括stale_cache_enabled前端，是由ece-tools自動產生。請參閱設定Symfony L2快取，瞭解雲端特有的行為。

Redis不是symfony_l2支援的遠端後端。 移轉至Valkey，作為此變更的一部分。請參閱設定Valkey。

使用Symfony L2快取的設定範例

IMPORTANT

此app/etc/env.php範例僅適用於內部部署安裝。對於雲端基礎結構上的Adobe Commerce，請勿直接編輯app/etc/env.php。在.magento.env.yaml中設定VALKEY_BACKEND: symfony_l2。 ece-tools會在部署期間產生並維護L2快取組態。請參閱設定Symfony L2快取。

在app/etc/env.php檔案中，為L2快取使用簡化的symfony_l2後端型別。此範例不包含preload_keys組態，不建議與symfony_l2搭配使用。如需詳細資訊，請參閱從RemoteSynchronizedCache移轉至Symfony L2。

範例將cleanup_percentage設為90。預設值為95。根據可用的本機快取儲存空間和Commerce部署的需求，調整此值。

'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'symfony_l2',
            'backend_options' => [
                // L2 (Remote): Valkey with Symfony Cache
                'remote_backend' => 'valkey',
                'remote_backend_options' => [
                    'server' => 'localhost',
                    'database' => '0',
                    'port' => '6379',
                    'password' => '',
                    'serializer' => 'igbinary',
                    'compression_lib' => 'gzip',
                    'compress_data' => '1',
                    'persistent_id' => 'magento_l2_default',
                    'timeout' => '2.5',
                    'read_timeout' => '2.0',
                    'use_lua' => '1',
                ],
                // L1 (Local): File cache
                'local_backend' => 'file',
                'local_backend_options' => [
                    'cache_dir' => '/dev/shm/magento_l1'
                ],
                'cleanup_percentage' => 90,
            ],
        ]
    ],
    'type' => [
        'default' => ['frontend' => 'default'],
    ],
],

Symfony L2快取記憶體與過時的快取記憶體

請參閱過時快取選項，瞭解哪些快取型別受益於過時快取及原因。

使用下列範例來設定symfony_l2過時快取支援的個別前端：

'cache' => [
    'frontend' => [
        // Default frontend: NO stale cache
        'default' => [
            'backend' => 'symfony_l2',
            'backend_options' => [
                'remote_backend' => 'valkey',
                'remote_backend_options' => [
                    'server' => 'localhost',
                    'database' => '0',
                    'port' => '6379',
                    'serializer' => 'igbinary',
                    'compression_lib' => 'gzip',
                    'compress_data' => '1',
                    'persistent_id' => 'magento_l2_default',
                ],
                'local_backend' => 'file',
                'local_backend_options' => [
                    'cache_dir' => '/dev/shm/magento_l1'
                ],
            ],
        ],
        // Stale cache enabled frontend
        'stale_cache_enabled' => [
            'backend' => 'symfony_l2',
            'backend_options' => [
                'remote_backend' => 'valkey',
                'remote_backend_options' => [
                    'server' => 'localhost',
                    'database' => '0',
                    'port' => '6379',
                    'serializer' => 'igbinary',
                    'compression_lib' => 'gzip',
                    'compress_data' => '1',
                    'persistent_id' => 'magento_l2_stale',
                ],
                'local_backend' => 'file',
                'local_backend_options' => [
                    'cache_dir' => '/dev/shm/magento_l1_stale'
                ],
                'use_stale_cache' => true,
            ],
        ]
    ],
    'type' => [
        'default' => ['frontend' => 'default'],
        'layout' => ['frontend' => 'stale_cache_enabled'],
        'block_html' => ['frontend' => 'stale_cache_enabled'],
        'reflection' => ['frontend' => 'stale_cache_enabled'],
        'config_integration' => ['frontend' => 'stale_cache_enabled'],
        'config_integration_api' => ['frontend' => 'stale_cache_enabled'],
        'full_page' => ['frontend' => 'stale_cache_enabled'],
        'translate' => ['frontend' => 'stale_cache_enabled'],
    ],
],

Symfony L2快取記憶體的後端選項

選項

型別

預設

說明

remote_backend

字串

'valkey'

遠端快取後端。搭配Symfony L2使用valkey。官方不支援Redis。

remote_backend_options

陣列

[]

遠端Valkey後端設定

local_backend

字串

'file'

本機後端型別： file或apcu

local_backend_options

陣列

[]

本機後端設定

cleanup_percentage

整數

95

L1快取清理閾值，以從1到100的百分比表示

use_stale_cache

布林值

false

為前端啟用過時的快取

compress_data

布林值

false

與compression_lib結合時啟用壓縮。在遠端Valkey後端選項中設定此選項。

persistent

布林值

true

控制到遠端後端的持續連線。設定為false ('0')以符合Zend快取行為，預設為非持續連線。

NOTE

frontend_options.write_control選項適用於RemoteSynchronizedCache組態，但不適用於symfony_l2。

增強的Symfony L2快取記憶體效能與可靠性

NOTE

這些改善適用於使用symfony_l2的Adobe Commerce 2.4.9部署，並可在修補程式ACP2E-5132中取得。

若為Adobe Commerce內部部署，請使用Quality Patches Tool (QPT)套用此修補程式。針對雲端基礎結構上的Adobe Commerce，此修補程式包含在Commerce套件的雲端修補程式中，此套件為ece-tools的相依性。更新至最新版本的ece-tools，以便在部署期間接收最新的Cloud修補程式。

最新的更新改善了Symfony L2快取記憶體的擴充性，減少不必要的檔案系統I/O，並增強快取記憶體一致性和可靠性。

最佳化的Symfony L2快取標籤儲存

對於Valkey支援的Symfony L2快取部署，快取標籤會專門儲存在Valkey中。這消除了多餘的檔案系統標籤索引寫入，減少磁碟I/O，並防止var/cache/symfony/tags/目錄的不必要增長。

改善檔案式快取行為

對於使用檔案式快取（沒有Valkey）的部署，會繼續維護本機標籤索引以支援快取失效。標籤索引現在會寫入已設定的cache_dir，而不是先前硬式編碼的var/cache位置，以確保一致的快取目錄使用方式，並改善對自訂快取設定的支援。

重新標籤後過時標籤成員資格修正

重新標籤快取專案可能會讓該專案與其不再所屬的標籤相關聯。過時的標籤會籍現在會在重新標籤時清除，因此快取專案只會由目前指派給它們的標籤失效。

針對未變更的儲存進行備援遠端寫入修正

儲存含有未變更內容的快取專案仍會觸發寫入遠端(Valkey)後端。現在，當內容未變更時會略過儲存，減少不必要的遠端寫入。

L1依大小修正搬遷(cleanup_percentage)

用於L1以大小為基礎的逐出的cleanup_percentage臨界值未一致地觸發清除。 L1快取逐出現在會正確遵循設定的cleanup_percentage。

舊快取的重新產生鎖定

當啟用use_stale_cache且專案的遠端復本暫時無法使用時，只有一個處理序現在會取得短期鎖定，以重新產生該專案。相同專案的其他並行請求會繼續提供現有的本機值，而非自行重新產生，減少重新產生踩踏次數及多餘的後端負載。

影響

針對Valkey支援的Symfony L2快取部署，消除多餘的檔案系統標籤索引寫入，減少磁碟I/O，並防止var/cache/symfony/tags/目錄的不必要成長。
確保檔案式快取部署一致地使用設定的cache_dir作為本機標籤索引，同時保留快取失效行為。
防止重新標籤後留下的過時標籤成員資格導致不正確的快取失效。
減少未變更快取儲存所不需要的遠端寫入，降低網路和後端負載。
確保L1快取逐出在設定的cleanup_percentage臨界值處可靠觸發。
選擇每個索引鍵的單一再生器，而非讓每個並行請求重建專案，以減少use_stale_cache專案的再生棧疊。

如需詳細的組態選項，請參閱：

具有Symfony快取的Valkey快取設定

recommendation-more-help

commerce-operations-help-configuration