DokumentationHandelKonfigurationshandbok

Använd Redis för sessionslagring

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

Skapat för:

  • Erfaren
  • Administratör
  • Utvecklare
IMPORTANT
Du måste installera Redis innan du kan fortsätta.

Commerce har nu kommandoradsalternativ för att konfigurera Redis-sessionslagring. I tidigare versioner redigerade du filen <Commerce install dir>app/etc/env.php. Kommandoraden innehåller validering och är den rekommenderade konfigurationsmetoden, men du kan fortfarande redigera filen env.php.

Kör kommandot setup:config:set och ange Redis-specifika parametrar.

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

där

--session-save=redis aktiverar Redis-sessionslagring. Om den här funktionen redan har aktiverats utelämnar du den här parametern.

--session-save-redis-<parameter_name>=<parameter_value> är en lista över parameter-/värdepar som konfigurerar sessionslagring:

Kommandoradsparameter
Parameternamn
Betydelse
Standardvärde
session-save-redis-host
värd
Fullständigt kvalificerat värdnamn, IP-adress eller absolut sökväg om UNIX-socketar används.
localhost
session-save-redis-port
port
Redis-serverns avlyssningsport.
6379
session-save-redis-password
lösenord
Anger ett lösenord om Redis-servern kräver autentisering.
tom
session-save-redis-timeout
timeout
Anslutningens timeout, i sekunder.
2,5
session-save-redis-persistent-id
persistent_identifier
Unik sträng för att aktivera beständiga anslutningar (till exempel sess-db0).
Kända fel med phpredis och php-fpm.
session-save-redis-db
databas
Unikt Redis-databasnummer som rekommenderas för att skydda mot dataförlust.

Viktigt: Om du använder Redis för mer än en typ av cachelagring måste databasnumren vara olika. Vi rekommenderar att du tilldelar standardvärdet för cachningsdatabasen till 0, sidcachningsdatabasnumret till 1 och sessionslagringsdatabasnumret till 2.
0
session-save-redis-compression-threshold
compression_threshold
Ange 0 om du vill inaktivera komprimering (rekommenderas när suhosin.session.encrypt = On).
Känt fel med strängar som är större än 64 kB.
2048
session-save-redis-compression-lib
compression_library
Alternativ: gzip, lzf, lz4 eller snappy.
gzip
session-save-redis-log-level
log_level

Ange något av följande, i ordning från minst utförlig till mest utförlig:

  • 0 (kris: endast de allvarligaste felen)
  • 1 (varning: omedelbar åtgärd krävs)
  • 2 (kritiskt: programkomponenten är inte tillgänglig)
  • 3 (fel: körningsfel, inte kritiska men måste övervakas)
  • 4 (varning: ytterligare information rekommenderas)
  • 5 (observera: normalt men signifikant tillstånd)
  • 6 (info: informationsmeddelanden)
  • 7 (debug: the most information for development or testing only)
1
session-save-redis-max-concurrency
max_concurrency
Maximalt antal processer som kan vänta på ett lås i en session. För stora produktionskluster ska detta anges till minst 10 % av antalet PHP-processer.
6
session-save-redis-break-after-front
break_after_front_tend
Antal sekunder att vänta innan du försöker bryta låset för frontend-sessionen (dvs. storefront).
5
session-save-redis-break-after-adminhtml
break_after_adminhtml
Antal sekunder att vänta innan låset för en adminhtml-session (d.v.s. Admin) bryts.
30
session-save-redis-first-life
first_life
Livstid, i sekunder, för session för icke-bots vid första skrivning, eller använd 0 för att inaktivera.
600
session-save-redis-bot-first-life
bot_first_life
Livstid, i sekunder, för session för bots vid första skrivning, eller använd 0 för att inaktivera.
60
session-save-redis-bot-life
bot_life
Livstid, i sekunder, för sessioner för botar vid efterföljande skrivningar, eller använd 0 för att inaktivera.
7200
session-save-redis-disable-locking
disable_locking
Inaktivera sessionslåsning helt.
0 (false)
session-save-redis-min-life
min_livstid
Minsta sessionstid, i sekunder.
60
session-save-redis-max-life
max_livstid
Maximal sessionstid, i sekunder.
2592000 (720 timmar)
session-save-redis-sentinel-master
sentinel_master
Redis Sentinel master name
tom
session-save-redis-sentinel-servers
sentinel_servers
Lista över Redis Sentinel-servrar, kommaavgränsade
tom
session-save-redis-sentinel-verify-master
sentinel_verify_master
Verifiera Redis Sentinels huvudstatusflagga
0 (false)
session-save-redis-sentinel-connect-retry
sentinel_connect_reentries
Anslutningsförsök för sändare
5

Exempel

I följande exempel ställs Redis in som sessionsdatalager, värden ställs in på 127.0.0.1, loggnivån ställs in på 4 och databasnumret ställs in på 2. Alla andra parametrar ställs in på standardvärdet.

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

Resultat

Commerce lägger till rader som liknar följande i <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 för sessionsposter använder värdet för cookie-livstid, som har konfigurerats i administratören. Om cookie-livstiden är 0 (standardvärdet är 3600) upphör Redis-sessioner att gälla i det antal sekunder som anges i min_livstid (standardvärdet är 60). Skillnaden beror på skillnader i hur Redis och sessionscookies tolkar livstidsvärdet 0. Om du inte vill använda det beteendet ökar du värdet för min_livstid.

Bekräfta Redis-anslutning

Om du vill verifiera att Redis och Commerce fungerar tillsammans loggar du in på servern som kör Redis, öppnar en terminal och använder kommandot Redis monitor eller ping.

Redis-bildskärm, kommando

redis-cli monitor

Exempel på sessionslagringsutdata:

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, kommando

redis-cli ping

PONG ska vara svaret.

Om båda kommandona lyckades är Redis korrekt konfigurerat.

Inspektera komprimerade data

Om du vill inspektera komprimerade sessionsdata och sidcache stöder RESP.app automatisk dekomprimering av Commerce 2 Session och Page Cache och visar PHP-sessionsdata i en läsbar form.

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c