2026年5月20日

2026年5月20日

functions.php編集後に白い画面になった場合の対処法

はじめに

functions.php はWordPressテーマの核となるファイルです。このファイルにPHPコードを追加・編集した際に文法エラー(syntax error)があると、サイト全体が白い画面になります。

管理画面の「テーマファイルエディター」で編集中にエラーが出た場合でも、焦らず以下の手順で復旧できます。

症状・原因

  • セミコロンの書き忘れ(; の欠落)
  • 括弧の対応ミス({ } ( ) の不一致)
  • 引用符の種類ミス(「"」「'」の混在)
  • 全角スペースや全角文字の混入
  • コードの貼り付け時に不要な文字が混入

解決手順

ステップ1:FTPで正しいfunctions.phpに戻す

最も確実な方法です。FTPで wp-content/themes/あなたのテーマ/functions.php を開き、編集前のバージョンに戻します。

バックアップがない場合は、ファイルをダウンロードしてテキストエディタ(VSCode等)で編集し、再アップロードします。

ステップ2:PHPの文法エラーを特定する

wp-config.php のデバッグを有効化してエラー内容を確認します。よくあるエラーメッセージ:

Parse error: syntax error, unexpected token "echo" in
/wp-content/themes/your-theme/functions.php on line 42

「on line 42」の部分が問題の行番号です。その行付近を確認してください。

ステップ3:よくあるPHP文法エラーの修正

セミコロン忘れ:

// エラー
$my_var = 'hello'

// 正しい
$my_var = 'hello';

括弧の対応ミス:

// エラー
function my_function() {
    echo 'hello';
// 正しい(閉じ括弧を追加)
function my_function() {
    echo 'hello';
}

全角スペースの混入:

テキストエディタで「表示」→「スペースの表示」を有効にして確認します。全角スペースは通常のスペースより幅が広く表示されます。

ステップ4:管理画面のテーマエディターから復旧(管理画面が開ける場合)

WordPress 4.9以降では、管理画面のテーマエディターで文法エラーがある場合は保存をブロックする機能があります。ただし古いバージョンや特定の状況では保存できてしまうことがあります。

外観テーマファイルエディターfunctions.php を選択して修正します。

ステップ5:コードスニペットプラグインを活用する

今後のトラブルを防ぐために、「Code Snippets」プラグインを使うことをおすすめします。functions.phpを直接編集せずにコードを追加でき、エラーがあっても自動的に無効化されるため安全です。

注意事項

  • functions.phpを編集する前には必ずバックアップを取ってください
  • テキストエディタは必ずUTF-8(BOMなし)で保存してください
  • コードはローカルでテストしてから本番に適用することを推奨します

まとめ

functions.php編集後の白い画面は、ほぼ確実にPHP文法エラーが原因です。FTPでファイルを修正・再アップロードするか、エラーログで問題行を特定して修正してください。

関連記事:

お気軽にご相談ください

お見積りへ お問い合わせへ