日本語のスラッグを英語に替えました。たとえば /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 に追加してください。表の書き方は「前のパス => 新しいパス」で、どちらもドメインのあとの / から書きます。
<?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 へ送れます。

