文件Commerce設定指南

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

快取後端選項和儲存參考

最後更新： 2026年9月16日

建立對象：

  • 中繼
  • 管理員
  • 開發人員
NOTE
此頁面會記錄內部部署app/etc/env.php設定。
針對Adobe Commerce on Cloud個專案，ece-tools封裝會在部署期間根據.magento.env.yaml中的部署變陣列態產生結果app/etc/env.php組態。 您沒有編輯env.php檔案。 請參閱Valkey與Redis服務組態的最佳實務與部署變數。

Commerce應用程式使用低階快取前端和後端來提供對快取儲存體的存取權。 Commerce支援數個快取後端和策略，分別適用於不同的使用案例。 此頁面說明可用的後端及其差異。

NOTE
Varnish會處理內部部署的HTTP層級完整頁面快取。 Fastly服務會處理它以進行雲端部署。 這兩種解決方案都未使用低階快取後端。

後端快取選項

下表總結列出可用的後端快取：

後端
說明
設定指南
檔案系統
預設。 將快取資料儲存在var/cache/下的檔案中。 不需要設定。
不適用
Redis
記憶體中的資料存放區，用於高效能快取。
使用Redis作為預設快取
Valkey
開放原始碼、與Redis相容的替代方案。
使用預設快取的Valkey
資料庫
由資料庫支援的自訂快取引擎
建立自訂快取引擎 （Adobe Developer檔案）
IMPORTANT
Adobe Commerce 2.4.9或更新於2.4.5-p16、2.4.6-p14、2.4.7-p9和2.4.8-p4的修補程式版本不支援Redis快取。 如果您要升級至其中一個版本，請設定Valkey並更新快取設定以使用它。 若為Adobe Commerce on-premises，請參閱設定Valkey。

快取後端和L2實施 implementation-approaches

Commerce支援直接快取後端和L2快取。 直接後端會選取快取儲存空間。 L2快取在遠端儲存體前面新增本機快取階層。

直接快取後端

下表摘要<Commerce-install-dir>/app/etc/env.php的快取後端組態值。 它不會啟用L2快取。

Commerce版本
後端
設定值
2.4.8和較舊版本（若支援）
檔案
預設。 不需要設定
2.4.8和較舊版本（若支援）
Redis
Magento\Framework\Cache\Backend\Redis
2.4.8和較舊版本（若支援）
Valkey
Magento\Framework\Cache\Backend\Valkey
2.4.9和更新版本，加上支援的背板連線埠
檔案
file
2.4.9和更新版本，加上支援的背板連線埠
Valkey
valkey

如需確切的修補程式層級支援，請參閱系統需求。

[!TAB Zend型快取（2.4.8和更早版本）]

後端範例

對於內部部署，下列範例會在<Commerce-install-dir>/app/etc/env.php中設定直接快取後端。 它們不會啟用L2快取。 請勿在Adobe Commerce on Cloud部署中使用這些範例，這些部署會在部署期間使用ece-tools封裝產生結果app/etc/env.php組態。

Redis

只有在支援Redis的發行版本上才使用完整的Redis類別名稱：

code language-php?start_inline=1 
'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379',
            ],
        ],
    ],
],
Valkey
code language-php?start_inline=1 
'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'valkey',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379',
            ],
        ],
    ],
],

L2快取

L2 （兩級）快取會在共用遠端快取儲存體前的每個Web節點上新增本機快取階層，減少Commerce與遠端快取之間的網路流量。 如需實作選項、版本支援和組態步驟，請參閱L2快取組態。

對於雲端專案，請透過部署變數中所述的部署變數來設定L2快取。

recommendation-more-help
commerce-operations-help-configuration