foreach()文は、配列やオブジェクトを繰り返し処理する際に使用される代表的な構文です。

以下の目次に沿って説明します。

  1. foreach()文の書き方
  2. 配列のインデックスの扱い方
  3. foreach()文の$keyと$valueの使い方
  4. 条件文の活用
  5. オブジェクト（object）の走査
  6. break文とcontinue文の活用
  7. 配列および連想配列（二次元配列）へのデータの格納と追加方法
  8. &$value（参照変数）の活用

配列やオブジェクトを走査して繰り返し処理を行うために使われます。

これは配列とオブジェクトに対してのみ動作することを意味しており、他のデータ型の変数や初期化されていない変数に対して使用しようとするとエラーが発生します。つまり、foreach()文は配列とオブジェクトにのみ有効であり、他のデータ型や未初期化の変数には使用できません。

構文

foreach()文には二つの構文があります。

  • 配列またはオブジェクトの値のみを取得して繰り返し処理を行う構文
  • 配列またはオブジェクトのキーと値の両方を取得して繰り返し処理を行う構文

配列またはオブジェクトの値のみを取得して繰り返し処理を行う構文

PHP - 構文 配列またはオブジェクトの値のみを取得して繰り返し処理を行う構文 
foreach (iterable_expression as $value) {
    // $valueを使った繰り返し処理のコード
}

この構文は、配列またはオブジェクトの値のみを取得して繰り返し処理を行います。$valueは、繰り返しのたびに配列やオブジェクトの要素の値に更新されます。以下のサンプルコードで確認してみましょう。

PHP 配列またはオブジェクトの値のみを取得して繰り返し処理を行う構文 － 例 
$fruits = ['apple', 'banana', 'orange'];

foreach ($fruits as $value) {
    echo $value . '<br>';
}
配列またはオブジェクトの値のみを取得して繰り返し処理を行う構文 － 実行結果

上記の例では、$value変数には配列またはオブジェクトの値のみが格納されます。foreach()ループが実行されるたびに、配列またはオブジェクトの次の値が$valueに更新されて出力されます。このように、配列やオブジェクトの値だけを取得して繰り返し処理を行う構文を使うことで、配列やオブジェクトの値に簡単にアクセスし、必要な処理を行うことができます。

ループ(loop)とは、
プログラムが特定の条件を満たすまで同じ処理を繰り返し実行する構造を指します。この用語は、その構造がまるで輪（ループ）のように繋がっていることに由来しています。

配列またはオブジェクトのキーと値の両方を取得して繰り返し処理を行う構文

PHP 配列またはオブジェクトのキーと値の両方を取得して繰り返し処理を行う構文 
foreach (iterable_expression as $key => $value) {
    // $keyと$valueを使った繰り返し処理のコード
}

この構文は、配列またはオブジェクトのキーと値の両方を取得して繰り返し処理を行います。$keyはキーを、$valueはそのキーに対応する値を表します。以下のサンプルコードで確認してみましょう。

PHP 配列またはオブジェクトのキーと値の両方を取得して繰り返し処理を行う構文 － 例 
$fruits = [
    'apple' => 'red',
    'banana' => 'yellow',
    'orange' => 'orange'
];

foreach ($fruits as $key => $value) {
    echo '果物: ' . $key . ', 色: ' . $value . '<br>';
}
配列またはオブジェクトのキーと値の両方を取得して繰り返し処理を行う構文 － 実行結果

上記の例では、$key変数には配列またはオブジェクトのキーが、$value変数にはそのキーに対応する値が格納されます。foreach()ループが実行されるたびに、配列またはオブジェクトの次のキーと値がそれぞれの変数に更新されて出力されます。このように、配列やオブジェクトのキーと値の両方を取得して繰り返し処理を行う構文を使うことで、キーと値に同時にアクセスし、必要な処理を行うことができます。

参考事項

PHPでは、while文に対する制御構造の代替構文（Alternative Syntax for Control Structures）がサポートされています。これを「コロン構文」とも呼びます。この構文は主にHTMLとPHPを混在させる際に、可読性を向上させるために使用されます。

PHP 代替のforeach()ループ 
<?php foreach (iterable_expression as $value): ?>
    <?php // 実行するコードブロック ?>
