PHP 8のValueErrorとは？値の型チェックとエラー処理の方法をわかりやすく解説

PHP 8のValueErrorとは？

PHP 8では、新たな組み込み例外であるValueErrorが導入されました。この例外は、関数に「型としては有効だが、その操作には使用できない値」を渡した場合にスローされます。

従来のPHP（7以前）では、このようなケースではWarning（警告）が表示されるだけで処理が続行されていましたが、PHP 8ではValueErrorがスローされるようになりました。これにより、不正な値の検出がより明確になり、デバッグやエラー処理がしやすくなりました。

ValueErrorがスローされる典型的なケース

例えば、次のようなケースが該当します。

• 空の配列に対してarray_rand()を呼び出した場合
• json_decode()の第3引数（深さ）に負の値を指定した場合

例1：array_rand()に不正な引数を渡した場合

<?php
   declare(strict_types=1);
   array_rand([1, 2, 3], 0);
   json_decode('{}', true, -1);
?>

出力結果

Fatal error: Uncaught ValueError: array_rand(): Argument #1 ($array) cannot be empty

この例では、array_rand()の第2引数に「0」を指定しているため、ValueErrorがスローされます。PHP 7以前であればWarningで済んでいましたが、PHP 8では未捕捉の例外として致命的エラー（Fatal error）になります。

例2：strpos()に範囲外のオフセットを指定した場合

一方、すべての関数がValueErrorをスローするわけではありません。次の例を見てみましょう。

<?php
   $x = strpos("h", "hello", 16);
   var_dump($x);
?>

出力結果

bool(false)

strpos()の場合、検索開始位置（オフセット）が文字列の長さを超えていてもValueErrorはスローされず、単にfalseが返されます。このように、ValueErrorの挙動は関数ごとに異なるため、各関数のドキュメントを確認することが重要です。

ValueErrorをtry-catchで捕捉する方法

ValueErrorは通常の例外と同様に、try-catch構文で捕捉できます。エラーで処理を中断させたくない場合は、次のように記述します。

<?php
   try {
      array_rand([], 1);
   } catch (ValueError $e) {
      echo 'ValueErrorを捕捉しました: ' . $e->getMessage();
   }
?>

まとめ

PHP 8のValueErrorは、「型は正しいが値が不正」な場合にスローされる新しい組み込み例外です。従来のWarningよりも厳格なエラー検出が可能になり、try-catchで捕捉できるため、より堅牢で安全なコードを書くことができます。PHP 8への移行時には、これまでWarningで見過ごされていた箇所がエラーになる可能性があるため、注意して確認しましょう。