WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

Variablen per Referenz in einer PHP-Closure erfassen: `use (&$carry)`

Mit `use (&$carry)` können eine Closure und der Bereich, in dem sie definiert wurde, dieselbe Variable lesen und ändern. Ohne `&` wird der Wert zum Erstellungszeitpunkt erfasst.

Version: PHP 8.3; extension availability may vary

Syntax

$carry = 0;
$add = function (int $item) use (&$carry): void {
    $carry += $item;
};

In PHP 8.3 steht use (&$carry) nach der Parameterliste einer anonymen Funktion und vor einem optionalen Rückgabetyp. Mit & greifen beide Vorkommen von $carry auf denselben Variableninhalt zu. Eine Zuweisung auf einer Seite ist auf der anderen sichtbar. Entscheidend ist der Ort der Definition, nicht der Ort des Aufrufs. $carry ist ein gewöhnlicher Variablenname, kein Schlüsselwort.

use ($carry) übernimmt den Wert zum Erstellungszeitpunkt: Eine spätere Zuweisung an die äußere Ganzzahlvariable ändert nicht, was die Closure liest. Eine Pfeilfunktion (fn) übernimmt Werte automatisch. Diese use-Klausel ist kein Namensraumimport und weder ein Referenzparameter (function (&$carry)) noch eine Rückgabe per Referenz (function &()). In der use-Liste sind $this, Superglobale und bereits als Parameter verwendete Namen nicht erlaubt.

Initialisiere $carry, bevor du die Closure erstellst. Die Closure kann auch nach der Rückkehr aus der definierenden Funktion auf den erfassten Zustand zugreifen. unset($carry) außerhalb der Closure löst nur die äußere Bindung; eine erneute Zuweisung an diesen Namen stellt die Bindung nicht wieder her. Nutze Referenzen, wenn gemeinsam veränderlicher Zustand beabsichtigt ist: Am Aufrufausdruck allein ist nicht erkennbar, dass die Closure $carry ändert, aber nach dem Aufruf lässt sich der aktualisierte Wert aus der äußeren Variable $carry lesen.

Der Callback-Parameter $carry von array_reduce() funktioniert anders: Er erhält zuerst den Startwert und danach den Rückgabewert des jeweils vorigen Callback-Aufrufs. Gib bei einer einfachen Reduktion den aktualisierten Akkumulator zurück, statt eine äußere Variable zu erfassen. Die Syntax use (&$carry) erfordert keine zusätzliche Erweiterung.

Beispiele

<?php
$carry = 0;
$snapshot = function () use ($carry): int {
    return $carry;
};
$add = function (int $item) use (&$carry): void {
    $carry += $item;
};

$add(2);
echo $carry, "\n";
$carry += 10;
$add(3);
echo $snapshot(), "\n", $carry, "\n";

Ergebnis

2
0
15

`$add(2)` setzt das äußere `$carry` auf `2`. Nachdem der äußere Code `10` addiert hat, liest `$add(3)` den Wert `12` und schreibt `15`. `$snapshot()` gibt weiterhin `0` zurück, weil der Wert bei der Erstellung übernommen wurde.

Zugehörige Lektionen

  • PHP · Lektion 15 · Fortgeschritten · Version: 2

Quellen