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

快取後端選項和儲存參考

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快取在遠端儲存體前面新增本機快取階層。

直接快取後端

下列PHP範例會在<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和更新版本,加上支援的背板連線埠
新式Symfony快取
檔案系統(預設)
file
2.4.9和更新版本,加上支援的背板連線埠
新式Symfony快取
Valkey
valkey

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

NOTE
新式實作接受redis型別名稱,但Redis不是正式支援的快取服務,需要Valkey。 請改用valkey

舊版以Zend為基礎的後端範例

對於內部部署,下列範例會在<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

在支援舊版Valkey後端的版本上使用完整的Valkey類別名稱:

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

新式Symfony快取後端

預設的直接後端是檔案系統。 若要將Valkey搭配現代實作使用,請使用簡化的valkey後端型別。

以下設定範例適用於Adobe Commerce 2.4.9和更新版本,且支援Valkey的支援反向移植,適用於使用新式Symfony快取實作設定直接預設快取的情況。

'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'valkey',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379',
            ],
        ],
    ],
],
TIP
Symfony快取實作支援選用的效能功能,例如igbinary序列化、壓縮、Lua指令碼和持續連線。 如需詳細資訊,請參閱設定預設和頁面快取的Valkey

L2快取實作

L2 (兩級)快取會在共用遠端快取儲存體前的每個Web節點上新增本機快取階層,減少Commerce與遠端快取之間的網路流量。

Commerce版本
L2實作
遠端後端
2.4.9之前(若支援)
RemoteSynchronizedCache
Redis或Valkey,視Commerce發行版本和修補程式層級的支援矩陣而定
2.4.9和更新版本
symfony_l2
Valkey

如需內部部署設定,請參閱L2快取設定

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

L2快取設定

  • 如需​ Adobe Commerce on-premises ​組態詳細資料,請參閱L2快取組態

  • 針對​Adobe Commerce on Cloud,請透過適當的部署變數設定L2快取,而非直接編輯app/etc/env.php。 請參閱​ 雲端上的Adobe Commerce ​檔案中的部署變數

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