<?php endforeach; ?>
PHP 代替のforeach()ループ構文 
<?php foreach (iterable_expression as $key => $value): ?>
    <?php // 実行するコードブロック ?>
<?php endforeach; ?>

foreach()ループで配列のインデックスを扱う例を見てみましょう。

配列のインデックスを取得する

foreach()ループを使って配列から特定の値を検索し、その値に対応するインデックスを取得する簡単な例を紹介します。

PHP 
$fruits = ['apple', 'banana', 'orange'];

$searchValue = 'banana';
$searchIndex = -1;

foreach ($fruits as $index => $value) {
    if ($value === $searchValue) {
        $searchIndex = $index;
        $found = true;
    }
}

if ($searchIndex !== -1) {
    echo "インデックス " . $searchIndex . " で '" . $searchValue . "' の値を見つけました。";
} else {
    echo "'" . $searchValue . "' の値は見つかりませんでした。";
}

// 出力: "インデックス 1 で 'banana' の値を見つけました。"

上記の例では、$searchValue変数に検索したい値を設定し、$searchIndex変数を初期化しています。foreach()ループで配列を走査し、該当する値があるかどうかを確認し、一致する場合は$searchIndex変数にそのインデックスを保存します。

ループ終了後、$searchIndex変数を確認して値が見つかったかどうかを判断し、適切なメッセージを表示します。上記の例では"banana"の値が見つかったため、結果として「インデックス 1 で "banana" の値を見つけました。」と出力されます。もし該当する値が見つからなかった場合は、「見つかりませんでした。」というメッセージが表示されます。

配列の最後のインデックスを取得する

foreach()ループを使って配列の最後のインデックスを取得する簡単な例を紹介します。最後のインデックスを見つけるには、foreach()ループを最後まで回し、最後に繰り返されたインデックスを保存すれば良いです。

PHP 
$fruits = ['apple', 'banana', 'orange'];

$lastIndex = null;

foreach ($fruits as $index => $value) {
    $lastIndex = $index;
}

if ($lastIndex !== null) {
    echo '最後のインデックス: ' . $lastIndex;
} else {
    echo '配列が空です。';
}

// 出力: '最後のインデックス: 2'

上記の例では、$lastIndex変数を宣言し初期化しています。foreach()ループで配列を走査しながら、$lastIndex変数に$indexを繰り返し更新しています。ループ終了時点で、$lastIndexには配列の最後のインデックスが格納されます。

foreach()ループで$keyと$valueの形式を使い、配列のキーと値を同時に扱う例を紹介します。

PHP 
$person = [
    'name' => 'John',
    'age' => 30,
    'occupation' => 'Engineer',
    'country' => 'USA'
];

echo '個人情報:<br>';

foreach ($person as $key => $value) {
    echo ucfirst($key) . ': ' . $value . '<br>';
}

上記の例では、$personは連想配列であり、それぞれのキーと対応する値を表しています。foreach()ループのasの後に、$keyと$valueという2つの変数を使い、各ループでキーと値を取得します。

ループが実行されるたびに、$keyには現在のキーが、$valueにはそのキーに対応する値が格納されます。ucfirst()関数を使って各キーの最初の文字を大文字に変換し、その後各情報を出力しています。

上記の例を実行すると、以下のような結果が表示されます。

結果の出力

このように、$keyと$valueの形式でforeach()ループを使用すると、配列のキーと値をペアとして扱うことができ、各要素に対して自由に処理を行うことができます。

foreach()ループは一般的に配列やオブジェクトの全ての要素を順に処理します。しかし、場合によっては特定の条件を満たす要素だけを選択的に処理したいことがあります。その際は、foreach()ループと条件文を組み合わせて、条件を満たす要素のみを処理することができます。

以下は、foreach()ループと条件文を組み合わせて活用する例です。ここでは、数値の配列から偶数のみを出力する場合を示します。

PHP 
$numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];

echo '偶数:<br>';

foreach ($numbers as $number) {
    if ($number % 2 === 0) {
        echo $number . '<br>';
    }
}

上記の例では、$numbersは数字の配列です。foreach()ループを使って配列の各要素を順に処理します。ループが実行されるたびに、$number変数には現在の要素の値が格納されます。

