[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeが管理する PaaS インフラストラクチャ）およびオンプレミスプロジェクトにのみ適用されます。"}

デフォルトキャッシュに ValueKey を使用

Last update: Wed Sep 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
設定
キャッシュ

作成対象：

経験者
管理者
開発者

Commerceには、有効なページとデフォルトのキャッシュを設定するためのコマンドラインオプションが用意されています。 <Commerce-install-dir>app/etc/env.php ファイルを編集してキャッシュを設定できますが、特に初期設定では、コマンドラインを使用する方法をお勧めします。コマンドラインで検証を行うことにより、設定の構文が正しいことを確認します。

続行する前に Valkey をインストールする必要があります。

Value のデフォルトキャッシュの設定

setup:config:set コマンドを実行し、Valkey のデフォルトキャッシュのパラメーターを指定します。

bin/magento setup:config:set --cache-backend=valkey --cache-backend-valkey-<parameter>=<value>...

--cache-backend=valkey は、有効なデフォルトのキャッシュを有効にします。この機能が既に有効になっている場合は、このパラメーターを省略します。
デフォルトのキャッシュを設定するキーと値のペアのリストを --cache-backend-valkey-<parameter>=<value> に示します。

NOTE

Adobe Commerce 2.4.9-alpha2 以降、ライセンスの変更により、Valkey は CLI ツールで Redis を正式に置き換えました。 Valkey は Redis のフォークであり、ほぼ同じ機能を維持しています。 バージョン 2.4.8 以前 の場合、Valkey の設定に使用される CLI コマンドは Redis の場合と同じままであり、シームレスな後方互換性が確保され、移行またはデュアル環境のサポートが簡素化されます。次の例は、Valkey 固有のコマンドを示しています。

bin/magento setup:config:set --cache-backend=redis --cache-backend-valkey-<parameter>=<value>...

コマンドラインパラメーター

値

意味

デフォルト値

cache-backend-valkey-server

サーバー

完全修飾ホスト名、IP アドレス、または UNIX ソケットへの絶対パス。デフォルト値 127.0.0.1 は、Valkey がCommerce サーバーにインストールされていることを示します。

127.0.0.1

cache-backend-valkey-port

ポート

有効なサーバーリッスンポート

6379

cache-backend-valkey-db

データベース

デフォルトキャッシュとフルページキャッシュの両方に Valkey を使用する場合は必須です。一方のキャッシュのデータベース番号を指定する必要があります。もう一方のキャッシュは、デフォルトで 0 を使用します。

重要：複数のタイプのキャッシュに Valkey を使用する場合、データベース番号は異なる必要があります。 Adobeでは、デフォルトのキャッシュデータベース番号を 0、ページキャッシュデータベース番号を 1、セッションストレージデータベース番号を 2 に割り当てることをお勧めします。

0

cache-backend-valkey-password

password

Valkey パスワードを設定すると、組み込みのセキュリティ機能の 1 つである auth コマンドが有効になります。このコマンドは、データベースにアクセスするためにクライアントの認証を必要とします。パスワードは、Valkey の設定ファイルで直接設定されます：/etc/valkey/valkey.conf

コマンドの例

次の例では、Valkey の既定のキャッシュを有効にし、ホストを 127.0.0.1 に設定して、データベース番号を 0 に割り当てます。 Valkey は、他のすべてのパラメーターに対してデフォルト値を使用します。

bin/magento setup:config:set --cache-backend=valkey --cache-backend-valkey-server=127.0.0.1 --cache-backend-valkey-db=0

NOTE

bin/magento setup:config:set --cache-backend=redis --cache-backend-redis-server=127.0.0.1 --cache-backend-redis-db=0

ページキャッシュの設定

Commerceで Valkey ページのキャッシュを設定するには、追加のパラメーターを指定して setup:config:set コマンドを実行します。

bin/magento setup:config:set --page-cache=valkey --page-cache-valkey-<parameter>=<value>...

次のパラメーターを使用します。

--page-cache=valkey は、Valkey ページのキャッシュを有効にします。この機能が既に有効になっている場合は、このパラメーターを省略します。
ページのキャッシュを設定するキーと値のペアのリストを --page-cache-valkey-<parameter>=<value> に示します。

NOTE

bin/magento setup:config:set --page-cache=redis --page-cache-redis-<parameter>=<value>...

コマンドラインパラメーター

値

意味

デフォルト値

page-cache-valkey-server

サーバー

127.0.0.1

page-cache-valkey-port

ポート

有効なサーバーリッスンポート。

6379

page-cache-valkey-db

データベース

デフォルトキャッシュとフルページキャッシュの両方に Valkey を使用する場合は必須です。一方のキャッシュのデータベース番号を指定する必要があります。もう一方のキャッシュは、デフォルトで 0 を使用します。
重要：複数のタイプのキャッシュに Valkey を使用する場合、データベース番号は異なる必要があります。デフォルトのキャッシュ・データベース番号を 0、ページ・キャッシュ・データベース番号を 1、セッション・ストレージ・データベース番号を 2 に割り当てることをお勧めします。

0

page-cache-valkey-password

password

Valkey パスワードを設定すると、組み込みのセキュリティ機能の 1 つである auth コマンドが有効になります。このコマンドは、データベースにアクセスするためにクライアントの認証を必要とします。 Valkey 設定ファイル内でパスワードを設定します。/etc/valkey/valkey.conf

コマンドの例

次の例では、Valkey ページのキャッシュを有効にし、ホストを 127.0.0.1 に設定して、データベース番号を 1 に割り当てます。その他のパラメーターはすべてデフォルト値に設定されます。

bin/magento setup:config:set --page-cache=valkey --page-cache-valkey-server=127.0.0.1 --page-cache-valkey-db=1

NOTE

bin/magento setup:config:set --page-cache=redis --page-cache-redis-server=127.0.0.1 --page-cache-valkey-db=1

結果

2 つのコマンド例の結果、Commerceによって <Commerce-install-dir>app/etc/env.php に次のような行が追加されます。

'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'Magento\\Framework\\Cache\\Backend\\Valkey',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379'
            ],
        ],
        'page_cache' => [
            'backend' => 'Magento\\Framework\\Cache\\Backend\\Valkey',
            'backend_options' => [
                'server' => '127.0.0.1',
                'port' => '6379',
                'database' => '1',
                'compress_data' => '0'
            ]
        ]
    ]
],

