PHPのTypeErrorとは？発生原因と例外処理の方法を実例で解説

はじめに

TypeErrorクラスは、PHPにおけるErrorクラスを継承したエラークラスです。主に以下のようなケースでスローされます。

• 関数に渡された実引数の型と、仮引数で宣言された型が一致しない場合
• 戻り値の型宣言と、実際に返された値の型が一致しない場合
• 組み込み関数に不正な引数（数や型）が渡された場合

厳密な型チェックを有効にするには、スクリプトの先頭でdeclare(strict_types=1)を指定する必要があります。

例1：引数の型不一致によるTypeError

次の例では、仮引数はint型として宣言されていますが、呼び出し側で文字列を渡しているため、TypeErrorが発生します。try-catchブロックで捕捉し、エラーメッセージを出力しています。

<?php
function add(int $first, int $second) {
    echo "addition: " . ($first + $second);
}
try {
    add('first', 'second');
}
catch (TypeError $e) {
    echo $e->getMessage(), "\n";
}
?>

出力結果

Argument 1 passed to add() must be of the type integer, string given, called in C:\xampp\php\test.php on line 9

例2：戻り値の型不一致によるTypeError

次の例では、ユーザー定義関数がint型の戻り値を返すよう宣言されているにもかかわらず、実際には配列を返しています。このためTypeErrorがスローされます。

<?php
function myfunction(int $first, int $second): int {
    return array($first, $second);
}
try {
    $val = myfunction(10, 20);
    echo "returned data : " . $val;
}
catch (TypeError $e) {
    echo $e->getMessage(), "\n";
}
?>

出力結果

Return value of myfunction() must be of the type integer, array returned

例3：組み込み関数への不正な引数

PHPの組み込み関数に誤った数の引数を渡した場合にもTypeErrorがスローされます。ただしこの場合も、スクリプト冒頭でstrict_types=1を宣言しておく必要があります。

次の例では、2つの引数を受け取るpow()関数に対して3つの引数を渡しているため、エラーが発生します。

<?php
declare(strict_types=1);
try {
    echo pow(100, 2, 3);
}
catch (TypeError $e) {
    echo $e->getMessage(), "\n";
}
?>

出力結果

pow() expects exactly 2 parameters, 3 given

まとめ

TypeErrorは、PHPの型システムに関わる問題を検知するための重要なエラーです。strict_types宣言と組み合わせて使うことで、意図しない型変換によるバグを早期に発見できます。実際の開発では、try-catch構文でTypeErrorを適切に捕捉し、エラーメッセージをログに出力することで、デバッグの効率を大幅に向上させることができます。