JIN│Undefined array keyエラーの原因と解決方法

JINを使ったサイトでPHPを8.2へ変更した際、カテゴリーの表示時に警告が出た過去の事例です。ここでは警告の読み方と、当時行ったカテゴリーの再保存を紹介します。すべてのJIN環境で再現する不具合、または必ず直る手順ではありません。

カテゴリーページに出てくるエラー

Warning: Undefined array key "cps_none_labeling_act" in /home/hogehoge.co.jp/public_html/wp-content/themes/jin/category.php on line 58
Warning: Trying to access array offset on value of type null in /home/hogehoge.co.jp/public_html/wp-content/themes/jin/category.php on line 58

著者

motoki

WEB制作をしているデジタルノマド
WordPressのカスタマイズが好きで、色々と自作しています。

WordPressのカスタマイズに困ったらご相談ください！

MOTOKI合同会社

カスタマイズの依頼・相談

JINのUndefined array keyエラーの原因と解決方法

以下、解説です。

エラー内容

PHP 8.0では、未定義の配列キーの読み取りがNoticeからWarningへ変更されました。「厳密な型チェックを有効にしたこと」が原因という意味ではありません。PHP公式の互換性変更一覧で確認できます。

Warning: Undefined array key "cps_none_labeling_act" in /home/hogehoge.co.jp/public_html/wp-content/themes/jin/category.php on line 58
Warning: Trying to access array offset on value of type null in /home/hogehoge.co.jp/public_html/wp-content/themes/jin/category.php on line 58

1行目は指定キーがない配列を読んだ警告、2行目はnullを配列のように読んだ警告です。表示されたファイル名・行番号は調査の手掛かりですが、この文面だけで元データがGET、POST、カスタムフィールドのどれかは確定できません。

原因

このエラーは、主に以下のようなケースで発生します。

• $_POST['キー名'] や $array['キー名'] のように、存在が保証されていないキーに直接アクセスしている
• PHP 8.0以降では、未定義キーにアクセスした場合にWarningが出る仕様になった
• WordPressテーマやプラグインが古いPHP仕様のまま書かれている

解決方法

当時の事例では、対象カテゴリーの編集画面で内容を変更せず「更新」した後、Warningが表示されなくなりました。試す前にデータベースをバックアップし、カテゴリー名・スラッグ・説明・テーマ独自設定を控えてください。管理画面の「投稿 → カテゴリー」から該当カテゴリーを編集し、一度だけ更新して公開ページを確認します。

再保存によってカテゴリー関連の保存データが変わった可能性があります。ただし、当時のテーマ内部処理や変更されたデータはこの記事では検証できていません。

再保存しても警告が続く場合は繰り返さず、JIN・WordPress・PHPのバージョン、警告の全文、発生するカテゴリーを整理して開発元へ相談します。画面に出なくなった場合も、サーバーのエラーログと他のカテゴリーページを確認してください。意図しない設定変更があれば控えた設定に戻し、必要ならバックアップから復元します。

JINのアップデート情報

旧稿の「JINのアップデートは2024年5月で止まっている」という記述は誤りでした。2026年10月1日の確認時点で、公式更新履歴にはver2.931を含む後続の更新が掲載されています。導入前に公式の更新履歴と利用中のバージョンを照合してください。

この警告だけを理由にテーマ変更を決める必要はありません。まず検証環境でテーマ更新後の再現状況を確認します。公式更新履歴にある別の警告修正が、この記事のカテゴリー警告も直すとは限りません。親テーマのcategory.phpを直接変更したり、警告を非表示にするだけで修正完了と判断したりしないでください。