База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / PHP

Параметър по референция `&$value` и предаване по стойност

В PHP 8.3 параметърът `&$value` позволява на функцията да промени променлива на извикващия код. При стандартното предаване по стойност присвояването на параметъра не променя тази променлива.

Версия: PHP 8.3; extension availability may vary

Синтаксис

function addOneByReference(int &$value): void { $value += 1; }
$number = 5;
addOneByReference($number);

В декларацията int &$value знакът & означава предаване по референция. Локалният параметър $value и променливата на извикващия код са две имена за една и съща стойност; референцията в PHP не е указател като в C. Присвояването на $value променя стойността в извикващия код, а излизането от функцията не отменя промяната.

Поставяй & в декларацията, а не в извикването: addOneByReference($number). Предай променлива или резултата от функция, която изрично връща по референция. Литерал като 5 причинява грешка; обикновени изрази като $number + 1 не са валидни аргументи тук. Знакът & пред името на функцията означава връщане по референция, а не параметър по референция.

Без & аргументът се предава по стойност: присвояването на $value остава локално. Ако аргументът е обект, двете променливи все пак могат да обозначават един и същ обект. Промяната на неговите свойства може да се вижда в извикващия код, но присвояването на друг обект на параметъра не променя променливата там.

При int &$value типът на параметъра се проверява при влизане във функцията, а не при излизане. Самата декларация не гарантира, че обикновена променлива на извикващия код ще остане от тип int след извикването. Използвай &, когато промяната на тази променлива е част от договора на функцията, и документирай този страничен ефект. В противен случай обмисли връщане на новата стойност.

Примери

<?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";

Резултат

by value: 5
by reference: 6

И двете функции изпълняват `$value += 1`. След извикването с предаване по стойност `$number` остава `5`; след извикването с предаване по референция стойността е `6`.

Свързани уроци

  • PHP · Урок 77 · Напреднало · Версия: 2

Източници