설명서Commerce구성 안내서

캐시 프론트엔드 및 유형 구성

마지막 업데이트: 2026년 6월 23일

작성 대상:

  • {"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

캐시 프론트엔드는 Commerce 캐시 유형과 캐시 저장소 백엔드 간의 인터페이스입니다. 각각 다른 백엔드 설정을 사용하는 여러 프론트엔드를 정의한 다음 각 프론트엔드에 특정 캐시 유형을(를) 할당할 수 있습니다.

이 관계를 사용하여 각 캐시 유형이 데이터를 저장하는 위치를 결정합니다.

cache type -> cache frontend -> cache backend

이 기능은 캐시된 데이터의 여러 유형에 대해 서로 다른 캐시 백엔드 또는 구성을 사용하려는 경우에 유용합니다. 예를 들어 전용 Valkey 데이터베이스를 사용하는 page_cache 프런트 엔드에 full_page 캐시 형식을 할당하고 다른 캐시 형식에서는 default 프런트 엔드를 사용할 수 있습니다.

NOTE
클라우드 프로젝트의 Adobe Commerce에 대한 캐시 구성 지침은 Redis 및 Valkey 서비스 구성에 대한 모범 사례를 참조하십시오. Redis 캐시는 Adobe Commerce 2.4.9 또는 2.4.5-p16, 2.4.6-p14, 2.4.7-p9 및 2.4.8-p5 이상의 패치 릴리스에서는 지원되지 않습니다. Redis가 지원되지 않는 캐시 구성에 Valkey를 사용합니다. 릴리스별로 지원되는 캐시 서비스에 대해서는 시스템 요구 사항을 참조하십시오.

기본 프론트엔드 사용

Commerce은 모든 캐시 유형에 대해 작동하는 default 캐시 프런트 엔드를 제공합니다. Magento\Framework\Cache\Core 프런트 엔드 캐시를 구현하여 Zend_Cache_Core을(를) 확장합니다.

대부분의 경우 프론트엔드를 사용자 지정할 필요가 없습니다. 백엔드를 구성하기만 하면 됩니다. 캐시 백 엔드 옵션을 참조하십시오.

사용자 지정 캐시 프론트엔드 정의

다음 단계는 캐시 프론트엔드를 캐시 유형과 연결하는 단계입니다.

1단계: 캐시 프론트엔드 정의 및 캐시 유형 할당

사용자 지정 캐시 프론트엔드를 정의하려면 di.xml을(를) 재정의하는 app/etc/env.php에 구성을 추가하십시오.

'cache' => [
    'frontend' => [
        '<unique frontend id>' => [
             <cache options>
        ],
    ],
    'type' => [
         <cache type 1> => [
             'frontend' => '<unique frontend id>'
        ],
         <cache type 2> => [
             'frontend' => '<unique frontend id>'
        ],
    ],
],

위치:

  • <unique frontend id> — 프론트엔드를 식별하는 고유한 이름(예: default, page_cache, stale_cache_enabled)
  • <cache options> — 이 프론트엔드에 대한 백엔드 유형 및 옵션(캐시 옵션 참조)
  • <cache type> — 이 프런트 엔드에 할당할 Commerce 캐시 유형(예: config, layout, block_html, full_page)
TIP
Adobe Commerce 2.4.9 이상에서는 Symfony 캐시 구현에서 valkey 또는 file과(와) 같은 간소화된 백엔드 유형 이름을 사용합니다. 백 엔드 예제 및 버전별 지침은 캐시 백 엔드 옵션을 참조하십시오.

2단계: 프론트엔드 및 백엔드 옵션 구성

env.php 또는 di.xml에서 프론트엔드 및 백 엔드 캐시 구성 옵션을 지정할 수 있습니다. 이 작업은 선택 사항입니다. 옵션을 지정하지 않으면 Commerce에서는 기본 프론트엔드 및 백엔드 설정을 사용합니다.

env.php 예:

'frontend' => <frontend_type>,
'frontend_options' => [
    <frontend_option> => <frontend_option_value>,
    ...
],
'backend' => <backend_type>,
'backend_options' => [
    <backend_option> => <backend_option_value>,
    ...
],

위치:

  • <frontend_type> — 낮은 수준의 프런트 엔드 캐시 유형입니다. Zend\Cache\Core과(와) 호환되는 클래스 이름을 지정하십시오.생략하면 Magento\Framework\Cache\Core이(가) 사용됩니다.

  • <frontend_option>, <frontend_option_value> — Commerce 프레임워크가 생성 시 프론트엔드 캐시에 연관 배열로 전달하는 옵션의 이름과 값입니다.

  • <backend_type> — 낮은 수준의 백엔드 캐시 유형입니다. 다음을 지정할 수 있습니다.

    • 최신 Symfony 캐시(2.4.9+, 권장): redis, valkey 또는 file과(와) 같이 간단한 이름
    • 레거시(Zend 기반): Zend_Cache_Backend_Interface을(를) 구현하는 Zend_Cache_Backend과(와) 호환되는 전체 클래스 이름

  • <backend_option>, <backend_option_value> — Commerce 프레임워크가 생성 시 연관 배열로 백엔드 캐시에 전달하는 옵션의 이름 및 값입니다.

NOTE
기존 구현과 최신 구현:
  • 레거시(Zend 기반): 'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis'
  • 최신(Symfony 캐시): Commerce 버전 2.4.9+의 경우 'backend' => 'valkey', 2.4.5 - 2.4.8 릴리스 라인의 경우 현재 패치 릴리스. 여기서 Valkey는 지원되는 캐시 백엔드입니다.
최신 Symfony 캐시 구현은 PSR-6 준수, Igbinary serialization, gzip 압축, Lua 스크립트 및 영구 연결을 통해 더 나은 성능을 제공합니다.

Zend 기반 옵션에 대해서는 Laminas 설명서를 참조하십시오. Symfony 캐시 구성에 대해서는 이 설명서의 Redis 및 Valkey 문서를 참조하십시오.

recommendation-more-help
commerce-operations-help-configuration