本文へスキップ
WordPress

WordPressのURLを一括置換する方法。本番の内部リンクがlocalhostのままだった

公開 約5分で読めます

TL;DRこの記事の要点

  • 本番の本文に残ったlocalhostのURLは、wp db searchで探してwp search-replaceで置換できる
  • 置換の前に--dry-runで件数を見て、該当する行の中身も確かめる
  • リビジョンや、説明として書いた文字も検索に混ざる
  • 直したあとも、公開ページのHTMLとDB全体をもう一度確かめる
目次8項目
  1. 何が起きたか
  2. なんで起きた?
  3. URLの探し方
  4. URLを一括置換する方法
  5. このときは記事本文だけを置換して直した
  6. 直したはずなのに、別の記事に残っていた
  7. 確認するときに見ているところ
  8. 出典

ローカルで書いた記事を本番に入れたら、リンクと画像のURLがlocalhost:8888のままでした。
しかも21記事です。
全部直したはずが、最近調べたら別の記事にまた残ってました・・・。

🎥 この記事の内容は動画でも解説しています。

先に結論です。

  • 探すのはwp db search、置換はwp search-replace(WP-CLI)が早い
  • 置換の前に--dry-runで件数を見る
  • 該当する行の中身も見る。リビジョンや、説明として書いた文字も混ざる
  • 直したあとも、公開ページとDB全体をもう一度確かめる

何が起きたか

このブログの記事は、ローカルのWordPressで作ってから本番に入れています。
Claude Codeに、見直した記事をまとめて本番へ反映してもらったときのことです。

記事のキャラクター画像が表示されないことに、自分が気づきました。
本文の中を見ると、こうなっていたんです。

<img src="http://localhost:8888/cats-hand/wp-content/themes/.../mascot-cat.png">

localhostは、ページを開いている人自身のパソコンを指します。
読者のパソコンにそのファイルはないので見えません。
でも、ローカルが動いている自分のパソコンでは表示されるので、気づきにくいんですよね。

本番のDB全体を検索してもらったら、その日に反映した21記事すべてで、リンクや画像のURLが1〜2か所ずつ残っていました。

なんで起きた?

このブログの本文には、リンクや画像のURLがhttp://localhost:8888/...のような絶対URLで入っていました。
本文の文字をそのまま本番へコピーすると、ローカルのURLもついてきます。

文章のチェックは通っていました。
でも、見ていたのは文章だけで、URLが正しいかは誰も確かめていなかったんです。

URLの探し方

WP-CLI(WordPressをコマンドで操作する道具)なら、DB全体を検索できます。

wp db search "localhost:8888" --all-tables

どのテーブルのどの行にあるかが出ます。

URLを一括置換する方法

ここは一般的な方法です。
一括置換には、wp search-replaceを使います。
まず--dry-runを付けて、変更せずに件数だけ見ます。

wp search-replace "http://localhost:8888/cats-hand/" "https://example.com/" --dry-run --skip-columns=guid --report-changed-only
  • --dry-run: 実際には変更しない
  • --skip-columns=guid: 投稿の識別子として使われるguidは変えない
  • --report-changed-only: 変更があるところだけ表示する

該当する箇所を見て、変えていいものだけなら、一般的な手順としてDBのバックアップを取ってから--dry-runを外します。

wp db export before-replace.sql
wp search-replace "http://localhost:8888/cats-hand/" "https://example.com/" --skip-columns=guid

設定値の中には、シリアライズという形式で保存されているものがあります。
文字数も一緒に記録されているので、SQLで単純に置換すると壊れることがあるんです。
wp search-replaceはこの形式にも対応しています。

WP-CLIを使わないなら、置換用のプラグインを使う方法もあります。
どの方法でも、先にバックアップを取るのは同じです。

このときは記事本文だけを置換して直した

21記事のときは、対象の記事だけを直しました。
Claude Codeに書いてもらったのは、本文の文字を置換するPHPのスクリプトです。
下は置換の部分だけの抜粋です。

$new = str_replace( 'http://localhost:8888/cats-hand/', 'https://cats-hand.pro/', $post->post_content, $count );
wp_update_post( wp_slash( array( 'ID' => $post->ID, 'post_content' => $new ) ) );

置換のあと、もう一度DB全体を検索して、0件になったのを確かめました。

直したはずなのに、別の記事に残っていた

ここで終わりじゃなかったんです。

この記事を書くために、本番で--dry-runをもう一度動かしてもらいました。
結果は、28件!

Table	Column	Replacements	Type
wp_posts	post_content	28	PHP
Success: 28 replacements to be made.

「反映したら0件を確かめる」と決めたのは、あの21記事のときです。
そのあとに公開した記事で、また残っていました。

ただ、28件が全部おかしいわけではなかったです。
該当する行を一覧にしたら28行で、分けるとこうでした。
(置換件数と行数が同じだったのは今回の結果で、いつも同じとは限らないと思います)

場所 行 どうしたか
公開中の記事の画像URL(6か所) 1 本番のURLに直した
公開中の記事の説明文(2か所) 1 ローカル環境の説明なので、そのまま
過去のリビジョン(編集の履歴) 26 公開ページに出ないので、そのまま

もしwp search-replaceをそのまま実行していたら、説明として書いた文字まで変わるところでした。
件数を見たら、中身も見る。
これ大事です!

直したのは画像のURL6か所だけです。
置換の件数が6件ちょうどのときだけ保存するスクリプトにしてもらって、公開ページのHTMLでlocalhost:8888が0件になったのと、画像6枚のURLを確かめました。
リビジョンなどが残っているので、DB上は27行のままです。

確認するときに見ているところ

  1. DB全体をlocalhostで検索する
  2. 出てきた行が、公開中の記事か、リビジョンかを分ける
  3. 説明として書いた文字は残す
  4. 置換の前にバックアップを取る
  5. 直したら、公開ページのHTMLも検索する

記事を本番に入れる流れがあるなら、最後に1回検索を入れておくといいと思います。
自分も一度決めたのに漏れてたので、毎回の手順に入れました。

出典

この記事が参考になったら、応援クリックをお願いします

Cat's Handこの記事を書いた人

Web制作歴10年以上。WordPressのテーマカスタマイズやコーディングを中心に、副業・本業ともにweb制作に携わっています。このブログでは、実際に手を動かして分かったことを書いています。