今さら聞けない：WordPressの更新失敗「死の真っ白画面」との戦い

2017年1月13日

どれくらいの人がWordPressのコミュニティーで一般に「WordPress 死の真っ白画面」(WSOD, White Screen of Death)と言われる現象に遭遇しているでしょうか？

　今回、筆者がこの「WordPress 死の真っ白画面」との戦いの記録を残しておきたいと思います。

突然訪れる「WordPress 死の真っ白画面」

　WordPress Codex やフォーラムなどでは有名な「WordPress 死の真っ白画面」ですが、経験のない人であればなんのことだかさっぱりです。逆に経験のある人からすれば「死の」が指し示す言葉通り、絶望にとらわれるのは間違いありません。なぜなら、それは突然訪れますから。

今回、筆者がこの記事を書くきっかけになったのも突然の真っ白画面で１日を棒に振ったからです。

オープンソースであるWordPressは世界中の有志が日々改善に明け暮れており、非常に良くできているソフトウェアです。しかし、最新の技術を取り入れるが故、不具合もおきてしまうのが事実。不具合はあってもすぐに更新され、最新の環境が常に提供されるのがオープンソースの特徴です。

つまり、更新の頻度が高いのもWordPressの特徴ともいえるでしょう。

皮肉なことに、この更新のタイミングこそ「WordPress 死の真っ白画面」に遭遇するリスクがいちばん高いのです。

なぜ起こる？「WordPress 死の真っ白画面」

では、なぜこの更新のタイミングで「真っ白画面」になるリスクが高いのでしょうか？それを知るために、更新の際に何が行われているか簡単に知っておきましょう。

WordPressで更新が提供されるのは、

新技術の導入
前のバージョンで確認された不具合の修正
セキュリティの強化
プラグイン導入時の不具合や互換性の修正
テーマ導入時の不具合や互換性の修正

などなど、様々なことがわずか数秒のうちに行われます。

通常のソフトウェアであれば、プログラムだけを新しくすれば良いのですが、WordPressの場合には投稿した記事や画像データ、設定状況などがデータベースに格納されています。データベースはMySQLを使いWordPress本体とは別なところでデータを格納しておくのでWordPressでテーマを変えたり、WordPress自体を入れ替えたりしても、記事や設定が反映されるのはこのためです。

つまり、更新のタイミングはWoroPress本体（PHP）のほかにも、データベースとの連携や必要な情報の更新が同時に行われます。わかりやすく言えば、更新のタイミングはいちばん敏感な部分を書き換えるイメージです。

更新はボタン一つでわずか数秒のうちに行われますが、このわずか数秒の間でWordPressと端末との間やWordPressとサーバーの間、WordPressとデータベースの間、データベースとサーバーの間などで、何かしらの不具合（例えば、通信エラーなど）が起きてしまうと、たちまち「真っ白画面」の餌食になってしまいます。

通信エラーなど起こった場合、必要な情報が「歯抜け」になったり「順序が変わったり」して正確に動作できない環境が出来上がってしまいます。これがPHPエラーやデータベースエラーが発生の原因です。

こうして不運にも「WordPress 死の真っ白画面」と遭遇してしまうのです。

「WordPress 死の真っ白画面」の解決策は？

　WordPress Codexに解決方法がまとめられていますが、いちばんの近道は「手動アップグレード」です。まずはこの方法を試してみました。

参考：WordPress Codex日本語版「WordPress の一般的なエラー」

　FTPクライアントソフトでサーバーにアクセスし、ダウンロードしていたWordPressのプログラムを上書きする力技です。コミュニティーで提供されている手順は、必要なデータ以外を削除し、新しいデータをアップロードするものです。

削除する／してはいけないファイル一覧：

取り消し線が引かれたディレクトリ・ファイルは削除、それ以外は残します。必要なファイルを削除しないよう注意深く作業してください。

public_html/ （ドキュメントルートディレクトリ）

robots.txt — 残す

.htaccess 注1

index.php 注1

wordpress ディレクトリ

wp-admin/ — 削除注2

wp-content/

cache/ — 削除（2.0.x からアップグレードする場合にのみ存在）

languages/ — 削除

plugins/

widgets/ — 削除（Sidebar Widgets プラグイン用ディレクトリ）^[2]

themes/

default/ （本体同梱デフォルトテーマ）新バージョンに差し替え

classic/ （本体同梱クラシックテーマ）新バージョンに差し替え

uploads/ — アップロード画像

wp-images/ （1.5.x 以前から使っているときにのみ存在）

wp-includes/ — 直下の languages/ が不要であればまるごと削除

languages/ （言語ファイルの古い置き場所 ^[3]） — あえてここに置きたい場合はこれだけ残す。wp-content/languages/ に切り替えてよければ削除（次回のアップグレードから wp-includes/ ごと削除できるようになる）

.htaccess — 残す（パーマリンクのカスタムルールを追加してある場合に存在）

wp-config.php — 残す

index.php 以下全て削除（注1’）

license.txt

readme.html

wp-app.php

…

注意：

注1 訪問者のアクセスをルートにしたまま WordPress ファイルを専用ディレクトリにまとめている場合、ドキュメントルートディレクトリに .htaccess と index.php がある。.htaccess は削除せずに残し、index.php は新バージョンで複製元ファイル（注1’）に変更があれば作り直す。

注2 セーフモード対応で wp-admin/.htaccess を置いている場合、.htaccess のみ残し、wp-admin/ 下のその他のファイルは削除。

コンテンツ、カスタマイズしたプラグイン・テーマ — 画像等のメディアファイル、ならびに、その他カスタマイズしたコンテンツやプラグイン等が wp-content ディレクトリ内にある場合は削除しないこと。

コアファイルのカスタマイズは、新バージョンでも必要かどうかを確認の上、必要であれば新バージョンのファイルを元に作り直してください。

参考：WordPress Codex日本語版「WordPressのアップグレード/詳細」

　ほとんどの場合はこれで解決するようです。筆者も丁寧にファイルを削除してみたのですが結果はダメでした。

一体なぜ？？？

この時注意すべきは「.htaccess」の存在でした。このファイルFTPクライアントソフトによっては初期設定で表示されません。筆者はファイルを削除している際に、この「.htaccess」まで削除してしまったようです。WordPressのテーマを大幅に変更する際にバックアップを取っていた「.htaccess」が残っていたので、「.htaccess」を表示する設定に変更してFTPクライアントソフトを使ってアップロードしました。

あれこれ試してみて数日を要したのがウソのように、めでたくサイトは復活したのです。

今回「死の真っ白画面」解決の決め手は「手動アップグレード」でした。なんだかんだで、手間をかけたほうが確実に問題解決になりますね。若干の注意が必要ではありますが。

ちょっとまって！「.htaccess」ってなに？

サラッと流していましたが、問題解決のキーになった「.htaccess」とは一体何でしょうか？

現在Webサーバーの定番ソフトとなっているApache（アパッチ）を制御するための設定が書き込まれたファイルです。

通常、Apacheの制御は「httpd.conf」という設定ファイルに記載されています。しかし「httpd.conf」はWebサーバー全体の制御を行っているため、サーバー管理者しか変更することができません。一方の「.htaccess」は、各ディレクトリごとに設定することができるので、レンタルサーバーなどで自分専用にWebサーバーの設定を変えたい場合にできるのは「httpd.confファイルの変更」ではなく「.htaccessファイル」を格納することです。

WordPressでは記事などを整理するパーマリンクの生成などで「.htaccess」が必要になります。サイトのテーマを反映させたり、記事をメニューごとに表示させたりするための設定が「.htaccess」に記載されているわけです。