PHP Fatal error: Uncaught TypeError: Unsupported operand types の原因と解決方法【PHP8以降の型厳格化に対応】

Fatal error: Uncaught TypeError: Unsupported operand types: string + array とは

PHP 7以降の型宣言の導入やPHP 8のJITコンパイルなど、PHPもモダンな言語へと進化し、より厳格な型チェックが行われるようになりました。その結果、従来は暗黙的に型変換されていた操作が `TypeError` として顕在化することが増えています。特に `Unsupported operand types` は、異なるデータ型間でサポートされていない演算を実行しようとした際に発生し、多くの開発者を悩ませる頻出エラーの一つです。

エラーの発生パターン

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

パターン1: パターン1: 文字列と配列の直接結合

 30, 'city' => 'Tokyo'];

// 文字列と配列を直接結合しようとしている
echo "Welcome, " . $userName . ", your data is: " . $userData;
?>

このエラーは、文字列型の変数と配列型の変数を`.` 演算子で直接結合しようとした際に発生します。PHP 8.0以降では、非スカラー型（配列やオブジェクト）を文字列に暗黙的に変換して連結する動作は許可されなくなり、`TypeError` が発生するようになりました。PHP 7系までは `Warning: Array to string conversion` として扱われていました。

 30, 'city' => 'Tokyo'];

// 配列の内容を明示的に指定するか、JSON形式に変換して結合する
echo "Welcome, " . $userName . ", your age is: " . $userData['age'] . ", city: " . $userData['city'] . ".";
// または
echo "Welcome, " . $userName . ", your data is: " . json_encode($userData);
?>

パターン2: パターン2: 数値演算における非数値文字列の利用

変数 `$quantityInput` が数値として解釈できない文字列であるにも関わらず、乗算演算子 (`*`) を適用しようとしています。PHPは型が緩い言語ですが、算術演算子を使用する際にはオペランドが数値型である必要があります。この場合、PHPは文字列を数値に変換しようとしますが、「five」は変換できないため `TypeError` が発生します。

パターン3: パターン3: オブジェクトとスカラー値の直接比較

 0) {
    echo "Product exists and stock is positive.";
} else {
    echo "No product or invalid stock.";
}
?>

このコードでは、`Product` クラスのインスタンスであるオブジェクト `$product` と、数値 `0` を直接比較しようとしています。PHPでは、オブジェクトはデフォルトではスカラー値（数値、文字列、真偽値など）と比較できません。オブジェクトの比較には、特定のプロパティを取り出すか、`__toString()` メソッドを実装するか、`empty()` や `isset()` で存在チェックを行うなど、明示的な方法が必要です。

stock > 0) {
    echo "Product exists and stock is positive.";
} else {
    echo "No product or invalid stock.";
}

// オブジェクトの存在チェックであれば empty() を使う
if (!empty($product)) {
    echo "Product object exists.";
}
?>

根本原因の特定方法

このエラーが発生した場合、スタックトレースを確認し、エラーが発生したファイルと行番号を特定します。次に、その行で{marker}どのような変数間でどのような演算が行われているか{/marker}を確認し、それぞれの変数の実際の型を `var_dump()` や `gettype()` を使って調べます。これにより、どのオペランドが期待と異なる型であるかを特定できます。

 'value'];

var_dump($message); // string(6) "Data: "
var_dump($data);    // array(1) { ["key"]=> string(5) "value" }

// この行でエラーが発生すると仮定
// echo $message . $data;
?>

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

このエラーを未然に防ぐためには、{marker}変数の型を常に意識すること{/marker}が重要です。特に外部からの入力（フォームデータ、APIレスポンスなど）やデータベースからの取得データは、信頼できないデータソースからの値であるため、使用前に `is_numeric()`, `is_string()`, `is_array()` などの型チェック関数で検証し、必要に応じて `(int)`, `(string)` などの型キャストを行いましょう。

よくある質問（FAQ）

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