CKTIS / PHP
Referenčný parameter `&$value` a odovzdávanie hodnotou
V PHP 8.3 umožňuje parameter `&$value` funkcii zmeniť premennú volajúceho. Pri predvolenom odovzdávaní hodnotou priradenie do parametra túto premennú nezmení.
Verzia: PHP 8.3; extension availability may vary
Syntax
function addOneByReference(int &$value): void { $value += 1; }
$number = 5;
addOneByReference($number);V deklarácii int &$value označuje & odovzdanie odkazom. Lokálny parameter $value a premenná volajúceho sú dva názvy tej istej hodnoty; referencia v PHP nie je ukazovateľ ako v C. Priradenie do $value zmení hodnotu u volajúceho a návrat z funkcie túto zmenu nezruší.
Znak & patrí do deklarácie, nie do volania: addOneByReference($number). Odovzdaj premennú alebo výsledok funkcie, ktorá výslovne vracia odkaz. Literál 5 spôsobí chybu; bežné výrazy ako $number + 1 tu nie sú platnými argumentmi. Znak & pred názvom funkcie označuje vrátenie odkazom, nie referenčný parameter.
Bez & sa argument odovzdáva hodnotou: priradenie do $value má iba lokálny účinok. Ak je argumentom objekt, obe premenné môžu naďalej označovať ten istý objekt. Zmena jeho vlastností preto môže byť viditeľná u volajúceho, ale priradenie iného objektu do parametra nezmení premennú volajúceho.
Pri int &$value sa typ parametra kontroluje pri vstupe do funkcie, nie pri návrate. Samotná deklarácia teda nezaručuje, že bežná premenná volajúceho bude aj po volaní typu int. Použi &, ak je zmena tejto premennej súčasťou dohodnutého správania funkcie, a zdokumentuj tento vedľajší účinok. Inak zváž vrátenie novej hodnoty.
Prí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ýsledok
by value: 5 by reference: 6
Obe funkcie vykonajú `$value += 1`. Po volaní s odovzdaním hodnotou má `$number` stále hodnotu `5`; po volaní s odovzdaním odkazom má hodnotu `6`.
Súvisiace lekcie
- PHP · Lekcia 77 · Pokročilá · Verzia: 2