リダイレクト管理


この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です

このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。

リダイレクト管理は、旧 URL から新しい URL への転送や、削除したページの 410 応答を、管理画面で登録する機能です。サイトのリニューアルで URL を変えたとき、カテゴリーのコードを変えたとき、別のドメインへ移ったとき、ページを削除したときなどに使います。.htaccess や Web サーバーの設定を書き換える必要はありません。

このページでは、登録の手順と、作成・編集の画面の項目を説明します。関連するページは次のとおりです。

できること

  • 転送元のパスを、完全一致・前方一致・正規表現のどれかで照合します。

  • ステータスコード 301 / 302 / 307 / 308 で転送します。410 / 451 は転送せず、そのステータスのページを返します。

  • 転送先には、サイト内のパス(/ で始まるもの)か、http / https で始まる別のドメインの URL を指定します。

  • 正規表現では、一致した部分を $1 などで転送先に差し込めます。

  • 「404 のときだけ」転送するか、「常に」転送するかを、ルールごとに選びます。

  • クエリ文字列を転送先へ引き継ぐか、クエリ文字列まで含めて照合するかを、ルールごとに選びます。

  • ルールはブログごとに持ちます。「グローバル」にすると、下の階層のブログにも適用します。

  • 優先順位(照合の順番)を決め、有効・無効を切り替えます。

  • 保存のときに、同じ転送元の重複と、転送が繰り返される設定(ループ)を見つけて止めます。

ほかの機能との違い

URL にかかわる既存の機能と役割が違います。目的に合わせて使い分けてください。

機能

役割

転送するか

リダイレクト管理

リクエストのパスをルールと照合し、別の URL へ転送する。または 410 / 451 を返す

する

エイリアス

同じブログを、別のドメインや別のブログコードでも表示する

しない

ルール

URL や条件に応じて、テーマやモジュールなどの設定を切り替える

しない

Web サーバーの設定(.htaccess など)

a-blog cms より前に、サーバーが転送する

する

リダイレクトのルールが照合するのはパスだけで、ドメインは照合しません。エイリアスの別のドメインでアクセスした場合も、同じパスのルールに一致します。ドメインごとに転送先を変えたいときは、Web サーバーの設定か、Hook(REST API と Hook でリダイレクトを扱う)を使います。

画面の場所と権限

管理画面の「その他管理」の「リダイレクト」で管理します(URL は /bid/{ブログID}/admin/redirect_index/)。サイト全体にかかわるルールは、ルートブログに置くのが基本です。

  • 使えるのは、そのブログの管理者権限を持つユーザーです(Webhook・エイリアスの管理と同じ権限です)。

  • 上の階層のブログのルールも一覧に出ますが、編集できるのは、そのブログの管理者権限があるときだけです。

登録から動作確認までの手順

旧 URL /old/page/ を新しい URL /new/page/ へ 301 で転送する例です。

  1. 転送の一覧(旧 URL と新しい URL の組)を用意します。件数が多いときは、REST API と Hook でリダイレクトを扱う の CSV からの一括登録も検討してください。

  2. 「リダイレクト管理」で「リダイレクトを作成」を押し、転送元(マッチ方式「完全一致」、パス /old/page/)・ステータスコード(301)・転送先(/new/page/)を入力して作成します。項目の意味は次の表のとおりです。

  3. 旧ページが残っていても転送したいときは、発火タイミングを「常に」にします(既定は「404 のときだけ」)。

  4. 前方一致・正規表現のルールが先にあると、そちらに先に一致します。優先順位を確かめます。

  5. ログアウトした状態(ブラウザのシークレットウィンドウなど)で /old/page/ を開き、/new/page/ へ移ることを確かめます。

「リダイレクトを作成」のモーダル
「リダイレクトを作成」のモーダル

ターミナルでは、curl -I で応答のヘッダーを確かめられます。

curl -I https://example.com/old/page/
HTTP/2 301
cache-control: no-store, max-age=0
pragma: no-cache
expires: 0
location: /new/page/
  • 転送の応答には、ブラウザにキャッシュさせないヘッダーを付けています。ルールを直したり消したりすると、次のアクセスからすぐに反映されます。

  • Location のサイト内のパスは、サブディレクトリに設置しているサイトでは設置先のディレクトリを付けて返します。

  • 日本語を含む転送先は、送るときにパーセントエンコードします。管理画面では日本語のまま入力できます。

