리디렉션

리디렉션 규칙 관리는 웹 애플리케이션의 일반적인 요구 사항이며, 특히 시간이 지남에 따라 변경되거나 제거된 수신 링크를 잃지 않으려는 경우에 유용합니다.

다음은 routes.yaml 구성 파일을 사용하여 클라우드 인프라 프로젝트에서 Adobe Commerce의 리디렉션 규칙을 관리하는 방법을 보여 줍니다. 이 항목에서 설명한 리디렉션 메서드가 작동하지 않는 경우 캐싱 헤더를 사용하여 동일한 작업을 수행할 수 있습니다.

Pro 환경 업데이트

전체 경로 리디렉션

전체 경로 리디렉션을 사용하면 routes.yaml 파일을 사용하여 간단한 경로를 정의할 수 있습니다. 예를 들어 다음과 같이 Apex 도메인에서 www 하위 도메인으로 리디렉션할 수 있습니다.

http://{default}/:
    type: redirect
    to: http://www.{default}/

부분 경로 리디렉션

.magento/routes.yaml 파일에서 패턴 일치를 기반으로 기존 경로에 부분 리디렉션 규칙을 추가할 수 있습니다.

http://{default}/:
    redirects:
        expires: 1d
        paths:
          "/from": { to: "http://example.com/" }
          "/regexp/(.*)/matching": { to: "http://example.com/$1", regexp: true }

부분 리디렉션은 애플리케이션에서 직접 제공하는 경로를 포함하여 모든 유형의 경로에서 작동합니다.

redirects에서 두 개의 키를 사용할 수 있습니다.

부분 경로 리디렉션의 예

다음 예제에서는 다양한 paths 구성 옵션을 사용하여 routes.yaml 파일에서 부분 경로 리디렉션을 지정하는 방법을 보여 줍니다.

정규 표현식 패턴 일치

다음 형식을 사용하여 정규 표현식에 따라 리디렉션 요청을 구성합니다.

http://{default}/:
    type: upstream
    redirects:
      paths:
        "/regexp/(.*)/match": { to: "http://example.com/$1", regexp: true }

이 구성은 정규 표현식에 대해 요청 경로를 필터링하고 일치하는 요청을 https://example.com(으)로 리디렉션합니다. 예를 들어 https://example.com/regexp/a/b/c/match에 대한 요청이 https://example.com/a/b/c(으)로 리디렉션됩니다.

접두사 패턴 일치

지정된 접두사 패턴으로 시작하는 경로에 대해 리디렉션 요청을 구성하려면 다음 형식을 사용하십시오.

http://{default}/:
    type: upstream
    redirects:
      paths:
        "/from": { to: "https://{default}/to", prefix: true }

이 구성은 다음과 같이 작동합니다.

접미사 패턴 일치

다음 형식을 사용하여 요청의 경로 접미사를 대상 대상에 추가하는 리디렉션 요청을 구성합니다.

http://{default}/:
    type: upstream
    redirects:
      paths: "/from": { to: "https://{default}/to", append_suffix: false }

이 구성은 다음과 같이 작동합니다.

경로별 캐시 구성

특정 경로에서 리디렉션을 캐시하는 시간을 사용자 지정하려면 다음 형식을 사용하십시오.

http://{default}/:
    type: upstream
    redirects:
    expires: 1d
      paths:
        "/from": { to: "https://example.com/" }
        "/here": { to: "https://example.com/there", expires: "2w" }

이 구성은 다음과 같이 작동합니다.