日本語スラッグを英語に替えたあとの転送:前の URL を 404 のときだけ 1 回の 301 で新しい URL へ

その他
広告WordPress・PHP を学べる本

Amazonのアソシエイトとして、WordPress functions.phpは適格販売により収入を得ています。

日本語のスラッグを英語に替えました。たとえば /blog/シガーソケットのプラス端子/ のような URL を /blog/cigar-socket-plus-terminal-head/ に替えると、検索結果やほかのサイトのリンクに残っている前の URL が 404 になってしまいます。そこで、「前のパス → 新しいパス」の表を持っておき、前の URL に来たアクセスを 1 回の 301 で新しい URL へ送るコードを用意しました。

WordPress の「古いスラッグからの転送」だけでは足りないことがある

WordPress には、スラッグを替えたときに前のスラッグを _wp_old_slug というカスタムフィールドに記録しておき、前の URL に来たアクセスを新しい URL へ送る仕組み(wp_old_slug_redirect())があります。編集画面でスラッグを 1 回替えるだけであれば、多くの場合はこれで足ります。

ところが、カスタム投稿の記事や、何度もスラッグを替えた記事では、思ったとおりに動かないことがあります。末尾の / を直す転送と古いスラッグの転送が続けて動いて 2 回の転送になったり、DB を直接書き換える作業やインポートのツールでスラッグを替えたために _wp_old_slug が記録されず、転送そのものが効かなかったりするためです。検索エンジンに前の URL の評価を引き継いでもらうには、1 回の 301 で新しい URL へ転送される形がいちばん確実なので、転送の表を自分で持つことにしました。

考え方:404 のときだけ、表にある URL だけを送る

このコードは、WordPress が「ページが見つからない」(404)と決めたときだけ動きます。前の URL を開いたときに記事が見つかるあいだは何もしないので、スラッグを替える前にコードを追加しておいても、サイトの動きは変わりません。スラッグを英語に替えた瞬間に前の URL が 404 になり、そこから転送が効き始めるので、切り替えのあいだに 404 のページが表示されることもありません。

時点 前の URL(日本語)を開くと / 新しい URL(英語)を開くと
コードを追加した直後(スラッグは日本語のまま) 前の URL(日本語)を開くと:記事が表示される(200)。コードは何もしない新しい URL(英語)を開くと:まだ記事がないので、サイトのふだんの 404 の動き
スラッグを英語に替えたあと 前の URL(日本語)を開くと:301 で新しい URL へ 1 回で転送新しい URL(英語)を開くと:記事が表示される(200)

また、表にない URL には何もしないため、本当に存在しないページはこれまでどおり 404 のままです。404 のページをトップページへ送るような処理がテーマやプラグインにあるサイトでも、このコードを早い優先度で動かしておけば、表にある URL だけを先に新しい URL へ送れます。

前の URL は 3 つの形で届く

同じ日本語の URL でも、ブラウザーやクローラー、リンクを貼ったサイトによって、届く形が違います。そのため、要求のパスをそのまま表と比べると、ある形では転送されてほかの形では 404 になる、ということが起きます。

形 例(「シガー」の部分) / よくある出どころ
大文字の % エンコード 例(「シガー」の部分):%E3%82%B7%E3%82%AC%E3%83%BCよくある出どころ:ブラウザー・多くのクローラー
小文字の % エンコード 例(「シガー」の部分):%e3%82%b7%e3%82%ac%e3%83%bcよくある出どころ:WordPress が DB に保存するスラッグの形・それをコピーしたリンク
そのままの日本語 例(「シガー」の部分):シガーよくある出どころ:手で貼ったリンク・一部のツール

そこで、要求のパスと表のパスの両方を rawurldecode() で元の文字に戻してから比べます。こうすると 3 つの形がすべて同じ文字列になるので、表には読みやすい日本語のまま書いておけます。Search Console などからコピーした %E3… の形を表にそのまま書いても、同じように比べられます。

コード

WordPress がドメインの直下にあるサイトを前提にしています。子テーマの functions.php に追加してください。表の書き方は「前のパス => 新しいパス」で、どちらもドメインのあとの / から書きます。

functions.php
<?php
/**
 * Plugin Name: 前のスラッグの URL を 301 で転送する
 */
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

/**
 * 転送の表(前のパス => 新しいパス)
 * WordPress がドメインの直下にある前提。%E3… の形で書いてもよい
 */
function my_old_slug_redirect_map() {
    return array(
        '/blog/シガーソケットのプラス端子/' => '/blog/cigar-socket-plus-terminal-head/',
    );
}

