WordPressの検索・一覧表示でcritical errorが出たPHP8系不具合を修正した事例

※この記事内の一部リンクにはアフィリエイトリンク（PR）が含まれます。

ご相談内容

ご相談いただいたのは、WordPressで作られたカスタム投稿まわりの一覧・検索ページの不具合でした。

カスタム投稿、カスタム分類、カスタムフィールドを組み合わせてデータを表示しているサイトで、PHPを8系へ上げたあと、特定の絞り込み条件を選ぶと一覧が表示されず、「このサイトで重大なエラーが発生しました」という状態になっていました。あわせて、ページの一部でレイアウト崩れも発生していました。

作業条件

今回の作業では、既存プラグインはバージョンアップしない、プラグイン本体や親テーマには手を入れない、という前提がありました。

そのため、既存データはそのまま残し、子テーマ側のテンプレート修正でどこまで解消できるかを確認しました。再入力が必要になるような作り替えではなく、今あるデータ構造に合わせて表示側を安全に整える方針です。

原因の切り分け

エラーログと該当テンプレートを確認したところ、検索条件の受け取り方に問題がありました。

具体的には、条件が未選択のときに渡ってくる値と、コード側で想定している値の型が合っていませんでした。PHP7系では表面化しにくかった処理でも、PHP8系では型の扱いが厳しくなり、条件によって fatal error につながることがあります。

また、デバッグモードで表示される Notice / Deprecated / Warning と、実際に画面表示を止めていた fatal error は分けて確認しました。古いプラグインや親テーマ由来の警告は残る場合がありますが、今回の主対象は「検索・一覧表示が止まる不具合」の解消です。

対応したこと

子テーマ内のテンプレートで、検索条件として受け取る値を事前に整えるよう修正しました。

• 絞り込み条件を安全な型に変換してから処理する
• 未選択時でもエラーにならないように初期値を整える
• 不要な検索条件を組み立てないようにする
• 既存データやカスタムフィールドの値は変更しない
• 後から見返せるように修正箇所へコメントを残す

これにより、単独条件での絞り込み、複数条件の組み合わせ、詳細ページへの遷移を含めて、表示が止まらない状態まで確認できました。

今回のような不具合で大事なこと

WordPressの不具合では、「画面に出ている警告を全部消すこと」と「実際に止まっている機能を復旧すること」は、同じ作業範囲とは限りません。

特に、古いプラグインをバージョンアップできない、親テーマを編集できない、本番サイトには直接触らない、といった条件がある場合は、どこまでを今回の作業で直し、どこからを別対応にするかを最初に切り分けることが重要です。

WordPressの不具合修正・機能改善をご相談いただけます

WordPressのPHPエラー、表示崩れ、テーマ調整、フォーム、検索機能、カスタム投稿、カスタムフィールド、プラグインまわりの不具合など、内容を確認したうえで対応範囲を整理します。

やり取りは、各サービス内のメッセージまたはトークルームのみで対応しています。Zoom、ビデオ通話、電話、外部連絡先でのやり取りは行っていません。文章で状況・URL・エラー内容を共有いただければ、そこから調査方針を組み立てます。