CKTIS / PHP
Parametro passato per riferimento (`&$projects`)
Con `&$projects` una funzione può modificare la variabile del chiamante. Il simbolo `&` va nella dichiarazione del parametro, non nella chiamata.
Versione: PHP 8.3; extension availability may vary
Sintassi
function addProject(array &$projects, string $name): void { $projects[] = $name; }
addProject($activeProjects, 'Beacon');In PHP 8.3, array &$projects dichiara un parametro passato per riferimento. Durante la chiamata, $projects nella funzione e $activeProjects nel codice chiamante sono due nomi per lo stesso contenuto. Sia aggiungere un elemento con $projects[] = $name sia assegnare un nuovo array a $projects modifica la variabile del chiamante. La modifica resta visibile dopo la chiamata; void indica che la funzione non restituisce un risultato.
Scrivi & solo nella dichiarazione del parametro. Chiama addProject($activeProjects, 'Beacon') senza &. Passa una variabile inizializzata, non un array letterale come [], che in questa posizione provoca un errore. Puoi anche passare un riferimento restituito da una funzione; un normale valore di ritorno non sostituisce una variabile.
PHP controlla il tipo array all’ingresso nella funzione, non all’uscita. Se la variabile inizializzata non contiene un array, la chiamata genera un TypeError. La dichiarazione del parametro non garantisce però che la funzione lasci un array nella variabile.
Senza &, per impostazione predefinita l’argomento viene passato per valore: in questo esempio l’aggiunta modificherebbe solo l’array locale. Usa un riferimento quando vuoi modificare la variabile del chiamante e documenta questo effetto. Se la variabile deve rimanere invariata, passa l’array per valore e restituisci un array aggiornato.
Esempi
<?php
function addProject(array &$projects, string $name): void
{
$projects[] = $name;
}
$activeProjects = ['Atlas'];
echo implode(', ', $activeProjects), "\n";
addProject($activeProjects, 'Beacon');
echo implode(', ', $activeProjects), "\n";
Risultato
Atlas Atlas, Beacon
La prima riga mostra lo stato prima della chiamata. La seconda mostra che `Beacon` è stato aggiunto a `$activeProjects`, anche se `addProject()` non restituisce alcun risultato.
Lezioni correlate
- PHP · Lezione 12 · Intermedio · Versione: 3
- PHP · Lezione 13 · Intermedio · Versione: 3