先日、ある企業サイトの WordPress・PHP のアップデートと、SSL 対応(HTTPS 化)をまとめて担当しました。作業前は WordPress 4.9、PHP 7.4 で、URL はまだ http:// のまま。ブラウザのアドレス欄には「保護されていない通信」と表示されている状態でした。
PHP のバージョンアップやテーマの事前解析の進め方は「WordPress 4.9・PHP 7.4のサイトをPHP 8.3へ」に書いたので、今回は SSL 化と URL の統一を中心にまとめます。証明書を入れるところより、そのあとの「URL の置き換え」で見つかったことのほうが多い案件でした。
今回の作業の概要
| 項目 | 作業前 | 作業後 |
|---|---|---|
| WordPress | 4.9 系 | 7 系の最新版(作業時点) |
| PHP | 7.4 | 8.3 |
| URL | http://(www あり・なしが混在) | https://(www なしに統一) |
| SSL 証明書 | なし | Let's Encrypt(自動更新) |
| サーバー | Plesk で管理するレンタルサーバー | |
| フォーム | テーマ内の PHP で作られたお問い合わせ・採用エントリーの2本 | |
Plesk(プレスク)は、サーバーの設定をブラウザの画面から操作するための管理ソフト(コントロールパネル)です。特定のサーバー会社のものではなく、いくつものレンタルサーバーや VPS で採用されています。Xserver やさくらのレンタルサーバにある独自の管理画面と同じ役割で、今回は PHP のバージョン切り替え、SSL 証明書の発行、リダイレクトの設定、WordPress の更新(WP Toolkit という Plesk の機能)まで、ほとんどの作業をこの画面から行いました。
作業はサイト全体に Basic 認証をかけて閉じた状態で、本番環境で直接行いました。進めた順番は次のとおりです。
- バックアップ(ファイル一式と、phpMyAdmin で DB)
- 全プラグインを停止して、WordPress 本体を最新版へ
- プラグインを1つずつ更新して有効化
- PHP を 8.3 に切り替え、修正済みのテーマファイルを上書き
- SSL 証明書を入れて、サイトの URL を https に変更
- DB 内の URL を置き換え、http で読み込んでいるものを修正
- 301 リダイレクトで https・www なしに統一
- 表示・フォーム送信・管理画面を確認して、Basic 認証を外す
WordPress は 4.9 から一気に最新版へ
前回の案件では FTP で 6 系の最終版を経由しましたが、今回は Plesk の WordPress 管理画面(WP Toolkit)に「最新版に更新」のリンクが出ていたので、そこから 段階を踏まずに一気に上げました。WordPress は古い版から上げるとき、間の版で必要だったデータベースの変更を順番に自動で行ってくれるので、本体だけを上げるなら段階を踏む利点はあまりありません。
そのかわり、プラグインは更新前に すべて停止しておきます。4.9 の頃に入れたプラグインが新しい本体の上でエラーを起こすと、管理画面にも入れなくなるおそれがあるからです。更新後は1つずつ有効に戻し、そのたびにトップページを開いて確かめました。
なお、更新の前に wp-content/upgrade/ に置いていた .htaccess は、更新後に消えていました。WordPress が更新のたびにこのフォルダを空にするためで、異常ではありません。
SSL 証明書の導入と URL の変更
Plesk では「SSL/TLS 証明書」の画面から Let's Encrypt の証明書を発行できます。www あり・なしの両方を対象にしておくと、どちらでアクセスされても証明書のエラーが出ません。事前に、両方のドメインの DNS がこのサーバーを向いていることを確かめておきます(向いていないと証明書が取れません)。
証明書が入ったら、WordPress の「設定 → 一般」で「WordPress アドレス」と「サイトアドレス」を https:// に変えます。今回は事前の確認で、サイトの URL がすでに www なしで登録されていることが分かったので、そちらに揃えることにしました。
DB 内の URL 置換は「0件」に注意
記事の本文や設定には、画像やリンクの URL が http:// 付きで保存されています。これを一括で置き換えるのに、プラグインの Better Search Replace を使いました(終わったら停止・削除します)。WP-CLI が使えるなら、wp search-replace でも同じことができます。
置き換えは、次のパターンをそれぞれ ドライランで件数を確かめてから実行しました(example.com は実際のドメインに読み替えてください)。
| 検索 | 置換 | 目的 |
|---|---|---|
| http://example.com | https://example.com | メインの置き換え |
| http://www.example.com | https://example.com | www ありの古い URL |
| https://www.example.com | https://example.com | 念のため |
| (制作時の仮ドメイン) | —(件数を見るだけ) | 制作時の URL が残っていないか |
ここで1つ引っかかりました。最初のドライランは、4つとも0件だったのです。画像の入った記事がある以上、0件はまずありえません。原因は、テーブルを1つも選んでいなかったことでした。Better Search Replace はテーブルを選ばずに実行しても、エラーにならず「0件」と表示します。一覧の中をクリックして全選択し直したところ、メインの置き換えと www ありの置き換えで、それぞれ百数十件が見つかりました。
なお、「GUID を置換」にはチェックを入れません。GUID は投稿を識別するための値で、URL が変わっても書き換えないのが WordPress の決まりです。
制作時の仮ドメインが残っていた
4つ目の「制作時の仮ドメイン」の検索では、1件だけ見つかりました。場所は wp_options の中のテーマの設定(theme_mods_テーマ名)で、制作中に選んだヘッダー画像の URL が残っていたものです。表示には使われていませんでしたが、wp_options だけを選んで本サイトの URL に置き換えました。
もう1つ、DB の置換とは別に見つかったのが、リダイレクトのプラグイン(Redirection)の設定です。サイトリニューアル前の旧ページ(〜.html)から新ページへの転送ルールが3件あったのですが、転送先がすべて制作用のデモサイトになっていました。旧 URL からアクセスした人は、ずっとデモサイトに飛ばされていたことになります。本サイトのページに直して、完了報告で依頼元にもお伝えしました。
制作会社がデモ環境で作ってから本番に移したサイトでは、こうした仮ドメインが思わぬところに残っていることがあります。SSL 化の置換のついでに、制作時のドメインでも検索しておくと見つけやすいです。
テーマに直書きされた http を直す
DB を置き換えても、テーマのファイルに直接書かれた http:// は残ります。今回は header.php で jQuery を http:// で読み込んでいました。HTTPS のページから http のスクリプトを読み込むと、ブラウザが「混在コンテンツ」としてブロックするため、スライドショーなど jQuery を使う部分が動かなくなります。
これは事前のテーマ解析で見つけていたので、PHP 8 対応の修正(フォームの2ファイル)と一緒に、https:// に直したファイルを用意しておきました。作業後の確認は次の2つで十分です。
- 主要ページを開き、アドレス欄に「保護されていない通信」などの警告が出ないこと
- 開発者ツールの Console に「Mixed Content」の行が出ていないこと
301 リダイレクトで https・www なしに統一
最後に、古い URL へのアクセスを新しい URL に転送します。Plesk では次の2か所の設定で済み、.htaccess を書く必要はありませんでした。
- 「SSL/TLS 証明書」の画面で、http から https へのリダイレクトをオンにする(HSTS はひとまずオフ)
- 「ホスティング設定」の「優先ドメイン」を www なしにする
設定後、http://www.〜、http://〜、https://www.〜 の3つが、どれも https://〜(www なし)に転送されることを確かめました。
作業後に気づいた SEO まわりのこと
SEO プラグイン(All in One SEO)を古い版から最新版に上げたところ、下層ページの設定は引き継がれていましたが、トップページのタイトルと説明文だけが初期値に戻り、「Just another WordPress site」が出ていました。WordPress の初期のキャッチフレーズです。キャッチフレーズを消し、プラグインの「検索の外観」でトップページの説明文を入れ直しました。
あわせて、ヘッダーのテンプレートに説明文が直書きされていて、全ページで説明文が2つ出ていることも分かりました。これは作業範囲外なので、その場では直さず、修正版を用意して提案する形にしました。また、SNS でシェアされたときの OGP 画像が設定されていなかったので、こちらも作って配置しています。
また、このサイトはもともと Google Search Console に登録されていませんでした。そこで、代わりにこちらのアカウントで「ドメイン」プロパティとして登録しました。ドメインプロパティは DNS に TXT レコードを追加して所有権を確認する方式で、http・https、www あり・なしをまとめて1つのプロパティで見られます。今回のように URL を統一したサイトでも、転送の前後をまとめて追いかけられるので便利です。
登録したプロパティは、Search Console の共有設定(「設定」→「ユーザーと権限」)でお客さまのアカウントを追加して、後日共有する予定です。制作側で登録して共有で渡す形にしておくと、お客さまが Search Console の登録作業に慣れていなくても、すぐにデータを見始められます。
まとめ
- WordPress 本体は、プラグインを全部止めておけば古い版から一気に最新版へ上げられる
- SSL 証明書は www あり・なしの両方を対象にし、DNS の向き先を先に確かめておく
- Better Search Replace でドライランが0件なら、まずテーブルが選ばれているかを疑う
- 制作時の仮ドメインでも検索すると、テーマ設定やリダイレクト先に残った URL が見つかることがある
- テーマに直書きされた http の読み込みは混在コンテンツになるので、事前に洗い出して直しておく
- リダイレクトは Plesk の設定で https・www なしに統一し、3パターンの URL で転送を確かめる
- Search Console が未登録なら「ドメイン」プロパティで登録し、共有設定でお客さまに渡す
SSL 化は証明書を入れて終わりではなく、置換と確認のほうに時間がかかります。そのぶん、長く手を入れていなかったサイトの「見えていなかった不具合」に気づける機会にもなりました。同じような作業を控えている方の参考になればうれしいです。
