getenv()
getenv
Hämtar värdet av en specifik miljövariabel eller alla miljövariabler.
Beskrivning
getenv(?string $name = null, bool $local_only = false): string|array|false
Returnerar värdet av en enskild miljövariabel eller alla miljövariabler som en associativ array.
Du kan visa en lista över alla miljövariabler genom att använda phpinfo(). Många av dessa variabler listas i RFC 3875, särskilt avsnitt 4.1, "Request Meta-Variables".
Parametrar
- name (valfri)
- Variabelnamnet som en sträng eller null.
- local_only
- När det är satt till true, returneras endast lokala miljövariabler som har satts av operativsystemet eller putenv(). Denna parameter har endast effekt om name är en sträng.
Returneringsvärde
Returnerar värdet av miljövariabeln name, eller false om variabeln inte existerar. Om name är null returneras alla miljövariabler som en associativ array.
Exempel
Exempel #1: Användning av getenv() <syntaxhighlight lang="php"> <?php // Exempel på användning av getenv() $ip = getenv('REMOTE_ADDR');
// Eller använd en Superglobal ($_SERVER eller $_ENV) $ip = $_SERVER['REMOTE_ADDR'];
// Hämta värdet på ett säkert sätt, oavsett om det satts av en SAPI eller ändrats med putenv() $ip = getenv('REMOTE_ADDR', true) ?: getenv('REMOTE_ADDR'); ?> </syntaxhighlight>
Noteringar
- Varning:
- Om PHP körs i en SAPI som Fast CGI, kommer denna funktion alltid returnera värdet av en miljövariabel som satts av SAPI:n, även om putenv() har använts för att sätta en lokal miljövariabel med samma namn. Använd parameter local_only för att returnera värdet av lokalt satta miljövariabler.
Se även
- putenv() - Sätter värdet av en miljövariabel
- apache_getenv() - Hämtar en Apache subprocess_env-variabel
- Superglobals - Information om superglobala variabler