Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

Restituzione per riferimento: `function &getSession`

Una funzione che restituisce per riferimento permette al chiamante di creare un alias di una variabile. `=&` crea il legame; `=` assegna il valore senza creare l’alias.

Versione: PHP 8.3; extension availability may vary

Sintassi

function &getSession(): array { static $state = []; return $state; }
$alias = &getSession(); // Bind an alias to the returned variable.
$copy = getSession();   // Assign the array by value.

In PHP 8.3, il simbolo & prima del nome in function &getSession(): array indica una restituzione per riferimento. array specifica il tipo restituito. Usa return $state; per indicare la variabile, senza aggiungere & dopo return. Un valore letterale o il risultato di un calcolo non è una variabile e non può essere restituito validamente per riferimento.

$alias = &getSession(); associa un altro nome alla stessa variabile. Modificare $alias['visits'] cambia l’array memorizzato. Invece, $copy = getSession(); assegna l’array per valore, quindi modificare $copy['visits'] non cambia l’originale. Non si tratta di passare un argomento per riferimento: il simbolo & nella dichiarazione riguarda il risultato, mentre =& collega l’alias nel codice chiamante.

getSession() è definita nell’esempio e non è un’API di sessione integrata. La sua variabile locale static conserva il valore tra chiamate nella stessa esecuzione, ma non memorizza dati tra richieste. L’esempio non richiede l’estensione per le sessioni. Per avviare o riprendere manualmente una vera sessione PHP, occorre il supporto delle sessioni e la chiamata a session_start() deve riuscire; i dati della sessione sono disponibili in $_SESSION.

Restituisci un riferimento solo se il chiamante deve poter modificare direttamente lo stato sottostante, non per migliorare le prestazioni. Se occorre convalidare le modifiche, esponi una funzione di aggiornamento separata invece di un alias che consenta la scrittura.

Esempi

<?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";

Risultato

Stored: 2
Copy: 11

La modifica tramite l’alias porta il valore memorizzato di `visits` a `2`. La copia è stata ottenuta prima, quindi aggiungervi `10` dà `11` senza modificare l’originale.

Lezioni correlate

  • PHP · Lezione 25 · Intermedio · Versione: 3

Fonti