CKTIS / PHP
Параметър от тип масив, предаван по референция: `array &$product`
`array &$product` изисква масив при извикване и позволява на функцията да промени променливата в извикващия код, без да връща масива.
Версия: PHP 8.3; extension availability may vary
Синтаксис
function restock(array &$product): void { $product['stock'] += 2; }
// Call with an array variable containing a numeric 'stock' value, without &:
$item = ['stock' => 3];
restock($item);В function restock(array &$product): void array задава входния тип, & означава предаване по референция, а $product е локалното име на параметъра. Референцията се отнася за променливата, която съдържа целия масив; тя не превръща елементите на масива в референции.
Преди да извикаш restock($item), присвои на $item масив с числова стойност за ключа stock, например ['stock' => 3]. Знакът & се пише в декларацията, а не при извикването. Литерал за масив не е валиден аргумент за този параметър, но функция, която връща масив по референция, може да предостави валиден аргумент.
$product и $item се отнасят до една и съща стойност. Функцията може да промени елемент или да замени целия масив, като промяната остава видима след извикването. : void означава, че няма върната стойност, а не че няма странични ефекти. Без & аргументът се предава по стойност и същата промяна на обикновен елемент остава локална; елементите, които вече са референции, обаче могат да останат споделени.
PHP проверява типа array при влизане във функцията и хвърля TypeError, ако подадената променлива не съдържа масив. Не проверява ключовете или типовете на елементите и не проверява повторно типа на параметъра при излизане. Затова празен масив преминава проверката на типа, но PHP 8.3 извежда предупреждение, когато операторът += се опита да прочете стойността за липсващия ключ stock. Когато променяш обикновена променлива, остави я да съдържа масив, ако извикващият код очаква това.
Примери
<?php
function restock(array &$product): void
{
$product['stock'] += 2;
}
$item = ['stock' => 3];
echo $item['stock'], "\n";
restock($item);
echo $item['stock'], "\n";
Резултат
3 5
Изходът е първо `3`, след това `5`. Функцията добавя `2` към `$product['stock']`, затова след извикването `$item['stock']` е `5`, въпреки че функцията не връща стойност.
Свързани уроци
- PHP · Урок 20 · Напреднало · Версия: 2