使用Redis進行工作階段儲存

Last update: Mon Sep 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
設定
快取

建立對象：

經驗豐富
管理員
開發人員

IMPORTANT

您必須安裝Redis，才能繼續。

Commerce現在提供命令列選項，可用於設定Redis工作階段存放區。在舊版中，您編輯了<Commerce install dir>app/etc/env.php檔案。命令列提供驗證，且是建議的設定方法，但您仍可編輯env.php檔案。

執行setup:config:set命令並指定Redis特定引數。

bin/magento setup:config:set --session-save=redis --session-save-redis-<parameter_name>=<parameter_value>...

位置

--session-save=redis啟用Redis工作階段存放區。如果已啟用此功能，請省略此引數。

--session-save-redis-<parameter_name>=<parameter_value>是設定工作階段存放區的引數/值配對清單：

命令列引數

引數名稱

含義

預設值

session-save-redis-host

主機

完整的主機名稱、IP位址或絕對路徑（若使用UNIX通訊端）。

localhost

session-save-redis-port

連線埠

Redis伺服器接聽連線埠。

6379

session-save-redis-password

密碼

如果Redis伺服器需要驗證，請指定密碼。

空白

session-save-redis-timeout

逾時

連線逾時（秒）。

2.5

session-save-redis-persistent-id

persistent_identifier

啟用持續連線的唯一字串（例如，sess-db0）。
phpredis和php-fpm的已知問題。

session-save-redis-db

資料庫

唯一的Redis資料庫編號，建議用來防止資料遺失。

重要：如果您針對一種以上的快取型別使用Redis，則資料庫編號必須不同。建議您將預設快取資料庫編號指派為0，將頁面快取資料庫編號指派為1，並將工作階段儲存資料庫編號指派為2。

session-save-redis-compression-threshold

compression_threshold

設為0可停用壓縮（建議在suhosin.session.encrypt = On時使用）。
字串超過64 KB的已知問題。

2048

session-save-redis-compression-lib

compression_library

選項： gzip、lzf、lz4或snappy。

gzip

session-save-redis-log-level

log_level

設為下列任一項，依從少到多的順序列出：

0 （緊急：只有最嚴重的錯誤）
1 （警示：需要立即動作）
2 （嚴重：應用程式元件無法使用）
3 （錯誤：執行階段錯誤，非嚴重，但必須監視）
4 （警告：其他資訊，建議）
5 （注意：正常但重要的情況）
6 （資訊：資訊訊息）
7 （除錯：僅供開發或測試使用的最多資訊）

session-save-redis-max-concurrency

max_concurrency

可等候鎖定一個工作階段的最大處理序數目。對於大型生產叢集，請將此項設定為至少PHP流程數的10%。

session-save-redis-break-after-frontend

break_after_frontend

嘗試解除前端（亦即storefront）工作階段鎖定之前等待的秒數。

session-save-redis-break-after-adminhtml

break_after_adminhtml

嘗試中斷Admin HTML （即管理員）工作階段鎖定之前的等待秒數。

session-save-redis-first-lifetime

first_lifetime

非機器人第一次寫入工作階段的期限（以秒為單位），或使用0加以停用。

600

session-save-redis-bot-first-lifetime

bot_first_lifetime

機器人第一次寫入工作階段的期限（以秒為單位），或使用0加以停用。

session-save-redis-bot-lifetime

bot_lifetime

機器人後續寫入作業的工作階段期限（以秒為單位），或使用0加以停用。

7200

session-save-redis-disable-locking

disable_locking

完全停用工作階段鎖定。

0 (false)

session-save-redis-min-lifetime

min_lifetime

工作階段存留期下限（以秒為單位）。

session-save-redis-max-lifetime

max_lifetime

最長工作階段存留期（以秒為單位）。

2592000 （720小時）

session-save-redis-sentinel-master

sentinel_master

Redis Sentinel主名稱

空白

session-save-redis-sentinel-servers

sentinel_servers

Redis Sentinel伺服器清單（以逗號分隔）

