使用Redis進行工作階段儲存

最後更新： 2024年9月30日

建立對象：

  • 經驗豐富
  • 管理員
  • 開發人員
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-idpersistent_identifier啟用持續連線的唯一字串（例如，sess-db0）。
phpredis和php-fpm的已知問題。
session-save-redis-db資料庫唯一的Redis資料庫編號，建議用來防止資料遺失。

重要：如果您針對一種以上的快取型別使用Redis，則資料庫編號必須不同。 建議您將預設快取資料庫編號指派為0，將頁面快取資料庫編號指派為1，並將工作階段儲存資料庫編號指派為2。		0
session-save-redis-compression-thresholdcompression_threshold設為0可停用壓縮（建議在suhosin.session.encrypt = On時使用）。
字串超過64 KB的已知問題。		2048
session-save-redis-compression-libcompression_library選項： gzip、lzf、lz4或snappy。gzip
session-save-redis-log-levellog_level

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

  • 0 （緊急：只有最嚴重的錯誤）
  • 1 （警示：需要立即動作）
  • 2 （嚴重：應用程式元件無法使用）
  • 3 （錯誤：執行階段錯誤，非嚴重，但必須監視）
  • 4 （警告：其他資訊，建議）
  • 5 （注意：正常但重要的情況）
  • 6 （資訊：資訊訊息）
  • 7 （除錯：僅供開發或測試使用的最多資訊）
1
session-save-redis-max-concurrencymax_concurrency可等候鎖定一個工作階段的最大處理序數目。 對於大型生產叢集，請將此項設定為至少PHP流程數的10%。6
session-save-redis-break-after-frontendbreak_after_frontend嘗試解除前端（亦即storefront）工作階段鎖定之前等待的秒數。5
session-save-redis-break-after-adminhtmlbreak_after_adminhtml嘗試中斷Admin HTML （即管理員）工作階段鎖定之前的等待秒數。30
session-save-redis-first-lifetimefirst_lifetime非機器人第一次寫入工作階段的期限（以秒為單位），或使用0加以停用。600
session-save-redis-bot-first-lifetimebot_first_lifetime機器人第一次寫入工作階段的期限（以秒為單位），或使用0加以停用。60
session-save-redis-bot-lifetimebot_lifetime機器人後續寫入作業的工作階段期限（以秒為單位），或使用0加以停用。7200
session-save-redis-disable-lockingdisable_locking完全停用工作階段鎖定。0 (false)
session-save-redis-min-lifetimemin_lifetime工作階段存留期下限（以秒為單位）。60
session-save-redis-max-lifetimemax_lifetime最長工作階段存留期（以秒為單位）。2592000 （720小時）
session-save-redis-sentinel-mastersentinel_masterRedis Sentinel主名稱空白
session-save-redis-sentinel-serverssentinel_serversRedis Sentinel伺服器清單（以逗號分隔）空白
session-save-redis-sentinel-verify-mastersentinel_verify_master驗證Redis Sentinel主要狀態旗標0 (false)
session-save-redis-sentinel-connect-retriessentinel_connect_retriesSentinels的連線重試5

範例

下列範例將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 ...