文件Commerce設定指南

使用Redis進行工作階段儲存

Last update: Wed Aug 16 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Experienced
  • Admin
  • Developer
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。
0
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 （除錯：僅供開發或測試使用的最多資訊）
1
session-save-redis-max-concurrency
max_concurrency
可等候鎖定一個工作階段的最大處理序數目。 對於大型生產叢集，請將此項設定為至少PHP流程數的10%。
6
session-save-redis-break-after-frontend
break_after_frontend
嘗試解除前端（亦即storefront）工作階段鎖定之前等待的秒數。
5
session-save-redis-break-after-adminhtml
break_after_adminhtml
嘗試中斷Admin HTML （即管理員）工作階段鎖定之前的等待秒數。
30
session-save-redis-first-lifetime
first_lifetime
非機器人第一次寫入工作階段的期限（以秒為單位），或使用0加以停用。
600
session-save-redis-bot-first-lifetime
bot_first_lifetime
機器人第一次寫入工作階段的期限（以秒為單位），或使用0加以停用。
60
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
工作階段存留期下限（以秒為單位）。
60
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的連線重試
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' =>
    array (
      'save' => 'redis',
      'redis' =>
      array (
        '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