作成・編集の画面の項目

「リダイレクトを作成」のモーダルと、一覧の行の「編集」で開く「リダイレクトを編集」のモーダルは、同じ項目です。右の列は、REST API と Hook でリダイレクトを扱う で同じ値を送るときのキーです。

項目(画面の名前)

選択肢・入力

新規作成時の値

説明・入力例

REST API のキー

ステータス

「有効」のチェック

有効(チェックあり)

有効のルールだけを照合します。チェックを外すと無効で保存され、照合しません(ルールは残ります)

status(open / close)

転送元(マッチ方式)

完全一致 / 前方一致 / 正規表現

完全一致

照合のしかたです。違いは リダイレクトの照合の規則 を参照

match_type(exact / prefix / regex)

転送元(パス)

文字列(512 文字まで)

空

完全一致・前方一致は / で始まるパス。例: /old/page/、/news/。正規表現は区切り文字なしのパターン。例: ^/blog/(\d+)$

source

ステータスコード

301 恒久的な移動 / 302 一時的な移動 / 307 一時的な移動(メソッドを保つ) / 308 恒久的な移動(メソッドを保つ) / 410 削除済み(転送しない) / 451 法的な理由で公開できない(転送しない)

301

410 / 451 を選ぶと「転送先」の欄は使いません

status_code(数値)

転送先

文字列(1024 文字まで)

空

/ で始まるサイト内のパス、または http / https で始まる URL。例: /new/page/、https://www.example.jp/。正規表現では $1 や ${1} で一致した部分を使えます

destination

発火タイミング

404 のときだけ(ページが存在しないときだけ転送する) / 常に(ページが存在していても転送する)

404 のときだけ

照合するタイミングです。リダイレクトの照合の規則 の「発火タイミングと照合の順番」を参照

trigger(not_found_only / always)

クエリ文字列

転送先へ引き継ぐ / 引き継がない / クエリも照合する(完全一致のみ)

転送先へ引き継ぐ

「クエリも照合する」は完全一致のときだけ選べます。転送元に ?id=5 のようにクエリまで書きます

query(pass / ignore / exact)

グローバル

「下の階層のブログにも適用する」のチェック

チェックあり(使えないブログではなし)

チェックすると、下の階層のすべてのブログでも照合します。下の階層に別のドメインのブログがあるブログでは選べません

scope(global / local)

メモ

文字列(255 文字まで)

空

管理用のメモです

name

REST API で作成するときの既定値は、画面と一つだけ違います

REST API で scope を省くと local(このブログだけ)で作成します。画面の既定はグローバルです。

保存できないもの

保存するときに次の検査をし、当てはまる項目の下にメッセージを出します。

画面のメッセージ

原因と直し方

転送元を入力してください。

転送元が空です

転送元は「/」で始まるパスで入力してください。前方一致でサイト全体(「/」)は指定できません。

完全一致・前方一致で / から始まっていない、または前方一致で / だけを指定しています。サイト全体を転送するときは正規表現 ^/(.*)$ を使います

正規表現の書き方に誤りがあります。

正規表現として解釈できません。括弧の数や、エスケープの漏れを確かめます

転送元に「?」を含められるのは、完全一致で「クエリも照合する」を選んだときだけです。

転送元に ? を書いたまま、別のマッチ方式やクエリ文字列の設定を選んでいます

同じ転送元・同じ発火タイミングのリダイレクトがすでにあります。

このブログの有効なルールに、同じマッチ方式・同じ転送元・同じ発火タイミングのものがあります。片方を無効にするか、削除します

転送元が長すぎます。日本語や記号はエンコードすると長くなるため、エンコードした後で512文字以内になるよう短くしてください。

日本語の多いパスは、エンコードした後の長さで数えます

転送先を入力してください。

301 / 302 / 307 / 308 で転送先が空です

転送先は「/」で始まるパスか、http / https で始まる URL で入力してください。

//example.com、javascript:、.. を含むパス、ユーザー名やパスワードを含む URL などは使えません

転送先のドメインの部分には「$1」などの後方参照を使えません。パス・クエリの部分で使ってください。

https://example.com$1 のように、ドメインの直後に後方参照を書いています。https://example.com/$1 のように / の後ろに書きます

転送先が転送元に戻るため、転送が繰り返されます。

