[オンプレミス]{class="badge informative" title="Adobe Commerce オンプレミス プロジェクトにのみ適用されます。"}
デフォルトおよびページキャッシュ用にRedisを設定
Commerceには、Redis ページとデフォルトのキャッシュを設定するためのコマンドラインオプションが用意されています。 <Commerce-install-dir>app/etc/env.php ファイルを編集してキャッシュを設定できますが、特に初期設定では、コマンドラインを使用することをお勧めします。 コマンドラインは検証を提供し、設定が構文的に正しいことを確認します。
前提条件：
続行する前にRedisをインストールします。
Redis キャッシュ実装
Adobe Commerceでは、以下のRedis キャッシュバックエンド実装を使用しています。
- 従来のRedis バックエンド （
Cm_Cache_Backend_Redis） – 古いRedis構成で使用されている非推奨の実装。 - Redis backend （
Magento\Framework\Cache\Backend\Redis） – このトピックのコマンドライン設定でデフォルトおよびページキャッシュに使用されるバックエンド。 - L2 キャッシュ バックエンド （
Magento\Framework\Cache\Backend\RemoteSynchronizedCache） - Redisをリモート バックエンドおよびローカル ファイル キャッシュ ストレージとして使用し、ノード間でキャッシュ データを同期する2段階キャッシュ実装。 2 レベル キャッシュ設定を参照してください。
Redisのデフォルトキャッシュの設定
setup:config:set コマンドを実行し、Redisの既定のキャッシュに固有のパラメーターを指定します。
bin/magento setup:config:set --cache-backend=redis --cache-backend-redis-<parameter>=<value>...
一般的なパラメーターは次のとおりです。
-
--cache-backend=redisは、Redisの既定のキャッシュを有効にします。 この機能が既に有効になっている場合は、このパラメーターを省略します。 -
--cache-backend-redis-<parameter>=<value>は、デフォルトのキャッシュを設定するキーと値のペアのリストです。
cache-backend-redis-server127.0.0.1cache-backend-redis-port6379cache-backend-redis-db重要: Redisを複数のタイプのキャッシュに使用する場合、データベース番号は異なる必要があります。 デフォルトのキャッシングデータベース番号を0に、ページキャッシングデータベース番号を1に、セッションストレージデータベース番号を2に割り当てることをお勧めします。
0cache-backend-redis-passwordauth コマンドが有効になり、クライアントはデータベースにアクセスするために認証する必要があります。 パスワードは、Redisの設定ファイル /etc/redis/redis.confで直接設定されていますcache-backend-redis-compress-data0に設定します。1cache-backend-redis-compression-libsnappy、lzf、l4z、zstdおよびgzipが含まれます。 自動的に決定するには、空白のままにします。cache-backend-redis-use-lua既定：
0.に保つ Lua モードはデフォルトで無効になっており、Luaが有効になったときにバンドルされたRedis ライブラリ（1.17.x）で発生する既知のパフォーマンスのリグレッションとGraphQL キャッシュミスの問題を防ぎます。0cache-backend-redis-use-lua-on-gcbackend_clean_cache）のLua スクリプトを有効または無効にします。既定：
1.に保つ GC中にアトミックタグ設定のクリーンアップを確保するために、意図的に有効にします。 これを指定しないと、backend_clean_cache cronがキャッシュ保存操作と同時に実行され、キャッシュタグインデックスに対応するレコードが含まれていないキャッシュエントリが残ると、競合状態が発生する可能性があります。 これにより、タグベースの無効化がサイレントに失敗します。例えば、製品価格を更新しても製品キャッシュが無効化されない場合、代わりに完全なキャッシュのフラッシュが必要になります。1Lua モード
Lua モードを有効にすると、複数のRedis操作（キャッシュ書き込み、タグ更新、ガベージコレクション）が、EVALSHA経由でサーバーサイドで実行される単一のアトミックスクリプトにバンドルされます。 これにより、同時リクエストからのインターリーブを防ぐことができます。例えば、キャッシュエントリとそのタグメンバーシップが一緒に書き込まれます。
use_luaおよびuse_lua_on_gcのデフォルト値を変更しないでください。use_lua：これをAdobe Commerce 2.4.7または2.4.8 （ライブラリcolinmollenhour/cache-backend-redis1.17.1）で有効にすると、キャッシュの破損とGraphQL キャッシュの失敗の問題が発生する可能性があります。use_lua_on_gc: Adobe Commerce 2.4.8でこれを無効にすると、ガベージコレクション中にアトミックプロテクションが削除され、タグベースのキャッシュ無効化がサイレントで失敗する可能性があります。その場合、完全なキャッシュフラッシュが必要になります。
コマンドの例（デフォルトのキャッシュ）
次の例では、Redisのデフォルトのキャッシュを有効にし、ホストを127.0.0.1に設定し、データベース番号を0に割り当てます。 Redisは、他のすべてのパラメーターにデフォルト値を使用します。
bin/magento setup:config:set --cache-backend=redis --cache-backend-redis-server=127.0.0.1 --cache-backend-redis-db=0
Redis ページキャッシュの設定
CommerceでRedis ページキャッシュを設定するには、パラメーターを追加してsetup:config:set コマンドを実行します。
bin/magento setup:config:set --page-cache=redis --page-cache-redis-<parameter>=<value>...
一般的なパラメーターは次のとおりです。
-
--page-cache=redisはRedis ページのキャッシュを有効にします。 この機能が既に有効になっている場合は、このパラメーターを省略します。 -
--page-cache-redis-<parameter>=<value>は、ページキャッシュを設定するキーと値のペアのリストです。
page-cache-redis-server127.0.0.1page-cache-redis-port6379page-cache-redis-db重要: Redisを複数のタイプのキャッシュに使用する場合、データベース番号は異なる必要があります。 デフォルトのキャッシングデータベース番号を0に、ページキャッシングデータベース番号を1に、セッションストレージデータベース番号を2に割り当てることをお勧めします。
0page-cache-redis-passwordauth コマンドが有効になり、クライアントはデータベースにアクセスするために認証する必要があります。 Redis設定ファイル内でパスワードを設定します：/etc/redis/redis.confpage-cache-redis-compress-data1に設定します。 圧縮を無効にするには、0を使用します。0page-cache-redis-compression-libsnappy、lzf、l4z、zstdおよびgzipが含まれます。 自動的に決定するには、空白のままにします。次の例では、Redis ページキャッシュを有効にし、ホストを127.0.0.1に設定し、データベース番号を1に割り当てます。 その他のパラメーターはすべてデフォルト値に設定されます。
bin/magento setup:config:set --page-cache=redis --page-cache-redis-server=127.0.0.1 --page-cache-redis-db=1
Commerce環境設定の確認
Redis キャッシュを構成するコマンドを実行すると、Commerce環境設定（<Commerce-install-dir>app/etc/env.php）が更新されます。
'cache' => [
'frontend' => [
'default' => [
'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis',
'backend_options' => [
'server' => '127.0.0.1',
'database' => '0',
'port' => '6379'
],
],
'page_cache' => [
'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis',
'backend_options' => [
'server' => '127.0.0.1',
'port' => '6379',
'database' => '1',
'compress_data' => '0'
]
]
]
],
その他のキャッシュオプションの設定
Redis プリロード機能
Commerceは設定データをRedis キャッシュに保存するため、ページ間で再利用されるデータをプリロードできます。 プリロードする必要があるキーを見つけるには、RedisからCommerceに転送されるデータを分析します。 Adobeは、SYSTEM_DEFAULT、EAV_ENTITY_TYPES、DB_IS_UP_TO_DATEなど、すべてのページに読み込まれるデータのプリロードを提案します。
Redisはpipelineを使用して読み込み要求を合成します。 キーには、データベースのプレフィックスを含める必要があります。例えば、データベースのプレフィックスが061_の場合、プリロードキーは061_SYSTEM_DEFAULTのようになります
'cache' => [
'frontend' => [
'default' => [
'id_prefix' => '061_',
'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis',
'backend_options' => [
'server' => 'redis',
'database' => '0',
'port' => '6379',
'password' => '',
'compress_data' => '1',
'compression_lib' => '',
'preload_keys' => [
'061_EAV_ENTITY_TYPES',
'061_GLOBAL_PLUGIN_LIST',
'061_DB_IS_UP_TO_DATE',
'061_SYSTEM_DEFAULT',
],
]
],
'page_cache' => [
'id_prefix' => '061_'
]
]
]
L2 キャッシュでプリロード機能を使用する場合は、キーに:hash サフィックスを追加する必要があります。 L2 キャッシュは、実際のデータではなく、データのハッシュのみを転送します。
'preload_keys' => [
'061_EAV_ENTITY_TYPES:hash',
'061_GLOBAL_PLUGIN_LIST:hash',
'061_DB_IS_UP_TO_DATE:hash',
'061_SYSTEM_DEFAULT:hash',
],
並列生成
Commerce 2.4.0 リリース以降、Adobeでは、ロック待ちを排除するユーザーに対してallow_parallel_generation オプションが導入されました。 デフォルトでは無効になっています。Adobeでは、過剰な設定やブロックがあるまで無効にすることをお勧めします。
並列生成を有効にするには:
bin/magento setup:config:set --allow-parallel-generation
フラグなので、コマンドで無効にすることはできません。 設定値を手動でfalseに設定します。
'cache' => [
'frontend' => [
'default' => [
'id_prefix' => 'b0b_',
'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis',
'backend_options' => [
'server' => 'redis',
'database' => '0',
'port' => '6379',
'password' => '',
'compress_data' => '1',
'compression_lib' => ''
]
],
'page_cache' => [
'id_prefix' => 'b0b_'
]
],
'allow_parallel_generation' => false
],
PHP Redis拡張機能
ご使用の環境でサポートされている場合は、ネイティブ PHP Redis拡張機能（phpredis）を使用します。
Aptを使用
DebianまたはUbuntuの場合は、aptを使用します。
sudo apt-get install php-redis
sudo systemctl restart php-fpm
php -m | grep redis
Pclを使用
代わりに、peclを使用してください。
sudo pecl install redis
echo "extension=redis.so" | sudo tee /etc/php/<version>/mods-available/redis.ini
sudo phpenmod redis
sudo systemctl restart php-fpm
php -m | grep redis
Redis接続の確認
RedisとCommerceが正常に連携していることを確認するには：
- RedisとCommerceを実行するサーバーにログインします。
- ターミナルを開きます。
redis-cli monitorコマンドまたはredis-cli pingコマンドを使用して、接続を確認します。
コマンドが成功した場合、Redisは実行中であり、Commerce アプリケーションと通信できます。 エラーが発生した場合は、RedisとCommerce間の接続の問題を解決する必要があります。
Redis monitor コマンド
redis-cli monitor
ページキャッシュ出力の例：
1476826133.810090 [0 127.0.0.1:52366] "select" "1"
1476826133.816293 [0 127.0.0.1:52367] "select" "0"
1476826133.817461 [0 127.0.0.1:52367] "hget" "zc:k:ea6_GLOBAL__DICONFIG" "d"
1476826133.829666 [0 127.0.0.1:52367] "hget" "zc:k:ea6_DICONFIG049005964B465901F774DB9751971818" "d"
1476826133.837854 [0 127.0.0.1:52367] "hget" "zc:k:ea6_INTERCEPTION" "d"
1476826133.868374 [0 127.0.0.1:52368] "select" "1"
1476826133.869011 [0 127.0.0.1:52369] "select" "0"
1476826133.869601 [0 127.0.0.1:52369] "hget" "zc:k:ea6_DEFAULT_CONFIG_CACHE_DEFAULT__10__235__32__1080MAGENTO2" "d"
1476826133.872317 [0 127.0.0.1:52369] "hget" "zc:k:ea6_INITIAL_CONFIG" "d"
1476826133.879267 [0 127.0.0.1:52369] "hget" "zc:k:ea6_GLOBAL_PRIMARY_PLUGIN_LIST" "d"
...
両方のコマンドが成功した場合、Redisは適切に設定されます。
圧縮データの検査
圧縮されたセッション データとページ キャッシュを調べるには、RESP.app ツールを使用します。 Commerce 2のセッションデータとページキャッシュデータの自動解凍をサポートし、PHP セッションデータを人間が読める形式で表示します。