リダイレクト管理
この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です
このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。
リダイレクト管理は、旧 URL から新しい URL への転送や、削除したページの 410 応答を、管理画面で登録する機能です。サイトのリニューアルで URL を変えたとき、カテゴリーのコードを変えたとき、別のドメインへ移ったとき、ページを削除したときなどに使います。.htaccess や Web サーバーの設定を書き換える必要はありません。
このページでは、登録の手順と、作成・編集の画面の項目を説明します。関連するページは次のとおりです。
よくある移行のパターンと登録例:リニューアル・カテゴリーのコードの変更・ドメインの移転・ページの削除などの登録例
リダイレクトの照合の規則:どの URL に、どの順番で一致するか
410 / 451 のページをテーマで作る:410 / 451 のときに表示するページ
REST API と Hook でリダイレクトを扱う:REST API での一括登録と、プラグインからの拡張
できること
転送元のパスを、完全一致・前方一致・正規表現のどれかで照合します。
ステータスコード 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 で転送する例です。
転送の一覧(旧 URL と新しい URL の組)を用意します。件数が多いときは、REST API と Hook でリダイレクトを扱う の CSV からの一括登録も検討してください。
「リダイレクト管理」で「リダイレクトを作成」を押し、転送元(マッチ方式「完全一致」、パス
/old/page/)・ステータスコード(301)・転送先(/new/page/)を入力して作成します。項目の意味は次の表のとおりです。旧ページが残っていても転送したいときは、発火タイミングを「常に」にします(既定は「404 のときだけ」)。
前方一致・正規表現のルールが先にあると、そちらに先に一致します。優先順位を確かめます。
ログアウトした状態(ブラウザのシークレットウィンドウなど)で
/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 のキー |
|---|---|---|---|---|
ステータス | 「有効」のチェック | 有効(チェックあり) | 有効のルールだけを照合します。チェックを外すと無効で保存され、照合しません(ルールは残ります) |
|
転送元(マッチ方式) | 完全一致 / 前方一致 / 正規表現 | 完全一致 | 照合のしかたです。違いは リダイレクトの照合の規則 を参照 |
|
転送元(パス) | 文字列(512 文字まで) | 空 | 完全一致・前方一致は |
|
ステータスコード | 301 恒久的な移動 / 302 一時的な移動 / 307 一時的な移動(メソッドを保つ) / 308 恒久的な移動(メソッドを保つ) / 410 削除済み(転送しない) / 451 法的な理由で公開できない(転送しない) | 301 | 410 / 451 を選ぶと「転送先」の欄は使いません |
|
転送先 | 文字列(1024 文字まで) | 空 |
|
|
発火タイミング | 404 のときだけ(ページが存在しないときだけ転送する) / 常に(ページが存在していても転送する) | 404 のときだけ | 照合するタイミングです。リダイレクトの照合の規則 の「発火タイミングと照合の順番」を参照 |
|
クエリ文字列 | 転送先へ引き継ぐ / 引き継がない / クエリも照合する(完全一致のみ) | 転送先へ引き継ぐ | 「クエリも照合する」は完全一致のときだけ選べます。転送元に |
|
グローバル | 「下の階層のブログにも適用する」のチェック | チェックあり(使えないブログではなし) | チェックすると、下の階層のすべてのブログでも照合します。下の階層に別のドメインのブログがあるブログでは選べません |
|
メモ | 文字列(255 文字まで) | 空 | 管理用のメモです |
|
REST API で作成するときの既定値は、画面と一つだけ違います
REST API で scope を省くと local(このブログだけ)で作成します。画面の既定はグローバルです。
保存できないもの
保存するときに次の検査をし、当てはまる項目の下にメッセージを出します。
画面のメッセージ | 原因と直し方 |
|---|---|
転送元を入力してください。 | 転送元が空です |
転送元は「/」で始まるパスで入力してください。前方一致でサイト全体(「/」)は指定できません。 | 完全一致・前方一致で |
正規表現の書き方に誤りがあります。 | 正規表現として解釈できません。括弧の数や、エスケープの漏れを確かめます |
転送元に「?」を含められるのは、完全一致で「クエリも照合する」を選んだときだけです。 | 転送元に |
同じ転送元・同じ発火タイミングのリダイレクトがすでにあります。 | このブログの有効なルールに、同じマッチ方式・同じ転送元・同じ発火タイミングのものがあります。片方を無効にするか、削除します |
転送元が長すぎます。日本語や記号はエンコードすると長くなるため、エンコードした後で512文字以内になるよう短くしてください。 | 日本語の多いパスは、エンコードした後の長さで数えます |
転送先を入力してください。 | 301 / 302 / 307 / 308 で転送先が空です |
転送先は「/」で始まるパスか、http / https で始まる URL で入力してください。 |
|
転送先のドメインの部分には「$1」などの後方参照を使えません。パス・クエリの部分で使ってください。 |
|
転送先が転送元に戻るため、転送が繰り返されます。 | 転送先が自分の転送元に一致する、またはほかのルールをたどって転送元に戻ります。転送先を見直します |
下の階層に別のドメインのブログがあるため、下の階層のブログには適用できません。 | 「グローバル」を外します |
優先順位
一覧には、このブログのルールと、上の階層のブログで「グローバル」にしたルールが、照合する順に並びます。優先順位は一覧の並びで決まり、行をドラッグして並べ替えます。
並べ替えられるのは、このブログのルールだけです。
下の階層のブログのルールは、上の階層のブログのルールより先に照合されます。そのため、上の階層のルールより後ろへは移動できません。
有効にするとき、同じ転送元のルールがすでに有効な場合や、転送が繰り返される場合は、そのルールは無効のまま残り、エラーで知らせます。
削除したルールは戻せません。一時的に止めるだけなら、無効にします。
ステータスコードの使い分け
コード | 画面の表示 | 使う場面 |
|---|---|---|
301 | 恒久的な移動 | URL を恒久的に変えたとき。サイトのリニューアルやドメインの移転など、多くの場合はこれを選びます |
302 | 一時的な移動 | キャンペーン期間だけ別のページへ案内するなど、元の URL に戻す予定があるとき |
307 | 一時的な移動(メソッドを保つ) | 302 と同じ用途で、リクエストのメソッドを変えずに転送したいとき |
308 | 恒久的な移動(メソッドを保つ) | 301 と同じ用途で、リクエストのメソッドを変えずに転送したいとき |
410 | 削除済み(転送しない) | ページを削除し、代わりのページが無いとき。404 より明確に「削除した」ことを伝えます |
451 | 法的な理由で公開できない(転送しない) | 裁判所の命令や権利者の申し立てなど、法的な理由で公開をやめたとき |
転送するのは GET / HEAD のアクセスだけです。フォームの送信(POST など)は、307 / 308 を選んでも転送しません。410 / 451 のときに表示するページは、410 / 451 のページをテーマで作る を参照してください。
よくある質問・つまずき
転送されない
次の順に確かめてください。
ルールが有効か。 一覧の「ステータス」が「有効」になっているかを見ます。
ログインしていないか。 ログインしていると、非公開のエントリーなどが表示されるため、「404 のときだけ」のルールが動かないことがあります。ログアウトするか、シークレットウィンドウで確かめます。
旧 URL のページが残っていないか。 「404 のときだけ」は、ページが表示できるときは転送しません。旧ページを残したまま転送するなら「常に」にします。
先に別のルールに一致していないか。 照合は優先順位の順で、最初に一致したルールを使います。上にある前方一致・正規表現のルールに先に一致していないかを見ます。
パスの書き方。 大文字と小文字は区別します(
/Old/と/old/は別)。サイトのルートからのパスで書きます。子ブログの URL ではないか。
/news/old/のように子ブログのコードで始まる URL は、子ブログのアクセスとして照合します。ルートブログのルールを効かせるには「グローバル」にするか、子ブログにルールを登録します。実在するファイルではないか。 同梱の
.htaccessは、実在するファイル(/old/page.htmlというファイルが残っている、など)へのアクセスを a-blog cms に渡しません。ファイルを削除してください。照合しない URL ではないか。 管理画面・API・テンプレートを指定したアクセス・ログイン画面などは照合しません(リダイレクトの照合の規則 の「照合しない URL」)。
転送が 2 回起きる
同梱の .htaccess は、拡張子の無いパスの末尾に / を付けて 301 で転送します。/old/page へのアクセスは、まず /old/page/ へ転送され、そのあとでルールに一致します。照合では末尾の / の有無を区別しないため、ルールは 1 つで足ります。
一時的に別のページへ案内したい
キャンペーン期間だけ案内するときは、ステータスコードを「302 一時的な移動」、発火タイミングを「常に」にします。期間が終わったら、ルールのステータスを無効にするか削除します。
「グローバル」を選べない
下の階層に、別のドメインのブログがあるブログでは選べません(「下の階層に別のドメインのブログがあるため、このブログでは使えません。」)。パスだけで照合するため、別のドメインのブログで意図せず一致するのを防ぐためです。子ブログそれぞれにルールを登録してください。
ブログを削除したら、ルールはどうなるか
ブログを削除すると、そのブログのリダイレクトのルールも削除されます。