ループ内でif条件文を使い、$numberが偶数かどうかを判定し、偶数の場合のみ該当する数字を出力します。上記の例を実行すると、以下のような結果が表示されます。

結果の出力

このように、foreach()ループと条件文を組み合わせて、条件を満たす要素だけを選択的に処理することができます。これを応用すれば、配列やオブジェクトの特定の条件をチェックし、その条件を満たす要素に対して任意の処理を行うことが可能です。

foreach()ループは配列だけでなく、オブジェクト（Object）のプロパティも順に処理できます。PHPでオブジェクトをループ処理する場合、オブジェクトのプロパティはキーと値のペアとして扱われます。

以下は、オブジェクトを foreach() ループで反復処理する例です。

PHP 
class Person {
    public $name;
    public $age;
    public $occupation;

    public function __construct($name, $age, $occupation) {
        $this->name = $name;
        $this->age = $age;
        $this->occupation = $occupation;
    }
}

$person = new Person('John', 30, 'Engineer');

foreach ($person as $key => $value) {
    echo ucfirst($key) . ': ' . $value . '<br>';
}

上の例では、Person クラスを定義し、そのクラスのオブジェクトを生成しています。Person クラスには、name、age、occupation の3つのプロパティがあります。

foreach() ループを使用して、$person オブジェクトを反復処理します。ループが実行されるたびに、$key にはオブジェクトのプロパティ名が、$value にはそのプロパティの値が格納されます。オブジェクトのプロパティには順序がないため、ループの実行順序は保証されません。

ループ内では、ucfirst() 関数を使用して各プロパティ名の先頭文字を大文字に変換し、そのプロパティ名と値を出力します。

上記の例を実行すると、次のような結果が出力されます。

結果の出力

このように、foreach() ループを使うことで、オブジェクトのプロパティを順に処理することができ、各プロパティとその値を任意の方法で扱うことが可能です。プロパティの数が多い場合や、動的に変化する場合でも、foreach() を使えば柔軟にオブジェクトのプロパティを操作できます。

주의하세요!
foreach() 반복문으로 객체의 속성(property)에는 접근할 수 있지만, 객체의 멤버 메서드(method)에는 직접 접근할 수는 없습니다. foreach() 반복문은 주로 배열이나 객체의 속성들을 순회하기 위한 반복문이며, 속성(property)은 값을 가지지만 메서드(method)는 실행 가능한 함수이기 때문에 다루는 방식이 다릅니다.

foreach() ループでも、break と continue キーワードを使用してループの動作を制御することができます。
break は現在実行中のループを即座に終了し、次の処理へ制御を移します。continue はループ内の現在の繰り返し処理をスキップし、次の繰り返しへ進むために使用されます。

以下の例では、foreach() ループ内で break と continue を活用する方法を紹介します。

break キーワードの活用

コードの補足説明
break キーワードは、ループ文や switch 文で使用され、現在実行中の文を即座に終了し、次の処理へ制御を移す命令です。

PHP 
$numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];

echo '最初の偶数を探します:<br>';

foreach ($numbers as $number) {
    if ($number % 2 === 0) {
        echo '最初の偶数: ' . $number . '<br>';
        break;
    }
}
結果の出力

上記の例では、$numbers 配列から最初の偶数を探して出力する例です。foreach() ループを使って配列の各要素を順に処理し、ループ実行中に偶数を見つけたら break を使ってループを停止します。したがって、最初の偶数を見つけた時点でループが終了します。

continue キーワードの活用

コードの補足説明
continue キーワードは、ループ内で現在の繰り返し処理の残りをスキップし、次の繰り返しを直ちに開始する命令です。

PHP 
$numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];

echo '偶数のみを出力する:<br>';

foreach ($numbers as $number) {
    if ($number % 2 !== 0) {
        continue;
    }
    echo $number . '<br>';
}
結果の出力

上記の例では、$numbers 配列から偶数のみを出力する例です。foreach() ループを使って配列の各要素を順に処理し、ループ内で偶数でない場合は continue キーワードを使ってその繰り返しをスキップします。したがって、偶数の場合のみ数字が出力されます。

foreach() ループを使って配列および連想配列（二次元配列）にデータを格納し、追加する方法を紹介します。

配列へのデータの格納および追加

PHP 
$numbers = [1, 2, 3, 4, 5];
$newNumbers = [];

