KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

Referentieparameter (`&$projects`)

Met `&$projects` kan een functie de variabele van de aanroepende code wijzigen. De `&` staat in de parameterdeclaratie, niet in de aanroep.

Versie: PHP 8.3; extension availability may vary

Syntax

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

In PHP 8.3 declareert array &$projects een parameter die door verwijzing wordt doorgegeven. Tijdens de aanroep zijn $projects in de functie en $activeProjects in de aanroepende code twee namen voor dezelfde inhoud. Zowel een element toevoegen met $projects[] = $name als een hele nieuwe array toewijzen aan $projects wijzigt de variabele in de aanroepende code. De wijziging blijft na de aanroep zichtbaar; void betekent dat de functie geen resultaat teruggeeft.

Zet & alleen in de parameterdeclaratie. Roep addProject($activeProjects, 'Beacon') zonder & aan. Geef een geïnitialiseerde variabele door in plaats van een arrayliteral zoals [], want die veroorzaakt hier een fout. Je kunt ook een verwijzing doorgeven die een functie teruggeeft; een gewone retourwaarde is geen vervanging voor een variabele.

PHP controleert het type array bij het binnengaan van de functie, niet bij het verlaten ervan. Bevat de geïnitialiseerde variabele geen array, dan gooit de aanroep een TypeError. De parameterdeclaratie garandeert echter niet dat de functie een array in de variabele achterlaat.

Zonder & wordt het argument standaard op waarde doorgegeven. De toevoeging zou in dit voorbeeld dus alleen de lokale array wijzigen. Gebruik een verwijzing als je de variabele in de aanroepende code bewust wilt wijzigen en documenteer dat effect. Moet die variabele ongewijzigd blijven, geef de array dan op waarde door en retourneer een bijgewerkte array.

Voorbeelden

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

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

Resultaat

Atlas
Atlas, Beacon

De eerste regel toont de toestand vóór de aanroep. De tweede laat zien dat `Beacon` aan `$activeProjects` is toegevoegd, hoewel `addProject()` geen resultaat teruggeeft.

Gerelateerde lessen

  • PHP · Les 12 · Gemiddeld · Versie: 3
  • PHP · Les 13 · Gemiddeld · Versie: 3

Bronnen