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

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

最終更新日： 2026年8月20日

作成対象：

{"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を通常のキーに追加します。ローカルキャッシュが古くなると、データはキャッシュアダプタを介してリモートマシンから取得されます。

Adobe Commerceでは、次の2つのL2 キャッシュ実装を使用できます。

導入

バージョン

説明

レガシー（RemoteSynchronizedCache）

<2.4.9

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

最新（symfony_l2）

2.4.9+

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

Symfony L2 キャッシュは、Adobe Commerce 2.4.9以降のリリースで推奨される実装です。 PSR-6に準拠した最新のキャッシュ実装を提供し、従来のRemoteSynchronizedCacheよりも大幅にパフォーマンスが向上します。

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

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

NOTE

このページでは、オンプレミス設定についてのみ説明します。 Adobe Commerce on Cloudについては、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は、ローカルキャッシュが保存されているディレクトリのファイルキャッシュ固有のオプションです。

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

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

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

Commerce 2.4以降、use_stale_cache オプションは、以前にキャッシュされたデータを処理し、新しいキャッシュデータを並行プロセスで生成することで、特定の場合のパフォーマンスを向上させることができます。この節で説明する推奨されるキャッシュタイプとトレードオフは、従来のRemoteSynchronizedCache実装とsymfony_l2実装の両方に適用されます。 symfony_l2の設定例については、古いキャッシュを持つSymfony L2 キャッシュを参照してください。

一般的に、ロック待ちのトレードオフは、パフォーマンスの観点から許容されます。ただし、ブロック数やキャッシュエントリ数が増えると、ロック待ちに時間がかかります。一部のシナリオでは、プロセスの待機時間は最大キー数 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 オプションを有効にすることはお勧めしません。

次のコードは、従来の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以降では、従来のL2 キャッシュの代わりにSymfony Cache ベースのL2 キャッシュ実装（symfony_l2 バックエンド）を使用します。 Symfony L2 キャッシュは、PSR-6に準拠した最新のキャッシュ実装を提供し、従来のRemoteSynchronizedCacheよりもパフォーマンスが大幅に向上しました。

IMPORTANT

Redisは、次のようなリモートキャッシュバックエンドとしてサポートされていません。

Adobe Commerce 2.4.9以降
2.4.8-p4以降のパッチ
2.4.7-p9以降のパッチ
2.4.6-p14以降のパッチ
2.4.5-p16以降のパッチ

以前のバージョンをアップグレードする場合は、Valkeyを設定し、キャッシュ設定を更新してsymfony_l2を使用します。 Valkeyの設定および必要システム構成を参照してください。

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

最新のアーキテクチャ：はSymfony Cache コンポーネント上に構築されています（PSR-6準拠）
より優れたパフォーマンス： Igbinaryのシリアル化、gzip圧縮、およびLua スクリプトのネイティブサポート
永続的な接続：は、接続プールによってValkey接続のオーバーヘッドを削減します
プリロードキー：は、重要なデータのキャッシュキーのプリロードをサポートしています
古いキャッシュのサポート：とuse_stale_cache オプションの完全な互換性
簡略化された設定： クリーナーバックエンドの型名（valkey、file）

RemoteSynchronizedCacheからSymfony L2への移行

オンプレミスのインストールを従来のRemoteSynchronizedCache バックエンドからsymfony_l2にアップグレードする場合は、app/etc/env.phpを更新する前に、次の点を確認してください。 backend値のみを変更するだけでは不十分です。設定構造、キー名、および一部のデフォルト動作が異なります。

構成構造が変更されます。 remote_backend、remote_backend_optionsおよびlocal_backendは、symfony_l2の下で異なる値を使用しています。例えば、remote_backendは完全修飾クラス名ではなく'valkey'になります。既存のレガシー設定を編集するのではなく、以下の設定例を出発点として使用します。
preload_keysはsymfony_l2.では推奨されませんレガシー設定にpreload_keysが含まれている場合は、移行の一部として削除します。キーのプリロードはsymfony_l2のパフォーマンスを向上させず、追加の不要なキー検索をトリガーすることでValkeyの負荷を増やす可能性があります。
圧縮には明示的なフラグが必要です。 compression_libのみを設定すると、symfony_l2の下で圧縮が有効になりません。必要なcompress_data設定については、Symfony L2 キャッシュのバックエンドオプションを参照してください。
オンプレミスのデプロイメントを手動で設定した場合、既定では古いキャッシュは有効になっていません。 use_stale_cacheのデフォルトはsymfony_l2のfalseです（バックエンドオプションの表を参照）。従来の設定でstale_cache_enabled フロントエンドを使用していた場合は、古いキャッシュを含むSymfony L2 キャッシュのパターンを使用して明示的に再作成する必要があります。

NOTE

VALKEY_BACKEND: symfony_l2 デプロイ変数を設定するAdobe Commerce on Cloud環境には、stale_cache_enabled フロントエンドを含む完全なL2設定がece-toolsによって自動生成されます。クラウド固有の動作については、Symfony L2 キャッシュの設定を参照してください。

Redisは、symfony_l2のサポートされているリモートバックエンドではありません。 この変更の一環としてValkeyに移行します。 Valkeyの設定を参照してください。

Symfony L2 キャッシュを使用した設定例

NOTE

この例は、オンプレミス app/etc/env.phpの設定を対象としています。 Adobe Commerce on Cloudの場合、キャッシュ設定はece-toolsによって自動的に管理されます。 env.phpを直接編集する代わりに、Symfony L2 キャッシュの設定を参照してください。

app/etc/env.php ファイルで、L2 キャッシュに簡略化されたsymfony_l2 バックエンドタイプを使用します。この例には、symfony_l2では推奨されていないpreload_keys設定は含まれていません。詳しくは、RemoteSynchronizedCacheから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',
                    '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 キャッシュのバックエンドオプション

オプション

タイプ

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

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

compress_data

ブーリアン

false

compression_libと組み合わせると圧縮を有効にします。 compression_libのみを設定すると、圧縮は有効になりません。

persistent

ブーリアン

true

リモートバックエンドへの永続的な接続を制御します。従来のZend キャッシュ動作に一致するようにfalse （'0'）に設定します。デフォルトは非永続的な接続です。

NOTE

remote_backend オプションはredisの値も受け入れますが、Redisは正式にはサポートされていません（最新のSymfony L2 キャッシュ実装の上記のメモを参照）。
レガシーRemoteSynchronizedCache設定で使用されているfrontend_options.write_controlは、symfony_l2には適用されません。

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

NOTE

これらの機能強化は、symfony_l2を使用したAdobe Commerce 2.4.9のデプロイメントに適用され、ACP2E-5132 パッチで利用できます。 Adobe Commerce オンプレミスの場合は、品質パッチツール（QPT）を使用してこのパッチを適用します。 Adobe Commerce on Cloudの場合、このパッチはCommerceのCloud パッチを介して自動的に配信されます。

最新のアップデートにより、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