使用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-timeouttimeout连接超时（秒）。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-libcompress_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（假）
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（假）
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 Lifetime设置为0（默认值为3600），则Redis会话将在min_lifetime中指定的秒数内过期（默认值为60）。 此差异是由于Redis和会话Cookie对生命周期值0的解释方式不同所致。 如果不希望出现这种行为，请增加min_lifetime的值。

验证Redis连接

要验证Redis和Commerce是否协同工作，请登录到运行Redis的服务器，打开终端，然后使用Redis monitor命令或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 ...