// 既存の配列の値に1を加えて新しい配列に格納
foreach ($numbers as $number) {
    $newNumbers[] = $number + 1;
}

// 新しい配列のデータを出力
foreach ($newNumbers as $number) {
    echo $number . '<br>';
}

上記の例では、$numbers が既存の配列で、$newNumbers は空の配列です。foreach() ループを使って $numbers 配列の各要素を順に処理し、各要素に1を加えた値を $newNumbers 配列に格納しています。

したがって、新しい配列 $newNumbers には、既存の配列 $numbers の値に1を加えた値が格納されます。そして、foreach() ループを使って $newNumbers 配列のデータを出力すると、次のような結果が表示されます。

結果の出力

連想配列（二次元配列）へのデータの格納および追加

PHP 
// 既存の配列データ
$studentsData = [
    ['name' => 'John', 'age' => 25, 'score' => 85],
    ['name' => 'Alice', 'age' => 23, 'score' => 90]
];

// 空の連想配列（二次元配列）を作成
$students = [];

// データの追加および格納
foreach ($studentsData as $student) {
    $students[] = $student;
}

// 新しいデータを追加
$students[] = ['name' => 'Bob', 'age' => 22, 'score' => 78];

// foreach() ループでデータを出力
foreach ($students as $student) {
    echo 'Name: ' . $student['name'] . ', Age: ' . $student['age'] . ', Score: ' . $student['score'] . '<br>';
}
結果の出力

上記の例では、$studentsData が既存の配列データを表す変数です。このデータを別の変数に保存した後、foreach() ループで $studentsData の各要素を $student という一時変数に順次格納して使用しています。

$studentsData 変数を別に用意しておくことで、既存データの取り扱いが容易になります。foreach() ループでは、$studentsData を順に処理し、$students 配列にデータを追加する作業を行います。

foreach() ループで &$value を使うと、配列の要素を参照（reference）として扱うことができます。これにより、foreach() ループ内で配列の値を変更することが可能です。参照変数を使用すると元の配列の要素を直接修正できるため、特定の状況で非常に有用です。

以下は、&$value を使って foreach() ループ内で配列の値を変更する例です。

PHP 
$numbers = [1, 2, 3, 4, 5];

// foreach() ループで &$value を使い配列の要素を変更
foreach ($numbers as &$value) {
    $value = $value * 2;
}

// 変更された配列を出力
foreach ($numbers as $number) {
    echo $number . '<br>';
}
結果の出力

上記の例では、$numbers 配列の各要素を foreach() ループ内で $value 変数に参照（reference）として割り当てています。&$value を使うことで、配列の値と連動する参照変数を生成しています。

ループ内で $value を変更すると、元の配列の値も変更されます。例では各要素を2倍にして、$numbers 配列が変更されています。

&$value を使うことで、foreach() ループ内で配列の値を直接変更できるため、注意が必要です。この機能を活用すると配列を効率的に操作できますが、誤って不要な変更を加えないよう十分に気を付けてください。

foreach() ループで &$value（参照変数）を活用する場合の有用なケース

  • 配列の要素を変更する必要がある場合： foreach() ループ内で &$value を使うと、配列の要素を直接参照して修正できます。配列の値だけでなく、キー（key）の変更も可能です。
  • 大容量データの処理： 大きなサイズの配列を処理する際、&$value を使って配列の要素を直接修正することで、メモリ使用量や実行速度の改善が期待できます。これは値をコピーして新しい変数に代入する方法よりも効率的です。
  • 多次元配列で特定の値を修正する場合： 多次元配列の特定の値を探して変更する際、foreach() ループを使って該当する値が見つかるまで順に処理し、&$value を利用して値を修正できます。
  • 条件に応じた配列要素の修正： foreach() ループを使って配列を順に処理し、特定の条件に該当する要素を見つけて変更する場合に有効です。

なお、&$value を使用する際には注意が必要です。必ず必要な場合にのみ使用し、誤って意図しない修正を行わないように気を付けてください。特に多次元配列で使う場合は、配列の構造を正確に理解した上で使用することが重要です。正しく使えば便利なツールとなりますが、誤用するとバグの原因となったり、コードの理解を難しくする恐れがあります。したがって慎重に活用することが求められます。

参考資料

関連項目