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

CKTIS / PHP

Parámetro pasado por referencia (`&$projects`)

Con `&$projects`, una función puede modificar la variable del código que la llama. El `&` se escribe en la declaración del parámetro, no en la llamada.

Versión: PHP 8.3; extension availability may vary

Sintaxis

function addProject(array &$projects, string $name): void { $projects[] = $name; }
addProject($activeProjects, 'Beacon');

En PHP 8.3, array &$projects declara un parámetro pasado por referencia. Durante la llamada, $projects dentro de la función y $activeProjects en el código que la llama son dos nombres para el mismo contenido. Tanto añadir un elemento con $projects[] = $name como asignar un array nuevo a $projects modifica la variable del código que llama. El cambio sigue siendo visible después de la llamada; void indica que la función no devuelve un resultado.

Escribe & solo en la declaración del parámetro. Llama a addProject($activeProjects, 'Beacon') sin &. Pasa una variable inicializada en lugar de un literal de array como [], que provoca un error en esa posición. También puedes pasar una referencia devuelta por una función; un valor de retorno normal no sustituye a una variable.

PHP comprueba el tipo array al entrar en la función, no al salir. Si la variable inicializada no contiene un array, la llamada lanza un TypeError. No obstante, la declaración del parámetro no garantiza que la función deje un array en la variable.

Sin &, el argumento se pasa por valor de forma predeterminada: en este ejemplo, la adición solo modificaría el array local. Usa una referencia cuando quieras modificar la variable del código que llama y documenta ese efecto. Si la variable debe mantenerse intacta, pasa el array por valor y devuelve un array actualizado.

Ejemplos

<?php
function addProject(array &$projects, string $name): void
{
    $projects[] = $name;
}

$activeProjects = ['Atlas'];
echo implode(', ', $activeProjects), "\n";
addProject($activeProjects, 'Beacon');
echo implode(', ', $activeProjects), "\n";

Resultado

Atlas
Atlas, Beacon

La primera línea muestra el estado antes de la llamada. La segunda muestra que se añadió `Beacon` a `$activeProjects`, aunque `addProject()` no devuelve ningún resultado.

Lecciones relacionadas

  • PHP · Lección 12 · Intermedio · Versión: 3
  • PHP · Lección 13 · Intermedio · Versión: 3

Fuentes