CKTIS / PHP
Referenční parametr `&$value` a předávání hodnotou
V PHP 8.3 umožňuje parametr `&$value` funkci změnit proměnnou volajícího. Při výchozím předávání hodnotou přiřazení do parametru tuto proměnnou nezmění.
Verze: PHP 8.3; extension availability may vary
Syntaxe
function addOneByReference(int &$value): void { $value += 1; }
$number = 5;
addOneByReference($number);V deklaraci int &$value značí & předávání odkazem. Lokální parametr $value a proměnná volajícího jsou dvě jména pro tutéž hodnotu; reference v PHP není ukazatel jako v C. Přiřazení do $value změní hodnotu u volajícího a návrat z funkce tuto změnu nevrátí zpět.
Znak & patří do deklarace, ne do volání: addOneByReference($number). Předej proměnnou nebo výsledek funkce, která výslovně vrací odkaz. Literál 5 způsobí chybu; běžné výrazy jako $number + 1 zde nejsou platnými argumenty. Znak & před názvem funkce označuje návrat odkazem, nikoli referenční parametr.
Bez & se argument předává hodnotou: přiřazení do $value zůstává lokální. Je-li argumentem objekt, obě proměnné mohou stále označovat tentýž objekt. Změna jeho vlastností tedy může být u volajícího viditelná, ale přiřazení jiného objektu do parametru proměnnou volajícího nezmění.
U int &$value se typ parametru kontroluje při vstupu do funkce, ne při návratu. Samotná deklarace tedy nezaručuje, že běžná proměnná volajícího bude i po volání typu int. Použij &, pokud změna této proměnné patří k deklarovanému chování funkce, a tento vedlejší účinek popiš. Jinak zvaž vrácení nové hodnoty.
Příklady
<?php
declare(strict_types=1);
function addOneByValue(int $value): void
{
$value += 1;
}
function addOneByReference(int &$value): void
{
$value += 1;
}
$number = 5;
addOneByValue($number);
echo "by value: $number\n";
addOneByReference($number);
echo "by reference: $number\n";
Výsledek
by value: 5 by reference: 6
Obě funkce provedou `$value += 1`. Po volání s předáním hodnotou je `$number` stále `5`; po volání s předáním odkazem je `6`.
Související lekce
- PHP · Lekce 77 · Pokročilá · Verze: 2