転送先が自分の転送元に一致する、またはほかのルールをたどって転送元に戻ります。転送先を見直します

下の階層に別のドメインのブログがあるため、下の階層のブログには適用できません。

「グローバル」を外します

優先順位

一覧には、このブログのルールと、上の階層のブログで「グローバル」にしたルールが、照合する順に並びます。優先順位は一覧の並びで決まり、行をドラッグして並べ替えます。

  • 並べ替えられるのは、このブログのルールだけです。

  • 下の階層のブログのルールは、上の階層のブログのルールより先に照合されます。そのため、上の階層のルールより後ろへは移動できません。

  • 有効にするとき、同じ転送元のルールがすでに有効な場合や、転送が繰り返される場合は、そのルールは無効のまま残り、エラーで知らせます。

  • 削除したルールは戻せません。一時的に止めるだけなら、無効にします。

ステータスコードの使い分け

コード

画面の表示

使う場面

301

恒久的な移動

URL を恒久的に変えたとき。サイトのリニューアルやドメインの移転など、多くの場合はこれを選びます

302

一時的な移動

キャンペーン期間だけ別のページへ案内するなど、元の URL に戻す予定があるとき

307

一時的な移動(メソッドを保つ)

302 と同じ用途で、リクエストのメソッドを変えずに転送したいとき

308

恒久的な移動(メソッドを保つ)

301 と同じ用途で、リクエストのメソッドを変えずに転送したいとき

410

削除済み(転送しない)

ページを削除し、代わりのページが無いとき。404 より明確に「削除した」ことを伝えます

451

法的な理由で公開できない(転送しない)

裁判所の命令や権利者の申し立てなど、法的な理由で公開をやめたとき

転送するのは GET / HEAD のアクセスだけです。フォームの送信(POST など)は、307 / 308 を選んでも転送しません。410 / 451 のときに表示するページは、410 / 451 のページをテーマで作る を参照してください。

よくある質問・つまずき

転送されない

次の順に確かめてください。

  1. ルールが有効か。 一覧の「ステータス」が「有効」になっているかを見ます。

  2. ログインしていないか。 ログインしていると、非公開のエントリーなどが表示されるため、「404 のときだけ」のルールが動かないことがあります。ログアウトするか、シークレットウィンドウで確かめます。

  3. 旧 URL のページが残っていないか。 「404 のときだけ」は、ページが表示できるときは転送しません。旧ページを残したまま転送するなら「常に」にします。

  4. 先に別のルールに一致していないか。 照合は優先順位の順で、最初に一致したルールを使います。上にある前方一致・正規表現のルールに先に一致していないかを見ます。

  5. パスの書き方。 大文字と小文字は区別します(/Old/ と /old/ は別)。サイトのルートからのパスで書きます。

  6. 子ブログの URL ではないか。 /news/old/ のように子ブログのコードで始まる URL は、子ブログのアクセスとして照合します。ルートブログのルールを効かせるには「グローバル」にするか、子ブログにルールを登録します。

  7. 実在するファイルではないか。 同梱の .htaccess は、実在するファイル(/old/page.html というファイルが残っている、など)へのアクセスを a-blog cms に渡しません。ファイルを削除してください。

  8. 照合しない URL ではないか。 管理画面・API・テンプレートを指定したアクセス・ログイン画面などは照合しません(リダイレクトの照合の規則 の「照合しない URL」)。

転送が 2 回起きる

同梱の .htaccess は、拡張子の無いパスの末尾に / を付けて 301 で転送します。/old/page へのアクセスは、まず /old/page/ へ転送され、そのあとでルールに一致します。照合では末尾の / の有無を区別しないため、ルールは 1 つで足ります。

一時的に別のページへ案内したい

キャンペーン期間だけ案内するときは、ステータスコードを「302 一時的な移動」、発火タイミングを「常に」にします。期間が終わったら、ルールのステータスを無効にするか削除します。

「グローバル」を選べない

下の階層に、別のドメインのブログがあるブログでは選べません(「下の階層に別のドメインのブログがあるため、このブログでは使えません。」)。パスだけで照合するため、別のドメインのブログで意図せず一致するのを防ぐためです。子ブログそれぞれにルールを登録してください。

ブログを削除したら、ルールはどうなるか

ブログを削除すると、そのブログのリダイレクトのルールも削除されます。