既定のキャッシュに Redis を使用
Commerceには、Redis ページとデフォルトのキャッシングを設定するためのコマンドラインオプションが用意されています。 <Commerce-install-dir>app/etc/env.php ファイルを編集してキャッシュを設定できますが、特に初期設定では、コマンドラインを使用する方法をお勧めします。 コマンドラインで検証を行うことにより、設定の構文が正しいことを確認します。
続行する前に Redis をインストール してください。
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-use-luaLUA:Lua を使用すると、Redis 内でアプリケーションロジックの一部を実行でき、パフォーマンスを向上させ、アトミック実行を通じてデータの一貫性を確保できます。
0--cache-backend-redis-use-lua-on-gcLUA:Lua を使用すると、Redis 内でアプリケーションロジックの一部を実行でき、パフォーマンスを向上させ、アトミック実行を通じてデータの一貫性を確保できます。
1コマンドの例
次の例では、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.confコマンドの例
次の例では、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
結果
2 つのコマンド例の結果、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'
]
]
]
],
EC2 インスタンスでのAWS ElastiCache の使用
Commerce 2.4.3 以降、Amazon EC2 でホストされるインスタンスは、ローカル Redis インスタンスの代わりにAWS ElastiCache を使用する場合があります。
Redis クラスターの設定
AWSで Redis クラスターを設定する の後、ElastiCache を使用するように EC2 インスタンスを設定します。
-
EC2 インスタンスと同じリージョンおよびVPCに ElastiCache クラスターを作成 します。
-
接続を確認します。
-
EC2 インスタンスへの SSH 接続を開きます。
-
EC2 インスタンスに、Redis クライアントをインストールします。
code language-bash sudo apt-get install redis -
EC2 セキュリティグループにインバウンド規則を追加します：タイプ
- Custom TCP, port - 6379, Source - 0.0.0.0/0 -
ElastiCache クラスターセキュリティ グループに受信規則を追加します：タイプ
- Custom TCP, port - 6379, Source - 0.0.0.0/0 -
Redis CLI に接続します。
code language-bash redis-cli -h <ElastiCache Primary Endpoint host> -p <ElastiCache Primary Endpoint port>
-
クラスターを使用するようにCommerceを設定します
Commerceでは、複数のタイプのキャッシュ設定をサポートしています。 一般に、キャッシュ設定はフロントエンドとバックエンドに分かれます。 フロントエンドキャッシュは default に分類され、あらゆるキャッシュタイプで使用されます。 パフォーマンスを向上させるには、カスタマイズするか、下位レベルのキャッシュに分割します。 一般的な Redis 設定は、デフォルトのキャッシュとページキャッシュを独自の Redis データベース（RDB）に分離することです。
setup コマンドを実行して、Redis エンドポイントを指定します。
Commerceを Redis 用にデフォルトキャッシュとして設定するには：
bin/magento setup:config:set --cache-backend=redis --cache-backend-redis-server=<ElastiCache Primary Endpoint host> --cache-backend-redis-port=<ElastiCache Primary Endpoint port> --cache-backend-redis-db=0
Commerceを Redis ページキャッシュ用に設定するには：
bin/magento setup:config:set --page-cache=redis --page-cache-redis-server=<ElastiCache Primary Endpoint host> --page-cache-redis-port=<ElastiCache Primary Endpoint port> --page-cache-redis-db=1
セッションストレージに Redis を使用するようにCommerceを設定するには：
bin/magento setup:config:set --session-save=redis --session-save-redis-host=<ElastiCache Primary Endpoint host> --session-save-redis-port=<ElastiCache Primary Endpoint port> --session-save-redis-log-level=4 --session-save-redis-db=2
接続の検証
Commerceが ElastiCache と通信していることを確認するには:
-
Commerce EC2 インスタンスへの SSH 接続を開きます。
-
Redis モニタを起動します。
code language-bash redis-cli -h <ElastiCache-Primary-Endpoint-host> -p <ElastiCache-Primary-Endpoint-port> monitor -
Commerce UI でページを開きます。
-
ターミナルで cache output を確認します。
新しい Redis キャッシュの実装
Commerce 2.3.5 以降では、拡張 Redis キャッシュ実装 \Magento\Framework\Cache\Backend\Redis を使用することをお勧めします。
'cache' => [
'frontend' => [
'default' => [
'backend' => '\\Magento\\Framework\\Cache\\Backend\\Redis',
'backend_options' => [
'server' => '127.0.0.1',
'database' => '0',
'port' => '6379'
],
],
],
Redis プリロード機能
Commerceは設定データを Redis キャッシュに保存するので、ページ間で再利用されるデータをプリロードできます。 プリロードする必要があるキーを見つけるには、Redis からCommerceに転送されるデータを分析します。 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',
],
並列生成
2.4.0 リリース以降、ロックの待機を排除したいユーザーに allow_parallel_generation のオプションが導入されました。
デフォルトでは無効になっているので、過剰な設定やブロックが発生するまで無効にすることをお勧めします。
並列生成を使用可能にする手順は、次のとおりです。
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
],
Redis 接続の確認
Redis とCommerceが連携していることを確認するには、Redis を実行しているサーバにログインし、ターミナルを開いて Redis monitor コマンドまたは ping コマンドを使用します。
Redis モニターコマンド
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"
1476826133.883312 [0 127.0.0.1:52369] "hget" "zc:k:ea6_GLOBAL__EVENT_CONFIG_CACHE" "d"
1476826133.898431 [0 127.0.0.1:52369] "hget" "zc:k:ea6_DB_PDO_MYSQL_DDL_STAGING_UPDATE_1" "d"
1476826133.898794 [0 127.0.0.1:52369] "hget" "zc:k:ea6_RESOLVED_STORES_D1BEFA03C79CA0B84ECC488DEA96BC68" "d"
1476826133.905738 [0 127.0.0.1:52369] "hget" "zc:k:ea6_DEFAULT_CONFIG_CACHE_STORE_DEFAULT_10__235__32__1080MAGENTO2" "d"
... more ...
1476826210.634998 [0 127.0.0.1:52439] "hmset" "zc:k:ea6_MVIEW_CONFIG" "d" "a:18:{s:19:\"design_config_dummy\";a:4:{s:7:\"view_id\";s:19:\"design_config_dummy\";s:12:\"action_class\";s:39:\"Magento\\Theme\\Model\\Indexer\\Mview\\Dummy\";s:5:\"group\";s:7:\"indexer\";s:13:\"subscriptions\";a:0:{}}s:14:\"customer_dummy\";a:4:{s:7:\"view_id\";s:14:\"customer_dummy\";s:12:\"action_class\";s:42:\"Magento\\Customer\\Model\\Indexer\\Mview\\Dummy\";s:5:\"group\";s:7:\"indexer\";s:13:\"subscriptions\";a:0:{}}s:13:\"cms_page_grid\";a:4:{s:7:\"view_id\";s:13:\"cms_page_grid\";s:12:\"action_class\";s:43:\"Magento\\Catalog\\Model\\Indexer\\Category\\Flat\";s:5:\"group\";s:7:\"indexer\";s:13:\"subscriptions\";a:1:{s:8:\"cms_page\";a:3:{s:4:\"name\";s:8:\"cms_page\";s:6:\"column\";s:7:\"page_id\";s:18:\"subscription_model\";N;}}}s:21:\"catalog_category_flat\";a:4:{s:7:\"view_id\";s:21:\"catalog_category_flat\";s:12:\"action_class\";s:43:\"Magento\\Catalog\\Model\\Indexer\\Category\\Flat\";s:5:\"group\";s:7:\"indexer\";s:13:\"subscriptions\";a:6:{s:23:\"catalog_category_entity\";a:3:{s:4:\"name\";s:23:\"catalog_category_entity\";s:6:\"column\";s:9:\"entity_id\";s:18:\"subscription_model\";N;}s:31:\"catalog_category_entity_decimal\";a:3:{s:4:\"name\";s:31:\"catalog_category_entity_decimal\";s:6:\"column\";s:9:\"entity_id\";s:18:\"subscription_model\";s:71:\"Magento\\CatalogStaging\\Model\\Mview\\View\\Category\\Attribute\\Subscription\";}s:27:\"catalog_category_entity_int\";a:3:{s:4:\"name\";s:27:\"catalog_category_entity_int\";s:6:\"column\";s:9:\"entity_id\";s:18:\"subscription_model\";s:71:\"Magento\\CatalogStaging\\Model\\Mview\\View\\Category\\Attribute\\Subscription\";}s:28:\"catalog_category_entity_text\";a:3:{s:4:\"name\";s:28:\"catalog_category_entity_text\";s:6:\"column\";s:9:\"entity_id\";s:18:\"subscription_model\";s:71:\"Magento\\CatalogStaging\\Model\\Mview\\View\\Category\\Attribute\\Subscription\";}s:31:\"catalog_category_entity_varchar\";a:3:{s:4:\"name\";s:31:\"catalog_category_entity_varchar\";s:6:\"column\";s:9:\"entity_id\";s:18:\"subscription_model\";s:71:\"Magento\\CatalogStaging\\Model\\Mview\\View\\Category\\Attribute\\Subscription\";}s:32:\"catalog_category_entity_datetime\";a:3:{s:4:\"name\";s:32:\"catalog_category_entity_datetime\";s:6:\"column\";s:9:\"entity_id\";s:18:\"subscription_model\";s:71:\"Magento\\CatalogStaging\\Model\\Mview\\View\\Category\\Attribute\\Subscription\";}}}s:24:\"catalog_category_product\";a:4:{s:7:\"view_id\";s:24:\"catalog_category_product\";s:12:\"action_class\";s:46:\"Magento\\Catalog\\Model\\Indexer\\Category\\Product\";s:5:\"group\";s:7:\"indexer\";s:13:\"subscriptions\";a:2:{s:23:\"catalog_category_entity\";a:3:{s:4:\"name\";s:23:\"catalog_category_entity\";s:6:\"column\"
... more ...
Redis ping コマンド
redis-cli ping
期待される応答は PONG です。
両方のコマンドが成功すると、Redis が正しく設定されます。
圧縮データの検査
RESP.app は、圧縮されたセッションデータとページキャッシュを検査するために、Commerce 2 Session and Page cache の自動解凍をサポートし、PHP セッションデータを人間が読み取り可能な形式で表示します。