新しい Valkey キャッシュの実装

[2.4.9-alpha]{class="badge negative" title="2.4.9 アルファでのみ使用可能です。"}

Adobe Commerce 2.4.9 以降、Adobeでは Valkey キャッシュの実装 \Magento\Framework\Cache\Backend\Valkey を使用することをお勧めします。

'cache' => [
    'frontend' => [
        'default' => [
            'backend' => '\\Magento\\Framework\\Cache\\Backend\\Valkey',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379'
            ],
        ],
],

有効なプリロード機能

Commerceは設定データを Valkey キャッシュに格納するので、ページ間で再利用されるデータをプリロードできます。プリロードする必要があるキーを見つけるには、Valkey からCommerceに転送されるデータを分析します。 Adobeでは、SYSTEM_DEFAULT、EAV_ENTITY_TYPES、DB_IS_UP_TO_DATE など、すべてのページに読み込まれるデータをプリロードすることをお勧めします。

Valkey は pipeline を使用して読み込みリクエストを複合します。キーにはデータベースのプレフィックスを含める必要があります。例えば、データベースのプレフィックスが 061_ の場合、プリロードキーは次のようになります。061_SYSTEM_DEFAULT

'cache' => [
    'frontend' => [
        'default' => [
            'id_prefix' => '061_',
            'backend' => 'Magento\\Framework\\Cache\\Backend\\Valkey',
            'backend_options' => [
                'server' => 'valkey',
                '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\\Valkey',
                'backend_options' => [
                    'server' => 'redis',
                    'database' => '0',
                    'port' => '6379',
                    'password' => '',
                    'compress_data' => '1',
                    'compression_lib' => ''
                ]
            ],
            'page_cache' => [
                'id_prefix' => 'b0b_'
            ]
        ],
        'allow_parallel_generation' => false
    ],

Valkey 接続の確認

Valkey とCommerceが正しく連携していることを確認するには、Valkey を実行しているサーバーにログインし、ターミナルを開いて valkey-cli monitor コマンドまたは redis-cli ping コマンドを使用します。

Valkey monitor コマンド

valkey-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 ...

Valkey ping コマンド

redis-cli ping

期待される応答は PONG です。

両方のコマンドが成功した場合は、Valkey が正しく設定されています。

圧縮データの検査

RESP.app は、圧縮されたセッションデータとページキャッシュを検査するために、Commerce 2 セッションとページキャッシュの自動解凍をサポートし、PHP セッションデータを人間が読み取り可能なフォーマットで表示します。

recommendation-more-help

386822bd-e32c-40a8-81c2-ed90ad1e198c