WordPress更新で画面が真っ白！エラー原因：全角・閉じ忘れ・競合…。解決法と復元方法

WordPressのfunctions.phpを編集後エラーを出すとブログや投稿画面が真っ白に！エラーメッセージで解析エラー:構文エラーが出たときの原因と、直すためにする解決方法など初心者がわかるよう説明します。

てっとり早いのが、バックアップからの復元で、エラー構文などはそれぞれだけど、functions.php・single.phpや.htaccessなどのエラーからの復元方法も同じです。

• single.phpでエラーが出たら、ブログのホーム画面は正常に表示されるけど、各投稿ページのみ真っ白かエラーコードが表示。
• .htaccessのエラーは、ブログも管理画面もサーバーのInternal Server Error：500エラー画面などが表示。

時短をお考えでしたら目次でジャンプしてくださいね。

functions.phpでエラーコードが出たときの状態

【 Parse error: syntax error, unexpected $end in・・・on line 276 】【解析エラー:構文エラー、予期しない$エンド ライン276】は、functions.phpの276行目くらいでエラーが出たと言うエラーコードです。

真っ白で上部にはエラーコードが出ています。

戻るボタンで戻ったら→いつものfunctions.phpの画面に戻ってちょっと安心してラッキーな気分になります。が！！

おかしくなった原因のコードをサクッっと削除後『ファイルを更新』しても、また下記▼画像。この画面真っ白になっちゃいます！

ついでに、公開中のブログも訪門したら、やっぱり・・同じエラー画面。。

エラーコードの表示・非表示設定があるサーバーもある

このエラーの表示・非表示がの設定ができるphp.iniがサーバーにはあります。エックスサーバーやロリポップなど。

エラーコードを表示すれば、functions.phpの276行目くらいでエラーが出た。とわかります。あなたのブログのドメインdomain.com以下がフォルダ・ファイルまでのパスです。

どこでエラーが出ているか不明なときエラーコードが表示する方法を参考にして、エラーの場所を特定してくださいね。

LINKエラーコードを非表示、表示切り替える設定方法！.htaccessの設定を優先させるphp.ini設定

焦る気持ちは分かりますが、エラーの直し方を、落ち着いて見ていきましょう＾＾

ワードプレスのfunctions.php編集ミス！真っ白エラーを直す

functions.phpを更新したら画面が真っ白になるのは、カスタマイズに間違いがあるからです。エラーからブログを復帰させる方法は大きく分けて2つ。

バックアップは、とってますか？一度もとった事がなければ、この方法は無理なので後述。

WordPressのPHP・CSS・JSファイルは、サーバーのFTPに保存されてるので、ダッシュボードからfunctions.phpを触れない今、FTPソフトでローカル側からサーバーにアップロードすれば復元します。

ファイルまでのパスは

• /domain.com（/public_html）/wp-content/themes/エラー起こしたテーマ/functions.php

FTPソフトの左側はあなたのPC、右側がサーバーのディレクトリ（ファイルまでの階層）。エラーが起きたfunctions.phpを開いてください。

FFFTPソフトでは、ドラッグorアップロード。FileZillaではアップロードを＾＾

PC側から→サーバー側に復元アップロードするだけで、エラーが出る前のファイルをサーバーに転送・上書きされ復元できます。

• 左側PCのバックアップファイルを選択
• functions.phpを右クリック
• アップロード、上書き

これでバックアップをとった時点のファイルに復元完了！

バックアップがない！functions.phpを編集して復元

バックアップを長い事（一度も）取ってないときは、サーバーFTPを開き編集した箇所を元に戻す方法です。

サーバーFTPへ直接入ってエラー出した時に間違えた記載をエラー前の状態に元に戻したり、書き替えたり出来ます。（サーバーのFTPに入る権限がないと入れません。）

• エックスサーバーなら、ファイルマネージャーからログイン
• ロリポップなら、ロリポップFTPからログイン

該当phpファイルを『完全に初期化する方法』・『エラー前の状態に戻す方法』は、下記を参考にどうぞ＾＾

LINKバックアップがないのに、画面が真っ白、500 Internal Server Error！WordPress復元の対処

PHPエラーの原因で考えられる事とは何！？

functions.phpの更新で、よくあるエラーをあげますね。

スペースが入ってしまった。

原因はスペースが入ってしまってた事に気付かず、エラーが出てしまった。

	EOF;

正しくは下記。入れてはいけない所に、スペース入ってませんか？

EOF;

テキストエディタを使ってると、空白が入る場合があるので注意が必要ですね。

閉じ忘れ、波括弧}

phpって、{　これは、ここからですよぉ

}　ココまでですよぉ！

って記載するんですよねっ。}閉じ忘れてませんか！？

～略～ else {　//ココからですよぉ
 get_template_part('ad-in-body');
　//ココ閉じ忘れ
$ad_template = ob_get_clean();

大括弧　}　これ、忘れたら構文が成り立ちません。。正しくは、下記。

