Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje