Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes