[内部部署]{class="badge informative" title="仅适用于Adobe Commerce内部部署项目。"}

用于性能优化的二级缓存配置

最近更新： 2026年6月23日

创建对象：

{"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

L2（两级）缓存通过在每个Web节点上添加本地缓存层，减少了远程缓存存储（Redis或Valkey）与Commerce应用程序之间的网络流量。每个请求的标准Commerce实例传输大约300 KB，在某些情况下，流量可能会快速增长到1000多个请求。

通过二级缓存，每个Web节点将经常访问的数据存储在本地，并将远程缓存用于两个目的：

检查缓存数据版本，确保最新的缓存存储在本地
正在将更新的缓存数据从远程存储传输到本地计算机

Commerce会将经过哈希处理的数据版本存储在远程缓存中，并将后缀:hash附加到常规键中。当本地缓存过期时，将通过缓存适配器从远程计算机中获取数据。

有两种可用的二级缓存实施：

实现

版本

描述

旧版(RemoteSynchronizedCache)

<2.4.9

基于Zend的二级缓存，具有Cm_Cache_Backend_File用于本地存储

现代(symfony_l2)

2.4.9+

基于Symfony缓存的L2具有PSR-6合规性和增强的性能。仅支持Valkey。

旧版L2缓存配置(RemoteSynchronizedCache)

NOTE

旧版二级缓存配置说明适用于旧版Adobe Commerce。如果您使用的是Adobe Commerce版本2.4.9或更高版本，请将Valkey与Symfony 2结合使用，用于L2缓存。

缓存配置说明取决于您的部署类型：

对于Cloud上的Adobe Commerce，可通过在.magento.env.yaml中设置REDIS_BACKEND或VALKEY_BACKEND部署变量来配置二级缓存。有关配置示例，请参阅配置二级缓存。
对于支持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是二级缓存实现。
backend_options是二级缓存配置。
- remote_backend是远程缓存实现： Redis或MySQL。
- remote_backend_options是远程缓存配置。
- local_backend是本地缓存实现： Cm_Cache_Backend_File
- local_backend_options是本地缓存配置。
- cache_dir是用于存储本地缓存的目录的文件缓存特定选项。

对于Adobe Commerce，Adobe建议使用Redis进行远程缓存(\Magento\Framework\Cache\Backend\Redis)，使用Cm_Cache_Backend_File进行共享内存中数据的本地缓存，使用： 'local_backend_options' => ['cache_dir' => '/dev/shm/']

Adobe建议使用cache preload功能，因为它可显着降低Redis上的压力。不要忘记为预加载密钥添加后缀“:hash”。

过时的缓存选项

从Commerce 2.4开始，use_stale_cache选项通过在并行进程中生成新缓存数据时提供以前缓存的数据，可以在特定情况下提高性能。

通常，从性能角度来看，锁定等待的权衡是可以接受的。但是，随着块数或缓存条目的增加，锁定需要更多时间。在某些情况下，等待时间最多可以为进程的键数 x 查找超时。在极少数情况下，商家的Block/Config缓存中可能有数百个键，因此，即使是较小的锁查找超时也可能需要几秒钟。

IMPORTANT

过时的缓存仅适用于二级缓存。要启用它，请将'use_stale_cache' => true添加到二级缓存前端的最上层配置中。

Adobe建议仅对从中获益最大的缓存类型启用use_stale_cache选项，包括：

block_html
config_integration_api
config_integration
full_page
layout
reflection
translate

Adobe不建议为default缓存类型启用use_stale_cache选项。

以下代码显示了示例配置：

'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缓存的二级缓存实现（symfony_l2后端），而不是旧的二级缓存。 Symfony L2缓存提供了符合PSR-6标准的现代化缓存实现，与传统RemoteSynchronizedCache相比，性能有了显着改进。

IMPORTANT

Adobe Commerce 2.4.9或更高版本的2.4.5-p16、2.4.6-p14、2.4.7-p9和2.4.8-p5修补程序不支持Redis缓存。如果要升级到不支持Redis的版本，则必须设置Valkey并更新缓存配置以使用symfony_l2。有关本地Commerce，请参阅设置Valkey。对于云上的Commerce，请参阅设置Valkey

Redis不是官方支持的symfony_l2远程后端。如果您使用的版本支持symfony_l2，则必须使用Valkey进行缓存。请参阅系统要求

Symfony二级缓存的优势

现代体系结构：基于Symfony缓存组件构建（符合PSR-6）
更好的性能：对Igbinary序列化、gzip压缩和Lua脚本的本机支持
永久连接：减少连接池的Valkey连接开销
预加载密钥：支持为关键数据预加载缓存密钥
过时缓存支持：与use_stale_cache选项完全兼容
简化的配置：清理器后端类型名称(valkey， file)

Symfony L2缓存的配置示例

NOTE

对于Adobe Commerce on Cloud，ECE工具包(ece-tools)会自动管理缓存配置。不要直接编辑app/etc/env.php — 部署将覆盖手动更改。有关云配置，请参阅改为配置Symfony L2缓存。

为L2缓存使用简化的symfony_l2后端类型：

'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',
                    'persistent_id' => 'magento_l2_default',
                    'timeout' => '2.5',
                    'read_timeout' => '2.0',
                    'use_lua' => '1',
                    'preload_keys' => [
                        'prefix_EAV_ENTITY_TYPES:hash',
                        'prefix_GLOBAL_PLUGIN_LIST:hash',
                        'prefix_DB_IS_UP_TO_DATE:hash',
                        'prefix_SYSTEM_DEFAULT:hash',
                    ],
                ],
                // 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缓存和过时的缓存

配置单独的前端以支持过时的缓存：

'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',
                    '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',
                    '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'

远程后端类型： valkey或file。将valkey用于L2缓存。

remote_backend_options

数组

[]

远程后端配置（请参阅Valkey文档）

local_backend

字符串

'file'

本地后端类型： file或apcu

local_backend_options

数组

[]

本地后端配置

cleanup_percentage

整数

95

一级缓存清理阈值(1-100)

use_stale_cache

布尔型

false

启用过时缓存以实现高可用性

NOTE

remote_backend选项也接受值redis。但是，Redis不是官方支持的Adobe Commerce 2.4.9及更高版本的缓存服务。 Adobe建议仅使用valkey配置symfony_l2。按版本查看支持的缓存服务的系统要求。

增强的Symfony L2缓存性能和可靠性

NOTE

这些改进适用于使用symfony_l2的Adobe Commerce 2.4.9部署，并随修补程序ACP2E-5132一起提供。有关最新的修补程序发行说明，请参阅Commerce云修补程序。

最新的更新提高了Symfony L2缓存的可扩展性，减少了不必要的文件系统I/O，并增强了缓存一致性和可靠性。

优化的Symfony L2缓存标记存储

通过消除冗余的文件系统标记索引写入，优化了Symfony L2缓存行为，以便进行Valkey支持的部署。缓存标记现在专门存储在Valkey中，与Symfony L2缓存行为与旧版缓存实施一致。这减少了不必要的磁盘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，同时保留缓存失效行为。
防止因重新标记后遗留的标记成员资格过时而导致的错误缓存失效。
减少未更改缓存保存不必要的远程写入，从而降低网络和后端负载。
确保在配置的cleanup_percentage阈值下可靠触发一级缓存逐出。
通过为每个键选择单个再生器而不是每个并发请求重建它，减少use_stale_cache条条目的再生次数。

有关详细的配置选项，请参阅：

使用Symfony缓存配置Valkey缓存

recommendation-more-help

commerce-operations-help-configuration