[オンプレミス]{class="badge informative" title="Adobe Commerce オンプレミスプロジェクトにのみ適用されます。"}

パフォーマンス最適化のためのL2 キャッシュ設定

最終更新日： 2026年6月23日

作成対象：

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

L2 （2 レベル）キャッシュでは、各web ノードにローカルキャッシュレイヤーを追加することで、リモートキャッシュストレージ（RedisまたはValkey）とCommerce アプリケーション間のネットワークトラフィックを削減します。標準的なCommerce インスタンスでは、リクエストごとに約300 KBが転送され、状況によってはトラフィックが急速に増加して1,000 リクエストを超える場合があります。

L2 キャッシュでは、各web ノードは頻繁にアクセスされるデータをローカルに保存し、次の2つの目的でリモートキャッシュを使用します。

キャッシュデータのバージョンを確認して、最新のキャッシュがローカルに保存されていることを確認する
更新されたキャッシュデータをリモートストアからローカルマシンに転送する

Commerceは、ハッシュ化されたデータバージョンをリモートキャッシュに保存し、サフィックス :hashを通常のキーに追加します。ローカルキャッシュが古くなると、データはキャッシュアダプタを介してリモートマシンから取得されます。

使用可能なL2 キャッシュ実装は2つあります。

導入

バージョン

説明

レガシー（RemoteSynchronizedCache）

<2.4.9

ローカルストレージ用のCm_Cache_Backend_Fileを含むZend ベースの2 レベルキャッシュ

最新（symfony_l2）

2.4.9+

PSR-6準拠のSymfony Cache ベースのL2とパフォーマンスの向上。 Valkeyのみをサポートします。

従来のL2 キャッシュ設定（RemoteSynchronizedCache）

NOTE

従来のL2 キャッシュの設定手順は、古いバージョンのAdobe Commerceに適用されます。 Adobe Commerce バージョン 2.4.9以降を使用している場合は、Symfony 2でValkeyを使用してL2 キャッシュを実行します。

キャッシュ設定の手順は、デプロイメントタイプによって異なります。

Cloud上のAdobe Commerceの場合、.magento.env.yamlでREDIS_BACKENDまたはVALKEY_BACKEND デプロイ変数を設定してL2 キャッシュを構成します。設定例については、L2 キャッシュの設定を参照してください。
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またはMySQL。
- remote_backend_optionsはリモートキャッシュ設定です。
- local_backendはローカルキャッシュ実装です：Cm_Cache_Backend_File
- local_backend_optionsはローカルキャッシュ設定です。
- cache_dirは、ローカルキャッシュが保存されているディレクトリのファイルキャッシュ固有のオプションです。

Adobe Commerceの場合、Adobeでは、共有メモリ内のデータのローカルキャッシュに対するリモートキャッシュ（\Magento\Framework\Cache\Backend\Redis）およびCm_Cache_Backend_FileにRedisを使用することをお勧めします。使用する場所：'local_backend_options' => ['cache_dir' => '/dev/shm/']

Adobeでは、Redisへの負荷を大幅に軽減するため、cache preload機能の使用をお勧めします。プリロードキーのサフィックス ':hash’を追加することを忘れないでください。

古いキャッシュオプション

Commerce 2.4以降、use_stale_cache オプションは、以前にキャッシュされたデータを処理し、新しいキャッシュデータを並行プロセスで生成することで、特定の場合のパフォーマンスを向上させることができます。

一般的に、ロック待ちのトレードオフは、パフォーマンスの観点から許容されます。ただし、ブロック数やキャッシュエントリ数が増えると、ロック待ちに時間がかかります。一部のシナリオでは、プロセスの待機時間は最大キー数 x 検索タイムアウトです。まれに、マーチャントがBlock/Config キャッシュに数百のキーを持つことがあるため、ロックの小さなルックアップタイムアウトでも数秒かかる場合があります。

IMPORTANT

古いキャッシュはL2 キャッシュでのみ機能します。有効にするには、L2 キャッシュフロントエンドのトップレベル設定に'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以降では、従来のL2 キャッシュの代わりにSymfony Cache ベースのL2 キャッシュ実装（symfony_l2 バックエンド）を使用します。 Symfony L2 キャッシュは、PSR-6に準拠した最新のキャッシュ実装を提供し、従来のRemoteSynchronizedCacheよりもパフォーマンスが大幅に向上しました。

IMPORTANT

Redis キャッシュは、Adobe Commerce 2.4.9、または2.4.5-p16、2.4.6-p14、2.4.7-p9、および2.4.8-p5以降のパッチリリースではサポートされていません。 Redisをサポートしていないバージョンにアップグレードする場合は、Valkeyを設定し、symfony_l2を使用するようにキャッシュ設定を更新する必要があります。 Commerce オンプレミスについては、Valkeyの設定を参照してください。 Commerce on Cloudについては、Valkeyの設定を参照してください

Redisは、symfony_l2の正式にサポートされているリモートバックエンドではありません。 symfony_l2をサポートするリリースを使用している場合は、Valkeyを使用してキャッシュする必要があります。必要システム構成を参照してください

Symfony L2 キャッシュのメリット

