CKTIS / PHP
Parametro array passato per riferimento: `array &$product`
`array &$product` richiede un array alla chiamata e consente alla funzione di modificare la variabile del chiamante senza restituire l’array.
Versione: PHP 8.3; extension availability may vary
Sintassi
function restock(array &$product): void { $product['stock'] += 2; }
// Call with an array variable containing a numeric 'stock' value, without &:
$item = ['stock' => 3];
restock($item);In function restock(array &$product): void, array dichiara il tipo in ingresso, & indica il passaggio per riferimento e $product è il nome locale del parametro. Il riferimento riguarda la variabile che contiene l’intero array; non trasforma i suoi elementi in riferimenti.
Prima di chiamare restock($item), assegna a $item un array con un valore numerico associato alla chiave stock, ad esempio ['stock' => 3]. Il simbolo & va nella dichiarazione, non nella chiamata. Un letterale di tipo array non è un argomento valido per questo parametro; può invece fornirne uno una funzione che restituisce un array per riferimento.
$product e $item fanno riferimento allo stesso valore. La funzione può modificare un elemento o sostituire l’intero array, e la modifica resta visibile dopo la chiamata. : void indica che non c’è un valore di ritorno, non che non ci siano effetti collaterali. Senza &, il passaggio avviene per valore e la stessa modifica a un elemento ordinario rimane locale; gli elementi che sono già riferimenti possono però restare condivisi.
PHP verifica il tipo array all’ingresso nella funzione e genera un TypeError se la variabile fornita non contiene un array. Non verifica le chiavi né i tipi degli elementi e non ricontrolla il tipo del parametro all’uscita. Un array vuoto supera quindi il controllo del tipo, ma PHP 8.3 emette un avviso quando += tenta di leggere la chiave stock, che non esiste. Se modifichi una normale variabile, lascia che contenga ancora un array quando il codice chiamante se lo aspetta.
Esempi
<?php
function restock(array &$product): void
{
$product['stock'] += 2;
}
$item = ['stock' => 3];
echo $item['stock'], "\n";
restock($item);
echo $item['stock'], "\n";
Risultato
3 5
L’output mostra prima `3`, poi `5`. La funzione aggiunge `2` a `$product['stock']`, quindi dopo la chiamata `$item['stock']` vale `5`, anche se la funzione non restituisce alcun valore.
Lezioni correlate
- PHP · Lezione 20 · Avanzato · Versione: 2