CKTIS / PHP
Parámetro pasado por referencia (`&$list`)
Colocar `&` delante de `$list` permite que una función de PHP modifique la variable de quien la llama. El signo se escribe en la declaración del parámetro, no junto al argumento en la llamada.
Versión: PHP 8.3
Sintaxis
<?php
function appendItem(array &$list, string $item): void
{
$list[] = $item;
}
$items = ['apple'];
appendItem($items, 'pear');En PHP 8.3, &$list declara un parámetro que se pasa por referencia. En appendItem($items, 'pear'), el nombre local $list se convierte en un alias del mismo contenido que $items. Una referencia de PHP no es un puntero a una dirección de memoria. $list es un nombre de parámetro ordinario, sin relación con la construcción list() de desestructuración.
La sintaxis de referencias, las operaciones con arrays y la función implode() que se usan en el ejemplo no requieren ninguna extensión opcional de PHP.
Escribe & delante del nombre del parámetro al declararlo, no delante del argumento al llamar a la función. Pasa una variable como $items; pasar un literal como ['apple'] a ese parámetro es un error. También es válido un resultado devuelto por referencia. Recibir un argumento por referencia no significa devolver un resultado por referencia.
$list[] = $item añade un elemento al array del llamador, y $list = [] lo reemplazaría por completo. Los cambios siguen siendo visibles después de la llamada. En cambio, unset($list) dentro de la función solo elimina el vínculo local, no $items. Sin &, el paso es por valor de forma predeterminada, por lo que la adición del ejemplo no modificaría $items.
En array &$list, PHP comprueba el tipo array al entrar en la función, no al salir. Pasar una variable que contiene un entero provoca un TypeError. void describe el valor de retorno, no la modificación del argumento. Usa referencias cuando quieras cambiar la variable del llamador y documenta ese efecto secundario, ya que no se ve en la llamada.
Ejemplos
<?php
function appendItem(array &$list, string $item): void
{
$list[] = $item;
}
$items = ['apple'];
appendItem($items, 'pear');
echo implode(', ', $items), "\n";
Resultado
apple, pear
Tras llamar a `appendItem()`, el script muestra `$items`, no un valor devuelto por la función. La línea esperada es `apple, pear`. Para comparar, quita solo `&` de la declaración del parámetro: la línea esperada pasa a ser `apple`.
Lecciones relacionadas
- PHP · Lección 20 · Intermedio · Versión: 3