リダイレクト

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

次に、routes.yaml設定ファイルを使用して、Adobe Commerce on cloud infrastructure プロジェクトのリダイレクトルールを管理する方法を示します。 このトピックで説明したリダイレクト方法が機能しない場合は、キャッシュヘッダーを使用して同じことを行うことができます。

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 }

部分リダイレクトは、アプリケーションが直接提供するルートを含む、あらゆるタイプのルートで機能します。

次の2つのキーを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" }

この設定は次のように機能します。