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()

<?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');
?>

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