エラー

PHPの「invalid argument supplied for foreach()」エラーの原因と対処法を解説

2025-02-19更新日: 2025-02-19

PHPでforeach()を使用する際、対象の変数に配列やIteratorが渡されないと「invalid argument supplied for foreach()」エラーが発生します。

この記事では、このエラーの発生原因と具体的な対処法について分かりやすく解説します。

目次から探す

PHPエラー発生状況の確認
- エラーメッセージ「invalid argument supplied for foreach()」の内容
- エラー発生時の状況と条件
エラー原因の解析
- foreachに非配列が渡される場合の問題
- foreach利用時の注意点
コード例による検証
- 問題のあるコードパターン
- 改善後のコード例の提示
対処方法の解説
- 配列かどうか確認する方法
- 型キャストや初期化によるエラー改善
デバッグの進め方
- 変数状態の確認方法
- エラー箇所の特定方法
まとめ

PHPエラー発生状況の確認

エラーメッセージ「invalid argument supplied for foreach()」の内容

PHPでforeach構文を使用する際、与えられた変数が配列や反復可能なオブジェクトでない場合に発生するエラーです。

このエラーは「invalid argument supplied for foreach()」という表示となり、指定された引数が無効であることを示しています。

たとえば、変数がnullであったり、数値など反復処理に適さない型の場合にエラーが発生します。

エラー発生時の状況と条件

このエラーは以下のような場合に発生します。

変数が未定義またはnullとして使用された場合
配列として初期化されていない変数をforeachに渡した場合
非配列型のデータ(例: 整数、文字列、オブジェクト)がforeachの対象となった場合

エラー発生時は、コードのどの部分でエラーが生じたかが表示され、デバッグの際に問題箇所が特定しやすくなっています。

エラー原因の解析

foreachに非配列が渡される場合の問題

foreachは配列やオブジェクトを前提として動作するため、渡される値がそれら以外の場合にうまく処理できません。

以下では、主な原因となるパターンを説明します。

nullや未定義変数の影響

変数がnullの場合、foreachで処理を行うとエラーが発生します。
未定義状態の変数も同様にエラーを引き起こすため、事前に変数が存在しているか確認する必要があります。

例えば、以下のコードは変数が定義されていないためエラーとなる可能性があります。

// 変数$itemsが未定義
foreach ($items as $item) {
    // 処理
}

不適切なデータ型の使用

配列以外のデータ型、たとえば整数や文字列をforeachで回そうとすると、エラーが発生します。

以下の例では、数値を直接foreachに渡しているため、エラーとなります。

$number = 123;
// 数値は配列ではないためエラー
foreach ($number as $num) {
    // 処理
}

foreach利用時の注意点

foreachを使用する際は、対象となる変数が配列または反復可能なオブジェクトであることを確認する必要があります。

配列の初期化方法や変数の型をチェックする仕組みを入れることで、エラー発生のリスクが低減されます。

また、変数が未定義の場合は、適切な初期化を行ってから利用することが大切です。

コード例による検証

問題のあるコードパターン

コード例とエラー発生箇所の特定

以下は、意図せず非配列をforeachに渡してしまう例です。

この例では、変数$dataが配列として初期化されていないため、エラーが発生します。

// 変数$dataが未定義またはnull
$data = null;
// foreachで無効な引数エラーが出る可能性あり
foreach ($data as $value) {
    echo $value; // 出力処理
}

Warning: Invalid argument supplied for foreach() in /path/to/script.php on line XX

改善後のコード例の提示

配列初期化と型チェックの実装

改善方法として、変数を配列として初期化するか、あるいは実行前に型チェックを行う方法があります。

以下の例は、$dataが配列であるかどうかを確認し、配列以外の値の場合は空の配列で代替する方法です。

// 変数$dataを明示的に配列として初期化
$data = null;
// 配列かどうかを確認し、配列以外の場合は空の配列に変換
if (!is_array($data)) {
    $data = []; // 空の配列に初期化
}
foreach ($data as $value) {
    echo $value; // 出力処理
}

(出力結果は$dataの中身に依存します。$dataが空の場合は何も出力されません。)

対処方法の解説

配列かどうか確認する方法

is_arrayを利用した検証例

is_array関数を使うことで、変数が配列であるかを簡単に判断できます。

以下の例は、変数が配列でなければエラーメッセージを表示する方法です。

$data = "これは配列ではありません";
// 変数$dataが配列であるかをチェックする
if (!is_array($data)) {
    echo "エラー: 変数は配列ではありません\n"; // エラーメッセージの出力
} else {
    foreach ($data as $value) {
        echo $value; // 出力処理
    }
}

エラー: 変数は配列ではありません

型キャストや初期化によるエラー改善

修正コードの具体例

型キャストや変数の初期化を行うことにより、エラーを未然に防ぐことができます。

以下のコードは、変数が配列でない場合に強制的に配列へキャストし、エラーを回避する例です。

$data = "文字列";
// 変数$dataを配列にキャストすることで、foreach処理のエラーを回避
$dataArray = (array) $data;
foreach ($dataArray as $value) {
    echo $value; // 出力処理
}

文字列

デバッグの進め方

変数状態の確認方法

var_dumpやprint_rを活用した確認

エラー発生時に変数の状態を確認するために、var_dumpやprint_rを利用することが有効です。

これにより、変数の型や中身を簡単に把握することができます。

以下はvar_dumpを使った例です。

$data = "サンプルデータ";
// 変数の型と値を確認する
var_dump($data);

string(11) "サンプルデータ"

エラー箇所の特定方法

ログ出力によるエラー検知

エラーログを出力し、どの部分でエラーが発生しているのかを迅速に特定することが大切です。

PHPではerror_log関数を利用して任意のメッセージをログに記録することができます。

下記の例は、エラー発生箇所にログ出力を追加する方法です。

$data = null;
if (!is_array($data)) {
    error_log("エラー: \$dataが配列ではありません");
}
foreach ($data as $value) {
    // 本来の処理
    echo $value;
}

(ログに「エラー: $dataが配列ではありません」が記録されます。画面出力はありません。)

まとめ

この記事では、PHPで発生する「invalid argument supplied for foreach()」エラーの状況確認、原因解析、コード例による検証、対処方法及びデバッグ手法について詳しく解説しました。

エラー原因の詳細や具体的な改善策をコードサンプルを交えて説明することで、エラー発生の理由と対処法が明確に理解できます。

ぜひ、この記事の内容を参考に実際の開発環境でエラー解消に取り組んでみてください。