CKTIS / PHP
Retorno por referencia: `function &getSession`
Una función que devuelve por referencia permite al código que la llama crear un alias de una variable. `=&` establece ese vínculo; `=` asigna el valor sin crearlo.
Versión: PHP 8.3; extension availability may vary
Sintaxis
function &getSession(): array { static $state = []; return $state; }
$alias = &getSession(); // Bind an alias to the returned variable.
$copy = getSession(); // Assign the array by value.En PHP 8.3, el & situado antes del nombre en function &getSession(): array indica un retorno por referencia. array especifica el tipo de retorno. Usa return $state; para indicar qué variable se devuelve, sin añadir & después de return. Un literal o el resultado de un cálculo no es una variable y no se puede devolver válidamente por referencia.
$alias = &getSession(); vincula otro nombre a la misma variable. Modificar $alias['visits'] cambia el array almacenado. En cambio, $copy = getSession(); asigna el array por valor, de modo que modificar $copy['visits'] no cambia el original. Esto no es pasar un argumento por referencia: el & de la declaración se aplica al resultado y =& vincula el alias en el código que llama a la función.
getSession() se define en el ejemplo y no es una API de sesiones integrada. Su variable local static conserva el valor entre llamadas durante la misma ejecución, pero no almacena datos entre peticiones. El ejemplo no requiere la extensión de sesiones. Para iniciar o reanudar manualmente una sesión real de PHP, debe estar disponible el soporte de sesiones y la llamada a session_start() debe tener éxito; los datos de sesión están disponibles en $_SESSION.
Devuelve una referencia solo si el código que llama a la función debe poder modificar directamente el estado subyacente, no para mejorar el rendimiento. Si hay que validar los cambios, ofrece una función de actualización independiente en lugar de un alias que permita escribir.
Ejemplos
<?php
function &getSession(): array
{
static $state = ['visits' => 1];
return $state;
}
$copy = getSession();
$alias = &getSession();
$alias['visits']++;
$copy['visits'] += 10;
$current = getSession();
echo 'Stored: ', $current['visits'], "\n";
echo 'Copy: ', $copy['visits'], "\n";
Resultado
Stored: 2 Copy: 11
El cambio a través del alias aumenta el `visits` almacenado a `2`. La copia se obtuvo antes, así que sumarle `10` da `11` sin cambiar el original.
Lecciones relacionadas
- PHP · Lección 25 · Intermedio · Versión: 3