WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

`foreach` mit Referenz auf das Element (`&$row`)

Mit `&$row` änderst du Array-Elemente direkt. Löse nach der Schleife mit `unset($row)` die Referenz auf das zuletzt besuchte Element.

Version: PHP 8.3

Syntax

// The array syntax shown here requires no optional extensions in PHP 8.3.
foreach ($rows as &$row) {
    // Modify the current array element through $row.
}
unset($row);

// With a key:
foreach ($rows as $key => &$row) {
    // $key is the current key; $row is the element reference.
}
unset($row);

In PHP 8.3 wird $row in foreach ($rows as &$row) bei jedem Durchlauf zu einem Alias für das aktuelle Array-Element. Eine Änderung an $row['qty'] aktualisiert dieses Feld direkt in $rows; eine Zuweisung eines neuen Werts an $row ersetzt das gesamte Element. & bindet hier per Referenz und ist kein bitweises UND. In der Form $key => &$row erhält $key den Schlüssel als Wert.

Wenn die Schleife mindestens einmal durchlaufen wurde, bleibt $row danach ein Alias für das zuletzt besuchte Element. Rufe unmittelbar danach unset($row) auf: Das löst die Bindung, ohne das Element zu löschen oder Änderungen rückgängig zu machen. Andernfalls kann eine spätere Zuweisung an $row das Element unbemerkt überschreiben, selbst in foreach ($rows as $row) ohne &.

Zum Lesen gewöhnlicher Array-Zeilen verwende foreach ($rows as $row) und stelle sicher, dass $row nicht bereits eine Referenz ist. Bei dieser Iteration nach Wert ersetzt eine Zuweisung an $row das Element in $rows nicht. Die gezeigte Syntax für Arrays erfordert keine zusätzlichen Erweiterungen.

Beispiele

<?php
$rows = [
    ['item' => 'A', 'qty' => 2],
    ['item' => 'B', 'qty' => 5],
];

foreach ($rows as &$row) {
    $row['qty'] += 1;
}
unset($row);

foreach ($rows as $row) {
    echo $row['item'], ': ', $row['qty'], "\n";
}

Ergebnis

A: 3
B: 6

Die erste Schleife erhöht beide Mengen, die zweite liest die geänderten Zeilen. Ohne `unset($row)` würde die zweite Schleife die letzte Zeile überschreiben und zweimal `A: 3` ausgeben.

Zugehörige Lektionen

  • PHP · Lektion 19 · Fortgeschritten · Version: 2

Quellen