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

CKTIS / PHP

Parametr předávaný odkazem (`&$projects`)

Zápis `&$projects` umožňuje funkci změnit proměnnou volajícího. Znak `&` patří do deklarace parametru, nikoli do volání funkce.

Verze: PHP 8.3; extension availability may vary

Syntaxe

function addProject(array &$projects, string $name): void { $projects[] = $name; }
addProject($activeProjects, 'Beacon');

V PHP 8.3 deklaruje zápis array &$projects parametr předávaný odkazem. Během volání jsou $projects uvnitř funkce a $activeProjects ve volajícím kódu dva názvy pro tentýž obsah. Přidání prvku pomocí $projects[] = $name i přiřazení celého nového pole do $projects změní proměnnou volajícího. Změna zůstane viditelná i po skončení funkce; void znamená, že funkce nevrací výsledek.

Znak & piš jen do deklarace parametru. Funkci volej jako addProject($activeProjects, 'Beacon'), bez &. Předej inicializovanou proměnnou místo literálu pole, jako je [], který je na tomto místě chybou. Předat lze i odkaz vrácený funkcí; běžná návratová hodnota proměnnou nenahradí.

PHP kontroluje typ array při vstupu do funkce, nikoli při jejím opuštění. Pokud inicializovaná proměnná neobsahuje pole, volání vyvolá TypeError. Deklarace parametru ale nezaručuje, že po skončení funkce bude v proměnné stále pole.

Bez & se argument standardně předává hodnotou: přidání prvku by v tomto příkladu změnilo jen lokální pole. Odkaz použij, pokud chceš proměnnou volajícího opravdu změnit, a tento účinek zdokumentuj. Má-li proměnná zůstat beze změny, předej pole hodnotou a vrať jeho upravenou verzi.

Příklady

<?php
function addProject(array &$projects, string $name): void
{
    $projects[] = $name;
}

$activeProjects = ['Atlas'];
echo implode(', ', $activeProjects), "\n";
addProject($activeProjects, 'Beacon');
echo implode(', ', $activeProjects), "\n";

Výsledek

Atlas
Atlas, Beacon

První řádek ukazuje stav před voláním. Druhý ukazuje, že se do `$activeProjects` přidal prvek `Beacon`, přestože `addProject()` nevrací žádný výsledek.

Související lekce

  • PHP · Lekce 12 · Středně pokročilá · Verze: 3
  • PHP · Lekce 13 · Středně pokročilá · Verze: 3

Zdroje