PHP Fatal error: Uncaught TypeError: Argument 1 passed to … must be of type … given の原因と解決方法【型宣言の落とし穴と厳格モード】

Fatal error: Uncaught TypeError: Argument %d passed to %s must be of type %s, %s given とは

PHP 7.0以降で導入された型宣言は、コードの品質と堅牢性を高める強力な機能ですが、その使い方を誤ると `Fatal error: Uncaught TypeError` に遭遇することがあります。特に、関数の引数に期待する型と異なる値が渡された際に発生するこのエラーは、開発中に頻繁に直面する問題の一つです。PHPの型システムへの理解を深め、効率的にデバッグ・解決していきましょう。

エラーの発生パターン

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

パターン1: パターン1: null許容型ではない引数に`null`が渡された場合

このケースは最も一般的で、`string`型を期待する引数に`null`が渡されたために発生します。関数の引数に`null`を受け入れる場合は、明示的にnull許容型として宣言する必要があります。

パターン2: パターン2: 型ヒントと異なる型の値が渡された場合（暗黙的な型変換の失敗）

`declare(strict_types=1);`ディレクティブが有効な環境で、期待される型と異なる型の値が渡された場合に発生します。PHPは通常、可能な限り自動的に型変換を行いますが、厳格モードではこの挙動が無効になり、型不一致が即座にTypeErrorとして扱われます。

パターン3: パターン3: オブジェクトのメソッド呼び出しで引数型が不一致

price = $price;
    }
}

$product = new Product();
// 期待されるのはint型だが、文字列'1000'が渡されている
$product->setPrice('1000');
?>

クラスのメソッドも関数と同様に、引数の型宣言に従う必要があります。この例では、`setPrice`メソッドが`int`型を期待しているにもかかわらず、文字列`’1000’`が渡されたためにTypeErrorが発生しています。

price = $price;
    }

    public function getPrice(): int
    {
        return $this->price;
    }
}

$product = new Product();
// 正しいint型の値を渡す
$product->setPrice(1000);
echo "Product Price: " . $product->getPrice() . "\n";
?>

根本原因の特定方法

このTypeErrorが発生した場合、まずエラーメッセージのスタックトレースを注意深く読み込み、どのファイル・行のどの関数呼び出しで型不一致が発生したかを確認します。次に、その関数に渡されている引数の実際の型を{marker}`var_dump()`や`gettype()`{/marker}で確認し、期待する型と何が違うのかを特定します。Xdebugのようなデバッガーを使用すると、実行時に変数の値と型を詳細に追跡できるため、原因特定が格段に早くなります。

 'bar']; // 意図的に間違った型を渡す

try {
    processData($invalidData);
} catch (TypeError $e) {
    echo "Caught TypeError: " . $e->getMessage() . "\n";
    echo "File: " . $e->getFile() . " (Line: " . $e->getLine() . ")\n";
    echo "Stack trace:\n" . $e->getTraceAsString();
}
?>

防止策とベストプラクティス

TypeErrorを未然に防ぐためには、まず{marker}関数の引数や返り値、クラスプロパティに適切な型宣言を施す{/marker}ことが重要です。特に外部からの入力値（ユーザー入力、APIレスポンス、データベースからのデータなど）を扱う際は、常にバリデーションを行い、期待する型に変換してから使用するように徹底しましょう。また、`null`を許容する可能性がある場合は、`?Type`形式のnull許容型を積極的に利用し、関数内で`null`チェックを行う習慣をつけることが大切です。

getMessage() . "\n";
}
?>

よくある質問（FAQ）

この用語と一緒に知っておきたい用語