初級

count()にnullを渡したときのTypeErrorの原因

count()にnullを渡すと、PHP8ではTypeErrorが投げられます。関数が値を返し忘れてnullになった変数をそのままcount()に渡すと、ここで止まります。

エラーメッセージの読み方

Fatal error: Uncaught TypeError: count(): Argument #1 ($value) must be of type Countable|array, null given in main.php:6

main.php

ファイル名

6

行番号 — 実際にクラッシュした行

TypeError

例外クラス — 何が起きたか。ここを検索するのが最短です

count(): Argument #1 ($value) must be of type Countable|array, null given

内容 — どの値が問題だったか

このエラーが出る典型パターン

 1  <?php
 2  function getItems() {
 3      return null;
                 ^
 4  }
 5  $items = getItems();
 6  echo count($items);

 1  <?php
 2  function findUsers() {
 3      return null;
                 ^
 4  }
 5  $users = findUsers();
 6  echo count($users);

 1  <?php
 2  function loadTags() {
 3      return null;
                 ^
 4  }
 5  $tags = loadTags();
 6  echo count($tags);

 1  <?php
 2  function loadOrders() {
 3      return null;
                 ^
 4  }
 5  $orders = loadOrders();
 6  echo count($orders);

 1  <?php
 2  function fetchComments() {
 3      return null;
                 ^
 4  }
 5  $comments = fetchComments();
 6  echo count($comments);

よくある誤解

「PHP7と同じでcount(null)は0を返すだけ」という古い情報は8系には通用しません。PHP7では警告付きで0を返していましたが、8ではTypeErrorとして致命的エラーになりました。

実務での勘所

count()が受け付けるのは配列だけではありません。Countableインターフェースを実装したオブジェクト(count()を呼ばれたときにどう数えるかを自分で定義したクラス)も渡せます。エラーメッセージに「Countable|array」と表示されるのはこのためです。nullはこのどちらでもないため、TypeErrorとして拒否されます。独自のコレクションクラスを作る際にCountableを実装しておくと、count($myCollection)という自然な書き方ができるようになります。

演習をはじめる

関連するエラー

• DivisionByZeroError: Division by zero の原因と直し方0で割り算をすると、PHP8ではDivisionByZeroErrorという例外が投げられ、プログラムが止まります。
• Warning: Undefined array key の原因と直し方配列に存在しない添字でアクセスするとWarningが出ますが、プログラムは停止せず、その値はnullとして扱われます。