CKTIS / PHP
Parametro passato per riferimento (`&$list`)
Il simbolo `&` prima di `$list` permette a una funzione PHP di modificare la variabile del chiamante. Si scrive nella dichiarazione del parametro, non accanto all’argomento nella chiamata.
Versione: PHP 8.3
Sintassi
<?php
function appendItem(array &$list, string $item): void
{
$list[] = $item;
}
$items = ['apple'];
appendItem($items, 'pear');In PHP 8.3, &$list dichiara un parametro passato per riferimento. Nella chiamata appendItem($items, 'pear'), il nome locale $list diventa un alias dello stesso contenuto di $items. Un riferimento PHP non è un puntatore a un indirizzo di memoria. $list è un normale nome di parametro, distinto dal costrutto list() usato per la destrutturazione.
La sintassi dei riferimenti, le operazioni sugli array e la funzione implode() usate nell’esempio non richiedono estensioni PHP facoltative.
Scrivi & davanti al nome del parametro nella dichiarazione, non davanti all’argomento nella chiamata. Passa una variabile come $items: fornire un letterale come ['apple'] a quel parametro è un errore. È valido anche un risultato restituito per riferimento. Ricevere un argomento per riferimento non implica restituire per riferimento.
$list[] = $item aggiunge un elemento all’array del chiamante, mentre $list = [] sostituirebbe l’intero array. Le modifiche restano visibili dopo la chiamata. Al contrario, unset($list) all’interno della funzione rimuove solo il legame locale, non $items. Senza & il passaggio avviene per valore, quindi l’aggiunta mostrata non modificherebbe $items.
In array &$list, PHP controlla il tipo array all’ingresso nella funzione, non all’uscita: passare una variabile che contiene un intero causa un TypeError. void riguarda il valore restituito, non la modifica dell’argomento. Usa i riferimenti quando vuoi modificare la variabile del chiamante e documenta questo effetto collaterale, perché non è visibile nella chiamata.
Esempi
<?php
function appendItem(array &$list, string $item): void
{
$list[] = $item;
}
$items = ['apple'];
appendItem($items, 'pear');
echo implode(', ', $items), "\n";
Risultato
apple, pear
Dopo la chiamata a `appendItem()`, lo script stampa `$items`, non un valore restituito dalla funzione. La riga attesa è `apple, pear`. Per confronto, rimuovi solo `&` dalla dichiarazione del parametro: la riga attesa diventa `apple`.
Lezioni correlate
- PHP · Lezione 20 · Intermedio · Versione: 3