CKTIS / PHP
Parametr předávaný odkazem (`&$response`)
Zápis `&$response` umožňuje funkci v PHP změnit proměnnou volajícího. Znak `&` patří do deklarace parametru, nikoli do volání funkce.
Verze: PHP 8.3; extension availability may vary
Syntaxe
function setResponse(string &$response): void { /* Assign to $response here. */ }
setResponse($message);V PHP 8.3 označuje znak & před $response předávání odkazem. Při volání setResponse($message) označují $response a $message tutéž uloženou hodnotu. Přiřazení do $response se proto projeví v $message i po skončení funkce. Při výchozím předávání hodnotou by toto přiřazení $message nezměnilo.
Znak & zapisuj jen do deklarace parametru, ne před argument. Předej proměnnou, například $message. Volání setResponse('pending') vyvolá chybu, protože literál není proměnná. Předat lze také výsledek funkce, která vrací odkaz. Běžný výsledek funkce takto nepředávej.
$response je obyčejný název parametru bez souvislosti s HTTP. : void znamená, že funkce nevrací hodnotu; změna $message je vedlejším účinkem volání. Pokud má funkce pouze vytvořit jednu novou hodnotu, zvaž její vrácení a výslovné přiřazení ve volajícím kódu.
Příklady
<?php
function setResponse(string &$response): void
{
$response = 'ready';
}
$message = 'pending';
echo "Before: $message\n";
setResponse($message);
echo "After: $message\n";
Výsledek
Before: pending After: ready
První řádek vypíše `pending`, druhý `ready`. Volání změní `$message`, i když funkce nevrací žádnou hodnotu.
Související lekce
- PHP · Lekce 26 · Středně pokročilá · Verze: 3