CKTIS / PHP
Parametro passato per riferimento (&$users)
Il simbolo `&` prima del parametro `$users` permette alla funzione di modificare la variabile del chiamante senza restituire l’array. Nella chiamata la variabile si passa senza `&`.
Versione: PHP 8.3; extension availability may vary
Sintassi
function addUser(array &$users, string $name): void { $users[] = $name; }
$users = ['Ada'];
addUser($users, 'Lin');In array &$users, array indica il tipo dell’argomento e & indica il passaggio per riferimento. Il parametro locale e la variabile del chiamante sono due nomi per lo stesso valore. Qui & non indica né un puntatore né un operatore AND bit a bit, e la funzione non restituisce un riferimento.
Chiama addUser($users, 'Lin') senza & e passa una variabile inizializzata. È valido anche un riferimento restituito da una funzione, ma non un array letterale: addUser(['Ada'], 'Lin') genera un Error. PHP controlla il tipo array all’ingresso della funzione, non all’uscita. Passare una variabile che contiene una stringa genera un TypeError.
$users[] = $name aggiunge un elemento in coda, mentre una normale assegnazione come $users = [] sostituirebbe l’intero valore della variabile del chiamante. La modifica resta visibile dopo la chiamata anche se la funzione non restituisce alcun valore (void). Senza &, l’array è passato per valore per impostazione predefinita e, nell’esempio, l’aggiunta modifica solo l’array locale.
Usa & quando intendi modificare la variabile del chiamante e documenta questo effetto, perché non è visibile nella chiamata. Se deve essere il chiamante a decidere se sostituire il proprio array, ricevilo per valore e restituisci l’array modificato.
Esempi
<?php
function addUser(array &$users, string $name): void
{
$users[] = $name;
}
$users = ['Ada'];
echo implode(', ', $users), "\n";
addUser($users, 'Lin');
echo implode(', ', $users), "\n";
Risultato
Ada Ada, Lin
L’esempio usa PHP 8.3 da riga di comando e non richiede estensioni facoltative. L’output atteso è `Ada` prima della chiamata e `Ada, Lin` dopo. Rimuovendo solo `&` dalla dichiarazione, l’output atteso è `Ada` su entrambe le righe.
Lezioni correlate
- PHP · Lezione 28 · Intermedio · Versione: 3