ローカルで書いた記事を本番に入れたら、リンクと画像の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行のままです。
確認するときに見ているところ
- DB全体を
localhostで検索する - 出てきた行が、公開中の記事か、リビジョンかを分ける
- 説明として書いた文字は残す
- 置換の前にバックアップを取る
- 直したら、公開ページのHTMLも検索する
記事を本番に入れる流れがあるなら、最後に1回検索を入れておくといいと思います。
自分も一度決めたのに漏れてたので、毎回の手順に入れました。