PHPのcount関数にnullを渡すとどうなる？エラーを防ぐ対策

PHPで配列の要素数を調べるcount関数は非常に便利です。ですが、nullやCountableでない型を渡した場合、PHPのバージョンによって振る舞いが異なり、エラーや警告が発生することがあります。この問題を正しく理解し、安全に扱うための最新情報と具体的な対策を解説します。

PHP count 関数 null の挙動と問題点

このセクションでは count 関数に null を渡したときに何が起こるか、特に警告やエラーがいつ発生するのかを理解します。

PHP 5 / PHP 7.1以前での挙動

これまでの PHP のバージョンでは、count 関数に null を渡した場合、警告なしに 0 を返す処理がされていました。null は配列でも Countable オブジェクトでもないため、特例として 0 を返すという仕様になっていたのです。この動作は古いスクリプトやレガシーコードでよく見られました。

PHP 7.2 以降の変更点

PHP 7.2 からは、count に null を渡すと警告が発生するようになりました。「Parameter must be an array or an object that implements Countable」という型に関する警告が表示され、null やスカラー値（文字列や数値など）もこの対象に含まれます。仕様がより厳密になり、意図しない null が明示的に検知されるようになったのです。

PHP 8.0、8.1 以降でのエラー扱いの進化

さらに PHP 8.0 以降では、null を含む非 Countable な型を count に渡した場合の扱いがさらに厳しくなっています。PHP 8.0 では非 Countable 型を数える行為が型のデプリケーション対象となり、8.1+ ではこれがエラーに近い扱いになるなど、安全性を向上させる方向へ仕様が進化しています。このような変更により、null をそのまま count に渡すことは避けるべきとされています。

なぜ null を count に渡すと問題になるのか

この見出しでは null を count に渡すことでどのような問題が起こるのか、その理由と影響を掘り下げます。

警告とエラーが発生する理由

PHP が null を count に渡されたときに警告やエラーを出すのは、引数が期待される型（配列または Countable を実装するオブジェクト）ではないためです。型に関する不整合を警告することで、バグや予期せぬ振る舞いを早期に発見できるようになっています。型安全性の向上とコードの品質保証の観点から仕様の強化が進んでいます。

互換性とレガシーコードへの影響

古いコードでは null を count に渡すことが普通に行われていたため、その動作を前提としているコードが多々あります。PHP 7.2+ や 8 系にアップグレードした際、これらのコードが警告を発生させたり、エラーを引き起こすため、後方互換性の問題が表面化します。レガシーシステムでは特に注意が必要です。

開発中のバグの隠れ蓑になりやすい

null を配列の代わりに渡すケースは、データベースの結果が取得できなかった、API が空を返した、初期化を忘れた、といった原因で発生しがちです。このような状況を警告なしで 0 を返す仕様のままだと、null がその後の処理で無視され、バグが潜んでしまう可能性があります。仕様変更によりこうしたバグが早期発見できるようになったとも言えます。

最新情報の仕様：PHPのバージョン別にどう扱われるか

以下に PHP の各バージョンで count に null を渡したときの具体的な挙動をまとめておきます。

この表は最新情報に基づいており、PHP の動作変更が明確に仕様化されたものを反映しています。開発環境・本番環境で同一バージョンを使用しているかどうかを確認した上で対応を考えることが大切です。

nullを安全に扱うための対策

null を count に渡したときの問題を回避する具体的な方法を紹介します。どれか一つ、あるいは複数を組み合わせて使うことで、安全性が高まります。

is_countable を使ったチェック

PHP 7.3 以降で利用できる is_countable 関数を使うと、引数が配列または Countable インターフェースを実装するオブジェクトであるかを簡単に調べられます。count を実行する前にこのチェックを行えば、null を渡して警告されることを防げます。

null 合体演算子（??）を使うフォールバック

変数が null かもしれない場合は、null 合体演算子を使ってデフォルトで空配列を与える方法があります。例： count($var ?? [])。こうすることで null の場合は [] が渡され、count は 0 を返す安全なコードになります。

キャストによる強制変換

