Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti