CKTIS / PHP
Parámetro de tipo array pasado por referencia: `array &$items`
`array &$items` exige un array al iniciar la llamada y permite que la función modifique la variable de quien la llama sin devolver un resultado.
Versión: PHP 8.3; extension availability may vary
Sintaxis
function markReady(array &$items): void { $items[0] = 'ready'; }
$cart = ['draft'];
markReady($cart);En function markReady(array &$items): void, array declara el tipo de entrada, $items es el nombre local del parámetro y & indica el paso por referencia. El parámetro es un alias de la variable de quien llama a la función: tanto escribir en $items[0] como asignar un nuevo valor a $items tiene un efecto visible fuera de la función, incluso con : void.
Inicializa una variable con un array y llama a markReady($cart). El & se escribe en la declaración, no en la llamada. No pases directamente un literal como ['draft'] ni un resultado ordinario devuelto por valor; sí puedes pasar un resultado devuelto por referencia. Si la variable proporcionada no contiene un array, PHP lanza TypeError al entrar en la función. El tipo no vuelve a comprobarse al salir, de modo que una asignación mediante $items puede incluso cambiar el tipo de una variable ordinaria de quien hizo la llamada.
Sin &, array $items se pasa por valor: sustituir un elemento que contiene una cadena normal, como en el ejemplo, no modifica el array original. No es una copia profunda: las referencias que ya existan dentro del array pueden seguir compartiendo valores. Si modificar el argumento no forma parte del contrato de la función, recibe el array por valor y devuelve el resultado explícitamente.
unset($items) elimina el vínculo local, no la variable de quien llama. En cambio, foreach ($items as &$item) crea una referencia distinta a un elemento. Usa unset($item) después de ese bucle para que una escritura posterior en $item no sobrescriba el último elemento recorrido.
Ejemplos
<?php
function markReadyCopy(array $items): void
{
$items[0] = 'ready';
}
function markReady(array &$items): void
{
$items[0] = 'ready';
}
$cart = ['draft'];
markReadyCopy($cart);
echo $cart[0], "\n";
markReady($cart);
echo $cart[0], "\n";
Resultado
draft ready
Ambas funciones escriben `ready` en el índice `0`. Tras la llamada por valor, `$cart[0]` sigue conteniendo `draft`; tras la llamada por referencia, contiene `ready`.
Lecciones relacionadas
- PHP · Lección 19 · Avanzado · Versión: 2