空白

session-save-redis-sentinel-verify-master

sentinel_verify_master

驗證Redis Sentinel主要狀態旗標

0 (false)

session-save-redis-sentinel-connect-retries

sentinel_connect_retries

Sentinels的連線重試

範例

下列範例將Redis設為工作階段資料存放區，將主機設為127.0.0.1，將記錄層級設為4，並將資料庫編號設為2。所有其他引數都會設定為預設值。

bin/magento setup:config:set --session-save=redis --session-save-redis-host=127.0.0.1 --session-save-redis-log-level=4 --session-save-redis-db=2

結果

Commerce將類似下列的行新增至<magento_root>app/etc/env.php：

'session' => [
    'save' => 'redis',
    'redis' => [
        'host' => '127.0.0.1',
        'port' => '6379',
        'password' => '',
        'timeout' => '2.5',
        'persistent_identifier' => '',
        'database' => '2',
        'compression_threshold' => '2048',
        'compression_library' => 'gzip',
        'log_level' => '4',
        'max_concurrency' => '6',
        'break_after_frontend' => '5',
        'break_after_adminhtml' => '30',
        'first_lifetime' => '600',
        'bot_first_lifetime' => '60',
        'bot_lifetime' => '7200',
        'disable_locking' => '0',
        'min_lifetime' => '60',
        'max_lifetime' => '2592000',
    ],
],

INFO

工作階段記錄的TTL使用Cookie期限的值，此值是在管理員中設定。如果「Cookie期限」設為0 （預設為3600），則Redis工作階段會在min_lifetime中指定的秒數內到期（預設為60）。這種差異是因為Redis和工作階段Cookie解讀期限值0的方式有所差異。如果不希望出現這種行為，請增加min_lifetime的值。

驗證Redis連線

若要確認Redis與Commerce是否共同運作，請登入執行Redis的伺服器、開啟終端機，然後使用Redis監視指令或ping指令。

Redis監視命令

redis-cli monitor

工作階段儲存輸出範例：

1476824834.187250 [0 127.0.0.1:52353] "select" "0"
1476824834.187587 [0 127.0.0.1:52353] "hmget" "sess_sgmeh2k3t7obl2tsot3h2ss0p1" "data" "writes"
1476824834.187939 [0 127.0.0.1:52353] "expire" "sess_sgmeh2k3t7obl2tsot3h2ss0p1" "1200"
1476824834.257226 [0 127.0.0.1:52353] "select" "0"
1476824834.257239 [0 127.0.0.1:52353] "hmset" "sess_sgmeh2k3t7obl2tsot3h2ss0p1" "data" "_session_validator_data|a:4:{s:11:\"remote_addr\";s:12:\"10.235.34.14\";s:8:\"http_via\";s:0:\"\";s:20:\"http_x_forwarded_for\";s:0:\"\";s:15:\"http_user_agent\";s:115:\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/53.0.2785.143 Safari/537.36\";}_session_hosts|a:1:{s:12:\"10.235.32.10\";b:1;}admin|a:0:{}default|a:2:{s:9:\"_form_key\";s:16:\"e331ugBN7vRjGMgk\";s:12:\"visitor_data\";a:3:{s:13:\"last_visit_at\";s:19:\"2016-10-18 21:06:37\";s:10:\"session_id\";s:26:\"sgmeh2k3t7obl2tsot3h2ss0p1\";s:10:\"visitor_id\";s:1:\"9\";}}adminhtml|a:0:{}customer_base|a:1:{s:20:\"customer_segment_ids\";a:1:{i:1;a:0:{}}}checkout|a:0:{}" "lock" "0"
... more ...

Redis ping指令

redis-cli ping

PONG應為回應。

如果兩個指令都成功，Redis就會正確設定。

檢查壓縮資料

若要檢查壓縮的「工作階段」資料和「頁面快取」，RESP.app支援Commerce 2「工作階段」和「頁面」快取的自動解壓縮，並以可讀取的格式顯示PHP工作階段資料。

recommendation-more-help

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