使用Redis進行工作階段儲存

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