～略～ else {　//ココからですよぉ
get_template_part('ad-in-body');
}　//これで成り立つ
$ad_template = ob_get_clean();


phpが「どこまでなのぉ～！？」と}を探しても存在しなので「ダメだぁ～、処理できない！」と、悲鳴をあげて真っ白になった。と思えばわかりやすいです。

• 正しくコードを書かないと、エラーを起こす

半角全角、コロン:とセミコロン;の間違い

全角文字を入れるとエラーを起こします。半角文字を入れてください。

• return null;←終わりのセミコロン;
• 半角;セミコロンが、全角；セミコロン
• ;セミコロンが、:コロン

半角全角は区別され、functions.phpなどで間違うと完全に飛びます。CSSもさいごに;セミコロンを打ってないと、正常に動いてくれませんよね。

正しいコードを書くことで『真っ白からブログが復活』しますが、PHPコードの扱いは慎重にしなければダメですねっ。

functions.phpのエラーで編集した場所がわかってる時

PHPエラーはなぜ起こったかザックリわかったところで、エラーを起こして復活するまでの流れを書いておきますねっ。

1. } else {　ここから
   return get_the_modified_time($format);
   ●←ココに}波括弧を入れ忘れてる。
2. 気付かずにファイルを更新
3. WordPress管理画面やブログが真っ白。
4. サーバーのFTPに向かう。（FFFTPでの復元は前述の通り）
   ドメイン/（public_html）/wp-content/themes/使ってるテーマ:Gush4-Child/functions.php

 

• 抜けてる半角}を閉じ忘れた箇所に入れて、保存
• 投稿画面に戻って、使ってたブラウザを更新すれば、何事もなかったかのように編集を続けられる。
• ブログも復活しますよっ♪

親テーマ、子テーマとの競合

以前パンくずリストを付けたくて親テーマと同じ関数だと気づかず、Gush4子テーマfunctions.phpに貼り付け、即エラーで真っ白になりました。

• 親テーマと同じ記載を書いたから

またプラグイン同士でエラーを起こし真っ白になる事もありますが、参考まで。

LINKプラグインが競合！ブログを簡単に表示させる為の３つ対処方法

関数自体の間違い

phpを適当に集めコードを組み合わせた結果、真っ白！phpのコードを間違ったら、正常に動かないので、エラーが出るので、WordPressの関数リファレンスを参考にしてください。

※よくわからない場合、カスタマイズした箇所を元に戻す。

PHPに限らず、.htaccessなども同じです。今後は触る前にバックアップとりましょうね❦

LINKWordPressバックアップ、FileZillaの使い方！ダウンロード・インストール・設定方法の手順

上記はMacも使えるFileZilla、下記はWindows専用FFFTPでのバックアップ方法です。

LINK初心者向け！WordPressのバックアップ方法、記事をエクスポートする手順

それから気になるのが、エラーコードの原文は何を書いてるか。

Parse error: syntax error, unexpected $end in ・・・エラーコードの意味とは？

Parse error: syntax error, unexpected $end in /home/users/数字/サーバーアカウント/web/ドメイン/wp-content/themes/テーマ名とバージョン/functions.php on line 276

更に日本語化されたエラー表示も同様。

解析エラー：構文エラー、予期しない$エンド
/home/users/数字/サーバーアカウント/web/ドメイン/（public_html）/wp-content/themes/使用中テーマ名/functions.php
オンライン276

文字/を見てもらったら わかるように、そこにはルート以下サブディレクトリが並んでます。下記は分かりやすくしたもの。

ドメイン/（public_html）/wp-content/themes/使用中テーマ名/functions.php

FTPを開いて、この通りのパスで下層へ向うと、迷わないです。

結局はPHPの構文エラーなので、半角スペースや、タグの閉め忘れ等などあるまま、ファイルを更新したから、エラーコードに書かれたパスの通りのファイルを修正してくださいね。

さいごに

WordPressなど自分がオーナーになってブログを運営するとき、サーバー内部でのエラーは、人の数だけエラーがあります。エラーの原因と解決方法、対処法を書いたページは下記。

LINKHTTP500内部サーバーエラー（Internal Server Error）の意味とは？

このページを見れば、だいたいのエラーの原因が書かれてます。

やっている事を理解してphpなどを触るとまだ安心！バックアップがあれば簡単に直せる！WordPressのバックアップは本体（FTP）ファイルとデータベースの2種類あれば全て復元できるので、チェックしてみてくださいね。

LINK簡易的バックアップ！初心者用WordPressファイル内説明と、5秒で復元する方法

困ったときはサーバーに問い合わせてみるもの手です。WordPress初心者であっても関係なくエラーが出るのでご注意を。

31記事目でエラーを出した、かうたっくでした♪