最新のアーキテクチャ: Symfony Cache コンポーネント上に構築（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 キャッシュのバックエンドオプション

オプション

タイプ

Default

説明

remote_backend

文字列

'valkey'

リモートバックエンドの種類：valkeyまたはfile L2 キャッシュにvalkeyを使用します。

remote_backend_options

配列

[]

リモートバックエンド設定（Valkey ドキュメントを参照）

local_backend

文字列

'file'

ローカルバックエンドの種類：fileまたはapcu

local_backend_options

配列

[]

ローカルバックエンド設定

cleanup_percentage

整数

95

L1 キャッシュクリーンアップしきい値（1 ～ 100）

use_stale_cache

ブーリアン

false

高可用性のために古いキャッシュを有効にする

NOTE

remote_backend オプションはredisの値も受け入れます。ただし、Redisは、Adobe Commerce 2.4.9以降で正式にサポートされているキャッシュサービスではありません。 Adobeでは、symfony_l2をvalkeyのみで設定することをお勧めします。リリース別のサポートされているキャッシュサービスについては、必要システム構成を参照してください。

Symfony L2 キャッシュのパフォーマンスと信頼性の向上

NOTE

これらの機能強化は、symfony_l2を使用したAdobe Commerce 2.4.9のデプロイメントに適用され、ACP2E-5132 パッチで利用できます。最新のパッチリリースノートについては、「Commerceのクラウドパッチ」を参照してください。

最新のアップデートにより、Symfony L2 キャッシュのスケーラビリティが向上し、不要なファイルシステム I/Oが減り、キャッシュの一貫性と信頼性が向上しました。

最適化されたSymfony L2 キャッシュタグストレージ

冗長なファイルシステムタグインデックス書き込みを排除することで、Valkeyに基づくデプロイメント用にSymfony L2 キャッシュ動作を最適化しました。キャッシュタグはValkeyにのみ保存されるようになり、Symfony L2のキャッシュ動作と従来のキャッシュ実装が一致するようになりました。これにより、不要なディスク I/Oが減り、キャッシュの書き込みパフォーマンスが向上し、var/cache/symfony/tags/ ディレクトリの拡張が妨げられます。

ファイルベースのキャッシュ動作の改善

ファイルベースのキャッシュ（Valkeyを使用しない）を使用するデプロイメントの場合、ローカルタグインデックスは引き続き維持され、キャッシュの無効化がサポートされます。タグインデックスは、以前にハードコードされたvar/cacheの場所ではなく、設定されたcache_dirに書き込まれるようになりました。これにより、キャッシュディレクトリの使用状況が一貫し、カスタムキャッシュ設定のサポートが向上しました。

リタグ後の固定古いタグメンバーシップ

キャッシュエントリを再タグ化すると、そのエントリが属していないタグに関連付けられたままになる可能性があります。古いタグメンバーシップは再タグ時にクリアされるようになったため、キャッシュエントリは現在割り当てられているタグによってのみ無効化されます。

変更されていない保存時の冗長なリモート書き込みを修正

変更されていないコンテンツを含むキャッシュエントリを保存すると、リモート（Valkey）バックエンドへの書き込みがトリガーされます。コンテンツが変更されていないときに保存がスキップされ、不要なリモート書き込みが減少するようになりました。

固定L1 サイズベースの立ち退き（cleanup_percentage）

L1 サイズベースの立ち退きに使用されたしきい値cleanup_percentageは、常にトリガークリーンアップを実行できませんでした。 L1 キャッシュの削除が、設定済みのcleanup_percentageを正しく尊重するようになりました。

古いキャッシュの再生成ロックを追加

use_stale_cacheが有効になっていて、エントリのリモートコピーが一時的に利用できない場合、1つのプロセスのみが、そのエントリを再生成するために短時間のみ有効なロックを取得するようになりました。同じエントリに対するその他の同時リクエストは、それ自体を再生成するのではなく、既存のローカル値を引き続き提供し、再生成スタンプードと冗長なバックエンド負荷を軽減します。

効果

ValkeyがサポートするSymfony L2 キャッシュのデプロイメントに対する冗長なファイルシステムタグインデックスの書き込みを排除し、ディスク I/Oを減らし、var/cache/symfony/tags/ ディレクトリの不要な増加を防ぎます。
ファイルベースのキャッシュのデプロイメントでは、キャッシュの無効化の動作を維持しながら、ローカルタグインデックス用に設定されたcache_dirを一貫して使用します。
再タグ化後に残された古いタグメンバーシップによる誤ったキャッシュ無効化を防止します。
変更されていないキャッシュ保存に対する不要なリモート書き込みを減らし、ネットワークとバックエンドの負荷を軽減します。
設定されたcleanup_percentageしきい値でL1 キャッシュの削除を確実にトリガーします。
キーごとに1つのリジェネレーターを選択することで、use_stale_cache個のエントリの再生スタンプを減らします。これは、同じリクエストが同じキーを再構築するたびに行われるものではありません。

設定オプションの詳細については、次を参照してください。

Symfony Cacheを使用したValkey キャッシュ設定

recommendation-more-help

commerce-operations-help-configuration