CKTIS / PHP
Parametro per riferimento `&$value` e passaggio per valore
In PHP 8.3, il parametro `&$value` consente alla funzione di modificare la variabile del chiamante. Con il passaggio per valore, che è il comportamento predefinito, assegnare al parametro non modifica quella variabile.
Versione: PHP 8.3; extension availability may vary
Sintassi
function addOneByReference(int &$value): void { $value += 1; }
$number = 5;
addOneByReference($number);Nella dichiarazione int &$value, & indica il passaggio per riferimento. Il parametro locale $value e la variabile del chiamante sono due nomi per lo stesso valore; un riferimento PHP non è un puntatore come in C. Un’assegnazione a $value aggiorna il valore visto dal chiamante e l’uscita dalla funzione non annulla la modifica.
Scrivi & nella dichiarazione, non nella chiamata: addOneByReference($number). Passa una variabile o il risultato di una funzione dichiarata esplicitamente per restituire per riferimento. Un letterale come 5 causa un errore; le espressioni ordinarie come $number + 1 non sono argomenti validi in questo caso. Un & prima del nome della funzione dichiara una restituzione per riferimento, non un parametro per riferimento.
Senza &, il passaggio avviene per valore: assegnare a $value ha effetto locale. Se l’argomento è un oggetto, le due variabili possono comunque identificare lo stesso oggetto. Una modifica alle sue proprietà può quindi essere visibile al chiamante, ma assegnare un altro oggetto al parametro non modifica la variabile del chiamante.
Con int &$value il tipo del parametro viene controllato all’ingresso nella funzione, non all’uscita. La sola dichiarazione non garantisce quindi che una comune variabile del chiamante sia ancora di tipo int dopo la chiamata. Usa & se modificare tale variabile fa parte del contratto della funzione e documenta l’effetto collaterale. Altrimenti, valuta di restituire il nuovo valore.
Esempi
<?php
declare(strict_types=1);
function addOneByValue(int $value): void
{
$value += 1;
}
function addOneByReference(int &$value): void
{
$value += 1;
}
$number = 5;
addOneByValue($number);
echo "by value: $number\n";
addOneByReference($number);
echo "by reference: $number\n";
Risultato
by value: 5 by reference: 6
Entrambe le funzioni eseguono `$value += 1`. Dopo la chiamata per valore, `$number` vale ancora `5`; dopo la chiamata per riferimento, vale `6`.
Lezioni correlate
- PHP · Lezione 77 · Avanzato · Versione: 2