/**
 * 比べるためにパスの形をそろえる
 * %E3… / %e3… / そのままの日本語 を同じ文字列にし、前後の / をそろえる
 */
function my_normalize_redirect_path( $path ) {
    $path = rawurldecode( $path );
    return '/' . trim( $path, '/' );
}

function my_redirect_old_slug() {
    // ページが見つかったときは何もしない
    if ( ! is_404() ) {
        return;
    }

    $request = isset( $_SERVER['REQUEST_URI'] ) ? wp_unslash( $_SERVER['REQUEST_URI'] ) : '';
    $path    = wp_parse_url( $request, PHP_URL_PATH );
    $query   = wp_parse_url( $request, PHP_URL_QUERY );
    if ( ! is_string( $path ) || '' === $path ) {
        return;
    }

    $map = array();
    foreach ( my_old_slug_redirect_map() as $old => $new ) {
        $map[ my_normalize_redirect_path( $old ) ] = $new;
    }

    $key = my_normalize_redirect_path( $path );
    if ( ! isset( $map[ $key ] ) ) {
        return;
    }

    // クエリ(?utm_source=… など)はそのまま付ける
    $to = home_url( $map[ $key ] );
    if ( is_string( $query ) && '' !== $query ) {
        $to .= '?' . $query;
    }

    wp_safe_redirect( $to, 301 );
    exit;
}
add_action( 'template_redirect', 'my_redirect_old_slug', 1 );
書き方 役目
template_redirect どのページを表示するかが決まったあと、テンプレートを読む前に動くフック。ここなら is_404() の結果が分かる
優先度 1 WordPress の redirect_canonical() や wp_old_slug_redirect()(どちらも優先度 10)より先に動く。ほかの転送と重なって 2 回の転送になるのを防ぐ
is_404() ページが見つからないときだけ動かす。記事が見つかるあいだは何もしないので、先に追加しておいても安全
rawurldecode() %E3…・%e3… を元の文字に戻す。そのままの日本語は変わらないので、3 つの形が同じ文字列になる
trim( $path, '/' ) 末尾の / があってもなくても同じように比べる
wp_parse_url( …, PHP_URL_QUERY ) 広告やメールの計測用のクエリを、転送先にそのまま引き継ぐ
wp_safe_redirect( $to, 301 ) 同じサイトの中だけに転送する。表の書き間違いでよそのサイトへ送ってしまうことがない

表の行が増えても、比べるのは 404 のときだけです。そのため、ふだん表示されるページの速さには影響しません。

確認のしかた

curl で前の URL を 3 つの形で開く

スラッグを替えたら、まず前の URL を 3 つの形で開き、301 と Location(転送先)を確認します。-I はヘッダーだけを取るオプションで、転送はたどりません。なお、Windows のコマンドプロンプトでは、引数に書いた日本語が化けることがあります。そのときは、エンコードした 2 つの形で確認するか、Mac・Linux のターミナルから実行してください。

# 1. 大文字の % エンコード
curl -I "https://example.com/blog/%E3%82%B7%E3%82%AC%E3%83%BC%E3%82%BD%E3%82%B1%E3%83%83%E3%83%88%E3%81%AE%E3%83%97%E3%83%A9%E3%82%B9%E7%AB%AF%E5%AD%90/"

# 2. 小文字の % エンコード
curl -I "https://example.com/blog/%e3%82%b7%e3%82%ac%e3%83%bc%e3%82%bd%e3%82%b1%e3%83%83%e3%83%88%e3%81%ae%e3%83%97%e3%83%a9%e3%82%b9%e7%ab%af%e5%ad%90/"

# 3. そのままの日本語
curl -I "https://example.com/blog/シガーソケットのプラス端子/"

3 つとも、次のように 301 で新しい URL を指していれば成功です。

HTTP/1.1 301 Moved Permanently
X-Redirect-By: WordPress
Location: https://example.com/blog/cigar-socket-plus-terminal-head/

転送が 1 回か・転送先の新しい URL が 200 か

続いて、転送をたどったときの回数と、転送をたどって最後に表示された URL(転送先)の状態を確認します。-L で転送をたどり、-w で状態のコード・転送の回数・最後の URL を表示します。転送の回数が 1、状態のコードが 200 であれば、前の URL から 1 回の転送で、新しい URL が表示されています。

curl -sIL -o /dev/null -w "%{http_code} %{num_redirects} %{url_effective}\n" "https://example.com/blog/%E3%82%B7%E3%82%AC%E3%83%BC%E3%82%BD%E3%82%B1%E3%83%83%E3%83%88%E3%81%AE%E3%83%97%E3%83%A9%E3%82%B9%E7%AB%AF%E5%AD%90/?utm_source=test"
# 期待する表示:200 1 https://example.com/blog/cigar-socket-plus-terminal-head/?utm_source=test

