CKTIS / PHP
Parametr tablicowy przekazywany przez referencję: `array &$product`
Zapis `array &$product` wymaga tablicy przy wywołaniu i pozwala funkcji zmienić zmienną w kodzie wywołującym bez zwracania tablicy.
Wersja: PHP 8.3; extension availability may vary
Składnia
function restock(array &$product): void { $product['stock'] += 2; }
// Call with an array variable containing a numeric 'stock' value, without &:
$item = ['stock' => 3];
restock($item);W sygnaturze function restock(array &$product): void słowo array określa typ wejściowy, & oznacza przekazanie przez referencję, a $product to lokalna nazwa parametru. Referencja dotyczy zmiennej przechowującej całą tablicę; nie sprawia, że jej elementy stają się referencjami.
Przed wywołaniem restock($item) przypisz do $item tablicę z wartością liczbową pod kluczem stock, na przykład ['stock' => 3]. Znak & umieszcza się w deklaracji, nie w wywołaniu. Literał tablicowy nie jest poprawnym argumentem dla tego parametru; funkcja zwracająca tablicę przez referencję może jednak dostarczyć taki argument.
$product i $item odnoszą się do tej samej wartości. Funkcja może zmienić element lub zastąpić całą tablicę, a efekt pozostaje widoczny po wywołaniu. : void oznacza brak wartości zwracanej, a nie brak skutków ubocznych. Bez & parametr jest przekazywany przez wartość i taka sama zmiana zwykłego elementu pozostaje lokalna; elementy będące już referencjami mogą jednak nadal być współdzielone.
PHP sprawdza typ array przy wejściu do funkcji i zgłasza TypeError, jeśli przekazana zmienna nie zawiera tablicy. Nie sprawdza kluczy, typów elementów ani ponownie typu parametru przy wyjściu. Pusta tablica przechodzi więc kontrolę typu, ale w PHP 8.3 próba odczytu brakującego klucza stock przez operator += powoduje ostrzeżenie. Jeśli modyfikujesz zwykłą zmienną, dbaj o to, by nadal zawierała tablicę, gdy tego oczekuje kod wywołujący.
Przykłady
<?php
function restock(array &$product): void
{
$product['stock'] += 2;
}
$item = ['stock' => 3];
echo $item['stock'], "\n";
restock($item);
echo $item['stock'], "\n";
Wynik
3 5
Wyjście to `3`, a następnie `5`. Funkcja dodaje `2` do `$product['stock']`, więc po wywołaniu `$item['stock']` wynosi `5`, mimo że funkcja nie zwraca wartości.
Powiązane lekcje
- PHP · Lekcja 20 · Zaawansowany · Wersja: 2