よくある移行のパターンと登録例
この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です
このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。
よくある移行の場面ごとに、ルールの登録例をまとめます。画面の操作は リダイレクト管理、照合の細かい規則は リダイレクトの照合の規則 を参照してください。
表の見方
各例の表の列(マッチ方式・転送元・転送先・コード・発火)は、作成・編集の画面の同名の項目に対応します。書いていない項目は、新規作成時の値(クエリ文字列「転送先へ引き継ぐ」など)のままです。例のドメインは example.com(今のサイト)、www.new-example.jp(移転先)です。
サイトリニューアルで URL の構成が変わった
ページごとに新しい URL を決めた
旧ページと新ページが 1 対 1 で対応するときは、完全一致で 1 件ずつ登録します。旧ページは削除済みのため、発火は「404 のときだけ」で足ります。
マッチ方式 | 転送元 | 転送先 | コード | 発火 |
|---|---|---|---|---|
完全一致 |
|
| 301 | 404 のときだけ |
完全一致 |
|
| 301 | 404 のときだけ |
完全一致 |
|
| 301 | 404 のときだけ |
/recruit/index.htmlへのアクセスは、同梱の.htaccessが先に/recruit/へ転送します。転送元は/recruit/と書いても同じ結果です。旧 URL のファイル(
about/company.htmlなど)がサーバーに残っていると、a-blog cms に届かず転送されません。ファイルを削除してください。
ディレクトリごと名前を変えた
/news/ 以下を /topics/ 以下へ、後ろのパスを残して移すときは正規表現を使います。前方一致は、転送先に後ろのパスを付けません。
マッチ方式 | 転送元 | 転送先 | コード | 発火 |
|---|---|---|---|---|
正規表現 |
|
| 301 | 404 のときだけ |
アクセスした URL | 転送先 |
|---|---|
|
|
|
|
| 一致しない |
照合するパスは末尾の / を除いたもの(/news、/news/2024/04)です。(/.*)? で「/news だけ」と「/news/ 以下」の両方に一致させています。
拡張子 .html の URL をやめた
マッチ方式 | 転送元 | 転送先 | コード | 発火 |
|---|---|---|---|---|
正規表現 |
|
| 301 | 404 のときだけ |
/about/company.html は /about/company/ へ転送します。エントリーの URL に .html を使っているサイトでは、表示できるエントリーには一致させたくないため、必ず「404 のときだけ」にします。
カテゴリーのコードを変えた
カテゴリーのコードを news から topics に変えた例です。カテゴリーの一覧(/news/、/news/page/2/)と、エントリー(/news/entry-123.html)の URL が変わります。古いコードの URL はページが無くなるので、発火は「404 のときだけ」にします。
優先順位 | マッチ方式 | 転送元 | 転送先 | コード | 発火 |
|---|---|---|---|---|---|
1 | 完全一致 |
|
| 301 | 404 のときだけ |
2 | 正規表現 |
|
| 301 | 404 のときだけ |
3 | 正規表現 |
|
| 301 | 404 のときだけ |
2 はエントリー(
.htmlで終わる URL)を、末尾に/を付けずに転送します。3 は一覧のページ送りなどを、末尾に/を付けて転送します。2 を 3 より上に並べます(3 は.htmlの URL にも一致するため)。カテゴリーが子ブログにある場合(
/blog/news/など)は、照合するパスもブログのコードから書きます(^/blog/news/(.+)$)。ルールは子ブログに登録するか、ルートブログに「グローバル」で登録します。
カテゴリーの階層を変えた(/service/web/ を /web/ に上げた、など)ときも、同じように書けます。
マッチ方式 | 転送元 | 転送先 | コード | 発火 |
|---|---|---|---|---|
正規表現 |
|
| 301 | 404 のときだけ |
ドメインを移した
リダイレクトのルールはパスだけで照合し、ドメインを見ません。そのため、移転の方法で登録のしかたが変わります。
旧ドメインの a-blog cms を残して、新しいサイトへ転送する
旧ドメインで旧サイト(a-blog cms)を動かしたまま、すべてのアクセスを新しいドメインへ送る例です。旧サイトのルートブログに登録します。
マッチ方式 | 転送元 | 転送先 | コード | 発火 | グローバル |
|---|---|---|---|---|---|
正規表現 |
|
| 301 | 常に | チェックあり |
旧ページが残っていても転送するため、発火は「常に」にします。
/about/はhttps://www.new-example.jp/aboutへ転送します(照合するパスに末尾の/が無いため)。移転先のサイトが末尾に/を付けて転送する設定なら、そのまま届きます。後方参照(
$1)は、ドメインの後ろの/より後ろにだけ書けます。クエリ文字列は「転送先へ引き継ぐ」(既定)のままにすると、
?utm_source=…などを移転先へ渡します。下の階層に別のドメインのブログがあると「グローバル」を選べません。その場合は、ブログごとに登録します。
旧ドメインと新ドメインが同じ a-blog cms に届く
エイリアスやブログのドメインの設定で、旧ドメインと新ドメインのどちらでも同じサイトが表示される場合、上のルールは新ドメインへのアクセスにも一致し、転送が繰り返されます。この場合はリダイレクト管理ではなく、Web サーバーの設定で、ドメインを見て転送してください。プラグイン・extension/acms の Hook でドメインを見て転送する例は、REST API と Hook でリダイレクトを扱う にあります。
ブログのドメインを変えたあとに旧ドメインへ来たアクセスが、どのブログにも当たらない場合(「404 Not Found Blog」と表示される場合)も、a-blog cms のルールでは扱えません。Web サーバーの設定で転送してください。
ページを削除した・公開をやめた(410 / 451)
代わりのページが無い削除には 410、法的な理由で公開をやめたページには 451 を使います。転送はせず、そのステータスのページを表示します。ページの作り方は 410 / 451 のページをテーマで作る を参照してください。
場面 | マッチ方式 | 転送元 | コード | 発火 |
|---|---|---|---|---|
削除したエントリー 1 件 | 完全一致 |
| 410 | 404 のときだけ |
終わったキャンペーンのディレクトリを丸ごと | 前方一致 |
| 410 | 404 のときだけ |
削除の申し立てを受けたページ | 完全一致 |
| 451 | 常に |
410 / 451 のときは「転送先」を入力しません。
ページをまだ表示できる状態で 410 / 451 にしたいときは、発火を「常に」にします。
閲覧が許されていないアクセス(非公開のブログ、閲覧権限の無いエントリーなど)では、「常に」でも 410 / 451 にしません。訪問者には、もともとの応答(404 など)が返ります。
クエリ文字列でページを区別していた旧 URL
旧サイトが /item?id=5 や /?p=123 のように、クエリ文字列でページを区別していた場合の例です。マッチ方式「完全一致」、クエリ文字列「クエリも照合する(完全一致のみ)」にして、転送元に ? から後ろも書きます。
マッチ方式 | 転送元 | 転送先 | コード | 発火 | クエリ文字列 |
|---|---|---|---|---|---|
完全一致 |
|
| 301 | 常に | クエリも照合する(完全一致のみ) |
完全一致 |
|
| 301 | 常に | クエリも照合する(完全一致のみ) |
完全一致 |
|
| 301 | 常に | クエリも照合する(完全一致のみ) |
/?p=123のパス/はトップページとして表示できるため、「404 のときだけ」では転送されません。発火は「常に」にします。/itemも同じく、一覧などのページとして表示できる場合があるため「常に」が確実です。キーの並び順は問いません(
?a=1&b=2と?b=2&a=1は同じ)。ただし、アクセスに余分なキーがあると一致しません(/item?id=5&utm_source=mailは一致しない)。/index.php?p=123は、a-blog cms が先に/?p=123へ転送します。転送元は/?p=123と書きます。/item?id=5へのアクセスは、同梱の.htaccessが先に/item/?id=5へ転送し、そのあとでこのルールに一致します。
正規表現の例
正規表現は区切り文字を付けずに書きます。照合する文字列は、先頭に / が付き、末尾の / を除いたパスです(/news/2024/ なら /news/2024)。次の例は、照合の処理と同じ規則で、表のとおりに転送先を組み立てることを確かめています。
目的 | 転送元(正規表現) | 転送先 | アクセスした URL → 転送先 |
|---|---|---|---|
ディレクトリ名の変更(後ろを残す) |
|
|
|
拡張子 .html をやめる |
|
|
|
日付の階層を 1 つの名前にまとめる |
|
|
|
言語ごとのディレクトリをまとめて変える |
|
|
|
大文字・小文字を区別しない |
|
|
|
日本語のディレクトリ名 |
|
|
|
サイト全体を別のドメインへ |
|
|
|
量指定子
{4}や{2,3}は、そのまま書けます。日本語のパスは、日本語のまま書けます(アクセスのパスはデコードしてから照合します)。
$1に差し込む値は、URL として正しくエンコードし直します。/は区切りとして残します。一致しなかったグループ(
(/.*)?が空のとき)の$1は空になります。後方参照を使う転送先は、保存のときにループを判定できないため、転送のときに確かめます。転送先が同じルールにもう一度一致する場合は、そのルールでは転送しません。
正規表現のルールを多く登録すると、照合が重くなります
前方一致・正規表現のルールは、アクセスのたびに順に照合します。数百件になる場合は、完全一致で書けないか、1 つの正規表現にまとめられないかを検討してください。
よくある質問・つまずき
前方一致で転送したら、後ろのパスが消えた
前方一致は、転送先を入力したとおりに使います。後ろのパスを残すときは、正規表現と $1 を使います(「ディレクトリごと名前を変えた」)。
正規表現のルールより、完全一致のルールを優先したい
照合は「優先順位」の順で、マッチ方式による優先はありません。例外にしたい完全一致のルールを、正規表現・前方一致のルールより上へドラッグします。
どの URL が一致するか、登録前に試したい
REST API の ?dry_run=1 を使うと、保存せずに検査(重複・ループ・書き方)だけを行えます。照合の結果そのものは、ルールを無効にして登録しておき、検証環境で有効にして curl -I で確かめるのが確実です。