リダイレクトの照合の規則
この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です
このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。
リダイレクト管理 で登録したルールが、どの URL に、どの順番で一致するかを説明します。
照合するパス
照合するのは、サイトのルートからのパスです(ブログのディレクトリからの相対ではありません)。子ブログの URL も、ブログのコードを含めて書きます(
/news/old/など)。サブディレクトリに設置しているサイトでは、設置先のディレクトリを除いたパスで照合します。
末尾の
/の有無は区別しません。/old/page/と/old/pageは同じです。大文字と小文字は区別します。
パーセントエンコードの有無は区別しません。日本語のパスは、日本語のまま書けます。
ドメインは照合しません。エイリアスの別のドメインでアクセスした場合も、パスで照合します。
転送先にサイト内のパス(/ で始まるもの)を書いた場合も、サイトのルートからのパスとして扱います。サブディレクトリに設置しているサイトでは、転送するときに設置先のディレクトリが付きます。例えば /sub/ に設置したサイトで転送先を /new/ にすると、/sub/new/ へ転送します。
同梱の .htaccess との関係
拡張子の無いパスで末尾に
/が無いアクセスは、.htaccessが先に末尾に/を付けて 301 で転送します。ルールの照合はそのあとです。/index.htmlで終わるアクセスは、.htaccessが先に/で終わる URL へ転送します。実在するファイルへのアクセスは、a-blog cms に届きません。
マッチ方式
マッチ方式 | 一致するもの | 例 |
|---|---|---|
完全一致 | パスが同じもの |
|
前方一致 | 転送元のパスと、その下のパス。パスの区切りで判定します |
|
正規表現 | 正規表現に一致するもの |
|
前方一致
前方一致で一致した場合、転送先は入力した URL そのままです。転送元より後ろのパスは、転送先に付きません。/old/a/b/ を /new/a/b/ のように、後ろのパスを残して転送したいときは、正規表現を使います。前方一致でサイト全体(/)は指定できません。
正規表現
区切り文字(
/や#)は付けずに、中身だけを書きます。{2,3}のような量指定子も、そのまま書けます。UTF-8 として照合します(PHP の
u修飾子を付けて照合します)。(?i)などの修飾子をパターンの先頭に書けます。照合する文字列は、先頭に
/が付き、末尾の/を除いたパスです。$で終わりを固定するときは、末尾の/を書かないでください。トップページは/です。転送元は
/で始めなくても保存できますが、^/で始めると意図しない一致を避けられます。転送先では、
$1や${1}で一致した部分を使えます。差し込む値は、URL として正しくエンコードし直します。転送先のドメインの部分(
://から最初の/まで)には、$1などを使えません。書き方に誤りのある正規表現は保存できません。
例は よくある移行のパターンと登録例 の「正規表現の例」を参照してください。
クエリ文字列
設定 | 照合 | 転送先 |
|---|---|---|
転送先へ引き継ぐ(既定) | パスだけで照合します | アクセスしたクエリ文字列を付けます。転送先にすでに同じキーがあれば、転送先の値を残します |
引き継がない | パスだけで照合します | クエリ文字列を付けません |
クエリも照合する(完全一致のみ) | パスとクエリ文字列の両方で照合します。キーの並び順は問いません。アクセスに余分なキーがあれば一致しません | クエリ文字列を付けません |
例: 転送先 /new/?ref=doc(クエリ文字列「転送先へ引き継ぐ」)のルールに ?utm_source=x&ref=y でアクセスすると、Location: /new/?ref=doc&utm_source=x になります(転送先の ref を残し、utm_source を足す)。
「クエリも照合する」は、旧サイトが /item?id=5 のようにクエリ文字列でページを区別していた場合に使います。転送元に ? から後ろも書きます。転送元に ? を書けるのは、この設定のときだけです。広告や解析のためのパラメーター(utm_source など)を転送で落とさないため、既定は「転送先へ引き継ぐ」です。
発火タイミングと照合の順番
発火タイミング | 照合するとき |
|---|---|
404 のときだけ | ページを表示しようとして、URL に合うページが見つからなかったとき。ページがあれば転送しません |
常に | ページがあるかどうかを調べる前。ページがあっても転送します。ページキャッシュがあるページでも転送します |
1 回のアクセスでは、次の順に照合し、最初に一致したもので転送します。
「常に」のルール
通常のページの表示
ページが見つからなかった(404)ときは、「404 のときだけ」のルール
「常に」のルールは、ログインの有無・非公開のブログ・メンテナンスモードに関係なく転送します。
「404 のときだけ」は、閲覧を拒否したために 404 を返しているページ(閲覧権限の無いエントリーや、404 を返す設定の非公開ブログなど)では照合しません。拒否の結果を転送で上書きしないためです。迷ったときは、既存のページを隠す心配の無い「404 のときだけ」を選んでください。
照合の優先順位の具体例
同じ発火タイミングのルールどうしは、次の順に照合します。管理画面の一覧の「優先順位」の順と同じです。マッチ方式(完全一致かどうか)による優先はありません。
下の階層のブログのルールを、上の階層のブログのルールより先に照合します。親と子のブログに同じ転送元のルールがあれば、子のブログのルールが使われます。
同じブログのルールは、一覧で並べた順に照合します。
例 1: 前方一致と完全一致
優先順位 | マッチ方式 | 転送元 | 転送先 |
|---|---|---|---|
1 | 前方一致 |
|
|
2 | 完全一致 |
|
|
/service/web/ へのアクセスは、1 の前方一致に先に一致し、/solutions/ へ転送します。2 を使いたいときは、2 を 1 より上へ並べます。
例 2: 発火タイミングの違い
優先順位 | マッチ方式 | 転送元 | 転送先 | 発火 |
|---|---|---|---|---|
1 | 完全一致 |
|
| 404 のときだけ |
2 | 前方一致 |
| (保存できない) | — |
3 | 正規表現 |
|
| 常に |
/about/ へのアクセスでは、優先順位に関係なく先に「常に」の 3 を照合し、/corporate/ へ転送します。1 は、3 が無いか一致しないときに、ページが見つからなかった場合だけ使われます。(2 のように、前方一致で / は保存できません。)
例 3: 親と子のブログ
所属ブログ | グローバル | 転送元 | 転送先 |
|---|---|---|---|
ルートブログ | グローバル |
|
|
子ブログ(コード news) | — |
|
|
/news/special/ へのアクセスは子ブログのアクセスなので、子ブログのルールを先に照合し、/special-2026/ へ転送します。それ以外の /news/… は、ルートブログのグローバルのルールで /topics/… へ転送します。
下の階層のブログとの関係
「グローバル」(下の階層のブログにも適用する)にしたルールは、下の階層のすべてのブログでも照合します。サイト全体の移行用のルールは、ルートブログにグローバルで登録すると、子ブログにも効きます。
「グローバル」にしていないルールは、そのブログへのアクセスだけで照合します。子ブログのコードで始まる URL(
/news/…)は子ブログへのアクセスなので、ルートブログの「グローバル」にしていないルールには一致しません。子ブログにルールを追加しても、上の階層のグローバルのルールは引き続き効きます(足し合わせて照合します)。
下の階層に別のドメインのブログがあるブログでは、「グローバル」を選べません。パスだけで照合するため、別のドメインのブログで意図せず一致するのを防ぐためです。
「グローバル」を選べるかどうかは、保存するときにだけ確かめます
グローバルのルールを保存した後で、下の階層に別のドメインのブログを作ったり、ブログの親を付け替えたりした場合は、そのブログでもグローバルのルールが照合されます。ブログの構成を変えたときは、ルールを見直してください。
照合しない URL
次のアクセスは、ルールで照合しません。
GET / HEAD 以外のアクセス(フォームの送信など)
管理画面、API、メディアのダウンロード、テンプレートを指定したアクセス、共有プレビュー、ログイン画面などの認証のページ
コマンドラインからの実行(静的書き出しなど)
ブログを特定できない URL(どのブログのドメインにも当たらないアクセス)
.phpで終わる旧 URL(下記)
.php で終わる旧 URL
/index.php?…は、a-blog cms が先に/?…へ転送し、トップページを表示します。転送後の/?p=123などを、発火タイミング「常に」・クエリ文字列「クエリも照合する」のルールで受けてください(転送元は/?p=123)。index.php以外の.phpは、同梱の.htaccessがアクセスを禁止しているため、a-blog cms に届きません。Web サーバーの設定で転送してください。
よくある質問・つまずき
「404 のときだけ」のルールが、ページがあるのに動いてしまう
ログインしていない訪問者には表示できないページ(非公開・予約公開前など)は、訪問者から見ると「ページが見つからない」ことがあります。その URL は転送されることがあります。逆に、ログインしていると表示できるため転送されません。動作はログアウトした状態で確かめてください。
ページキャッシュを使っていても転送されるか
「常に」のルールは、ページキャッシュを返す前に照合するため、キャッシュ済みの旧 URL も転送します。「404 のときだけ」は、ページが見つからなかったときに照合します。
転送のループを防ぐには
保存のときに、転送先が転送元に戻る組み合わせ(ほかのルールをたどって戻る場合を含む)を「転送先が転送元に戻るため、転送が繰り返されます。」で止めます。正規表現で後方参照を使う転送先は保存のときに判定できないため、転送のときに、転送先が同じルールにもう一度一致する場合は転送しません。