CKTIS / PHP
Parametr przekazywany przez referencję (`&$response`)
Zapis `&$response` pozwala funkcji zmienić zmienną przekazaną przez wywołującego. Znak `&` umieszcza się w deklaracji parametru, a nie w wywołaniu.
Wersja: PHP 8.3; extension availability may vary
Składnia
function setResponse(string &$response): void { /* Assign to $response here. */ }
setResponse($message);W PHP 8.3 znak & przed parametrem $response oznacza przekazywanie przez referencję. W wywołaniu setResponse($message) nazwy $response i $message odnoszą się do tej samej wartości. Przypisanie do $response jest więc widoczne w $message także po zakończeniu funkcji. Przy domyślnym przekazywaniu przez wartość takie przypisanie nie zmieniłoby $message.
Znak & wpisuje się tylko w deklaracji parametru, nie przy argumencie. Przekaż zmienną, na przykład $message. Wywołanie setResponse('pending') kończy się błędem, ponieważ literał nie jest zmienną. Można też przekazać wynik funkcji zwracającej przez referencję, ale nie należy w ten sposób przekazywać zwykłego wyniku funkcji.
$response to zwykła nazwa parametru, niezwiązana z HTTP. : void oznacza, że funkcja nie zwraca wartości; zmiana $message jest skutkiem ubocznym wywołania. Jeśli funkcja ma tylko dostarczyć jedną nową wartość, rozważ zwrócenie jej i jawne przypisanie po stronie wywołującego.
Przykłady
<?php
function setResponse(string &$response): void
{
$response = 'ready';
}
$message = 'pending';
echo "Before: $message\n";
setResponse($message);
echo "After: $message\n";
Wynik
Before: pending After: ready
Pierwszy wiersz pokazuje `pending`, a drugi `ready`. Wywołanie zmienia `$message`, mimo że funkcja nie zwraca wartości.
Powiązane lekcje
- PHP · Lekcja 26 · Średniozaawansowany · Wersja: 3