(array)$var とキャストしてから count を行う方法です。null → 空配列、スカラー → 配列として扱われるため、警告が発生しにくくなります。ただしスカラーを配列化することで意図しない数値 1 が出るケースもあり得るため、使用の際の設計を確認する必要があります。

empty() や isset() を併用する

empty() 関数は配列が空・null・false など幅広に「空」であるケースを扱います。また isset() で変数が宣言されているかを確認することで未定義変数による問題も回避できます。count > 0 より empty や isset の組み合わせの方が安全なことが多いです。

実践コード例：null 安全な count の使い方

以下はいくつか実践的なコード例です。現場ですぐ使える形で、null を安全に扱う方法を示します。

例１：is_countable を使った方法

“`php
if (is_countable($items)) {
  $cnt = count($items);
} else {
  $cnt = 0;
}
“`
この方法は可読性が高く、どのような型が来ても安全に動作します。

例２：null 合体演算子を用いたワンライナー

“`php
$cnt = count($items ?? []);
“`
null の場合は [] を使うため、警告なしで 0 を返します。コードがすっきりしていて便利です。

例３：キャストでの対応

“`php
$cnt = count((array)$items);
“`
null が [] に変換され、その他の型も配列として数えられます。スカラー値は配列の要素一つとして扱われるため注意が必要です。

例４：empty を使った存在と空のチェック

“`php
if (!empty($items)) {
  $cnt = count($items);
} else {
  $cnt = 0;
}
“`
empty は null や空配列、false など広い範囲を「空」と判断しますので安全です。

性能と保守性に与える影響

null 安全な count の扱いは、性能や保守性にも影響を及ぼします。ここではその観点からのメリットと注意点を整理します。

性能の観点

型チェックやキャストを追加することで、count の呼び出し回数が多いループ内などではオーバーヘッドが無視できない場合があります。ただし、警告やエラーを回避するコードは一度書いておけば安全性が高く、実際の処理時間の差は微小であることが多いです。

保守性の観点

チームでの開発やレビューにおいて、null を許容する設計かどうかを明らかにしておくことが重要です。明示的なチェックやフォールバックを使うことで、後から読み返したときに意図がわかりやすくなります。将来の PHP バージョンアップを見据えたコードを書くことでトラブルを未然に防げます。

エラーログへの影響とデバッグ

null を count に渡すと警告やエラーが発生するため、エラーログに大量の不要ログが残ることがあります。これが大量に積み重なると、本当に追いたいバグを見逃してしまう原因にもなります。ログの質を保ちつつ、コード中で null フローをクリアにすることがエラー対策として有効です。

その他の関数との比較：null 扱いの類似性・差異

count だけでなく、null が関わる他の関数との比較を理解すると、より一貫性のある設計が可能になります。

empty() の振る舞い

empty 関数は、対象が null、空文字列、false、空配列などの「空」の状態を包括的に扱います。null を空配列と同等と見なして false を返すため、count() より柔軟に使われることがあります。ただし要素数そのものを取得したい場合には count の方が明確です。

isset()・is_null() の使い分け

isset は変数が定義されていて null でないことを確認するためのもので、null を扱う前段階で使われます。is_null は値が null かどうかを判定するためのものです。count に null を渡すリスクを防ぐためには isset と is_null を組み合わせて使うタイミングがあります。

Countable インターフェースを実装したオブジェクトとの関係

クラスが Countable インターフェースを実装している場合、そのオブジェクトを count に渡せます。null ではなくオブジェクトを返す仕様にし、Countable を実装させることで count の動作を制御することができます。オブジェクトの設計次第で count の振る舞いを意図的に決められるようになります。

まとめ

count 関数に null を渡すことは、PHP のバージョンによって振る舞いが異なり、最新のバージョンでは警告やエラーの原因となります。null をそのまま渡すのではなく、is_countable を使って型を確認する、null 合体演算子でデフォルト値を設定する、キャストする、empty や isset を使うなどの対策が重要です。

これらの方法を組み合わせて使うことで、安全でメンテナンス性の高いコードが書けます。特にライブラリやフレームワークを扱う場面では、null の可能性を常に考え、意図しない挙動やログのノイズを防ぐことが求められます。PHP の仕様変更を踏まえて、null を含む値に対して慎重なコーディングを心がけましょう。