CKTIS / PHP
Capturar una variable por referencia en un cierre PHP: `use (&$carry)`
Con `use (&$carry)`, un cierre y el ámbito donde se definió pueden leer y modificar la misma variable. Sin `&`, el cierre captura el valor que había al crearlo.
Versión: PHP 8.3; extension availability may vary
Sintaxis
$carry = 0;
$add = function (int $item) use (&$carry): void {
$carry += $item;
};En PHP 8.3, use (&$carry) se coloca después de la lista de parámetros de una función anónima y antes del tipo de retorno, si lo hay. Con &, las dos apariciones de $carry se refieren al mismo contenido. Una asignación en un lado se ve en el otro. La captura se hace en el ámbito de definición, no en el de la llamada. $carry es un nombre de variable corriente, no una palabra reservada.
use ($carry) captura el valor al crear el cierre: asignar después otro valor a la variable entera externa no cambia lo que lee el cierre. Una función flecha (fn) captura automáticamente por valor. Esta cláusula use no importa nombres de un espacio de nombres. Tampoco es un parámetro por referencia (function (&$carry)) ni un retorno por referencia (function &()). La lista use no admite $this, variables superglobales ni nombres ya usados como parámetros.
Inicializa $carry antes de crear el cierre. El cierre puede seguir accediendo al estado capturado después de que termine la función que lo creó. Fuera del cierre, unset($carry) elimina el vínculo externo, no el estado que el cierre conserva; volver a asignar un valor al mismo nombre no restablece el vínculo. Usa referencias cuando quieras compartir estado mutable: la expresión de llamada por sí sola no indica que el cierre modifica $carry, pero después de la llamada se puede leer el valor actualizado de la variable externa $carry.
El parámetro $carry de la función de retorno de llamada de array_reduce() es distinto: primero recibe el valor inicial y luego el valor devuelto por esa función en la iteración anterior. Para una reducción sencilla, devuelve el acumulador actualizado en lugar de capturar una variable externa. La sintaxis use (&$carry) no requiere extensiones adicionales.
Ejemplos
<?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";
Resultado
2 0 15
`$add(2)` cambia el `$carry` externo a `2`. Después de que el código externo sume `10`, `$add(3)` lee `12` y escribe `15`. `$snapshot()` sigue devolviendo `0` porque capturó el valor al crearse.
Lecciones relacionadas
- PHP · Lección 15 · Avanzado · Versión: 2