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でファイルを修正・再アップロードするか、エラーログで問題行を特定して修正してください。
関連記事: