PaaS만

세션 스토리지에 Redis 사용

마지막 업데이트: 2024년 9월 30일

작성 대상:

  • 경험
  • 관리자
  • 개발자
중요
계속하려면 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호스트UNIX 소켓을 사용하는 경우 정규화된 호스트 이름, IP 주소 또는 절대 경로입니다.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일 때 권장됨).
문자열이 64KB를 초과하는 알려진 문제.		2048
session-save-redis-compression-libcompression_library옵션: gzip, lzf, lz4 또는 snappy.gzip
session-save-redis-log-levellog_level

세부 정보(verbose)부터 세부 정보(verbose)까지 순서대로 나열되는 다음 중 하나로 설정합니다.

  • 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_adminhtmladminhtml(즉, Admin) 세션의 잠금을 해제하기 전에 대기하는 시간(초)입니다.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-serversentinel_serversRedis Sentinel 서버 목록, 쉼표로 구분비어 있음
session-save-redis-sentinel-verify-mastersentinel_verify_masterRedis Sentinel 마스터 상태 플래그 확인0(false)
session-save-redis-sentinel-connect-retriessentinel_connect_retries센티널에 대한 연결 재시도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',
    ],
],
정보
세션 레코드에 대한 TTL은 관리자에 구성된 쿠키 수명 값을 사용합니다. 쿠키 라이프타임이 0으로 설정된 경우(기본값 3600), Redis 세션은 min_lifetime에 지정된 초 수(기본값 60)로 만료됩니다. 이러한 불일치는 Redis 및 세션 쿠키가 라이프타임 값 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 ...