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

CKTIS / PHP

Parámetro por referencia `&$value` frente al paso por valor

En PHP 8.3, el parámetro `&$value` permite que la función modifique la variable de quien la llama. Con el paso por valor, que es el modo predeterminado, asignar al parámetro no modifica esa variable.

Versión: PHP 8.3; extension availability may vary

Sintaxis

function addOneByReference(int &$value): void { $value += 1; }
$number = 5;
addOneByReference($number);

En la declaración int &$value, & indica que el argumento se pasa por referencia. El parámetro local $value y la variable de quien llama son dos nombres para el mismo valor; una referencia en PHP no es un puntero como en C. Asignar a $value actualiza el valor que ve quien llama, y salir de la función no deshace el cambio.

Escribe & en la declaración, no en la llamada: addOneByReference($number). Pasa una variable o el resultado de una función que devuelva explícitamente por referencia. Un literal como 5 provoca un error; las expresiones ordinarias, como $number + 1, no son argumentos válidos aquí. Un & delante del nombre de la función declara un retorno por referencia, no un parámetro por referencia.

Sin &, el paso es por valor: una asignación a $value queda en el ámbito local. Si el argumento es un objeto, ambas variables pueden seguir identificando el mismo objeto. Por tanto, un cambio en sus propiedades puede ser visible para quien llama, pero asignar otro objeto al parámetro no modifica la variable original.

En int &$value se comprueba el tipo del parámetro al entrar en la función, no al salir. La declaración por sí sola no garantiza que una variable ordinaria de quien llama siga siendo de tipo int después. Usa & cuando modificar esa variable forme parte del contrato de la función y documenta el efecto secundario. En caso contrario, considera devolver el valor nuevo.

Ejemplos

<?php
declare(strict_types=1);

function addOneByValue(int $value): void
{
    $value += 1;
}

function addOneByReference(int &$value): void
{
    $value += 1;
}

$number = 5;
addOneByValue($number);
echo "by value: $number\n";

addOneByReference($number);
echo "by reference: $number\n";

Resultado

by value: 5
by reference: 6

Las dos funciones ejecutan `$value += 1`. Tras la llamada por valor, `$number` sigue valiendo `5`; tras la llamada por referencia, vale `6`.

Lecciones relacionadas

  • PHP · Lección 77 · Avanzado · Versión: 2

Fuentes