[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeが管理する PaaS インフラストラクチャ）およびオンプレミスプロジェクトにのみ適用されます。"}

リダイレクト

リダイレクトルールの管理は、特に、時間の経過と共に変更または削除された受信リンクを失いたくない場合、web アプリケーションの一般的な要件です。

以下の例に、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 では、次の 2 つのキーを使用できます。

部分的なルートリダイレクトの例

次の例は、様々な 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" }

この設定は次のように動作します。