関係のない URL が 404 のままか

表にない URL を開いて、これまでと同じ動きになるかも確認しておきます。存在しない英語の URL と日本語の URL を 1 つずつ開き、どちらも 404(または、そのサイトのふだんの 404 の動き)であれば、ほかのページに影響していないと分かります。

curl -I "https://example.com/blog/no-such-page/"
# 期待する表示:HTTP/1.1 404 Not Found

サイトマップ

最後に、サイトマップ(/sitemap.xml や SEO プラグインのサイトマップ)を開き、新しい URL が出ていて、前の URL が残っていないことを確認します。サイトマップを検索エンジンが読み直すと、新しい URL の登録が進みます。Search Console の「URL 検査」で新しい URL を調べ、インデックス登録をリクエストしておくと、切り替えが早く進みます。

作業環境で確認した結果

本番から複製した作業環境で、カスタム投稿の記事 1 本を使って確認しました。上のコードを検証用のオリジナルコードとして使い、表には「前の日本語のパス → 新しい英語のパス」を 1 行だけ書いています。スラッグは DB の値を直接書き換えて日本語から英語に替えたので、_wp_old_slug は記録されていません。つまり、WordPress の古いスラッグの転送が効かない状態で、このコードだけの動きを見ています。

何を どう / 結果
替える前の前の URL どう:スラッグが日本語のまま、コードを置いた状態で、小文字の % エンコードとそのままの日本語で開いた結果:どちらも 200。コードは何もしなかった
前の URL(大文字の % エンコード) どう:スラッグを英語に替えて、ヘッダーだけを取った結果:301。Location は新しい URL
前の URL(小文字の % エンコード) どう:同じ結果:301。Location は新しい URL
前の URL(そのままの日本語) どう:同じ結果:301。Location は新しい URL
末尾の / とクエリ付きの前の URL どう:/?utm_source=test&… を付けて開いた結果:301。転送先にクエリがそのまま付いた
新しい URL どう:ヘッダーだけを取った結果:200。Location が新しい URL そのもので、その URL が 200 なので、1 回の転送で新しい URL が表示される
関係のない URL(英語・日本語) どう:存在しない URL を開いた結果:サイトのふだんの動きのまま(下の補足)。テーマの処理を止めた状態では、どちらも 404
コードがないときの前の URL どう:このコードの処理だけを止めて開いた結果:前の URL は転送されなかった(サイトのふだんの 404 の動き)
サイトマップ どう:–結果:検証に使った投稿の種類がサイトマップの対象外だったため、試していません

今回検証したサイトでは、見つからないページをトップページへ 302 で送る処理がテーマにありました。そのため、関係のない URL はこれまでどおりトップページへの 302 になり、表にある前の URL だけが、テーマの処理より先に新しい URL へ 301 で送られることを確認しました。確認したあとは、スラッグを元の値に戻し、検証用のファイルを削除しています。

使うときの注意

表の新しいパスは、記事のパーマリンクと同じ形(末尾の / の有無も含めて)で書いてください。形が違うと、転送のあとに WordPress がもう 1 回、正しい形へ転送することがあり、2 回の転送になってしまいます。また、WordPress をサブディレクトリーに設置しているサイトでは、REQUEST_URI にサブディレクトリーの部分が含まれ、home_url() にも同じ部分が付くので、表の書き方を合わせて直す必要があります。

転送の表は、前の URL へのアクセスがなくなるまで残しておくのがおすすめです。Search Console で前の URL の表示やクリックがなくなったことを確認してから、行を削除してください。

まとめ

日本語のスラッグを英語に替えるときは、「前のパス → 新しいパス」の表を持ち、template_redirect の優先度 1 で、404 のときだけ 301 で送るコードを先に追加しておくと安心です。404 のときだけ動くので、スラッグを替える前に追加しても何も起きず、替えた瞬間から転送が効きます。さらに、要求のパスを rawurldecode() してから比べることで、%E3…・%e3…・そのままの日本語のどの形で届いても、1 回の 301 で新しい URL へ送れます。

参考

SiteBeacon(サイトビーコン)

サイトが止まったら、すぐに気づける。

ホームページを 5 分ごとにチェックして、止まったとき・エラーが出たとき・SSL やドメインの期限が近いときに、メールでお知らせします。2 サイトまでは、ずっと無料で使えます。

SiteBeacon を見る サイトを直す相談をする

監視で気づいたあとの直す作業も、同じ担当がお受けします。