CKTIS / PHP
Parámetro pasado por referencia: &$session
Al poner `&` delante de `$session`, la función puede modificar directamente el array de quien la llama. El parámetro no inicia una sesión de PHP ni guarda sus datos.
Versión: PHP 8.3; extension availability may vary
Sintaxis
function recordVisit(array &$session): void { /* update $session */ }
recordVisit($state);En PHP 8.3, con array &$session, el nombre local $session y la variable que se pasa en la llamada hacen referencia al mismo valor. Modificar un elemento o sustituir todo el array afecta a la variable original, aunque la función tenga tipo de retorno void. Sin &, un array normal se pasa por valor de forma predeterminada, así que esos cambios son locales.
Pon & en la declaración del parámetro, no en la llamada: recordVisit($state). Pasa una variable, no un literal de array como []. El tipo array se comprueba al entrar en la función, no al salir; un argumento de tipo incorrecto provoca un TypeError.
$session es solo el nombre de un parámetro, no la superglobal $_SESSION. Si la extensión de sesiones está disponible, puedes llamar a recordVisit($_SESSION) después de que session_start() se complete correctamente. El mecanismo de sesiones de PHP guarda los datos, no &; no des por hecho que los vínculos de referencia se restaurarán entre peticiones. El ejemplo de consola no necesita la extensión.
Ejemplos
<?php
function recordVisit(array &$session): void
{
$session['visits'] = ($session['visits'] ?? 0) + 1;
}
$state = [];
recordVisit($state);
echo $state['visits'], "\n";
recordVisit($state);
echo $state['visits'], "\n";
Resultado
1 2
El array normal `$state` empieza vacío. Su contador vale `1` tras la primera llamada y `2` tras la segunda; no se inicia ninguna sesión de PHP.
Lecciones relacionadas
- PHP · Lección 25 · Intermedio · Versión: 3