PHP-Optionen-/-Informationen-Funktionen
PHP-Handbuch

getenv

Liefert den Wert einer Umgebungsvariable

Beschreibung

string getenv ( string $varname [, bool $local_only = false ] )

Liefert den Wert einer Umgebungsvariable.

Eine Liste aller Umgebungsvariablen können Sie über die Funktion phpinfo anzeigen lassen. Die Bedeutung vieler dieser Variablen können Sie in der » RFC 3875 im Abschnitt 4.1 "Request Meta-Variables" nachlesen.

Parameter-Liste

varname

Der Variablenname

local_only

Bei TRUE werden nur lokale Umgebungsvariablen, die vom Betriebsystem oder durch putenv gesetzt wurden, zurückgeliefert.

Rückgabewerte

Gibt den Wert der Umgebungsvariable varname zurück oder FALSE, wenn die Umgebungsvariable varname nicht existiert.

Changelog

Version Beschreibung
5.5.38, 5.6.24, 7.0.9 Der local_only Parameter wurde hinzugefügt.

Anmerkungen

Warnung

Wird PHP in einer SAPI wie Fast CGI ausgeführt, liefert diese Funktion immer den Wert einer Umgebungsvariablen, die von der SAPI gesetzt wurde, zurück, selbst wenn putenv verwendet wurde, um eine lokale Umgebungsvariable mit dem selben Namen zu setzen. Verwenden Sie local_only, um den Wert einer lokal gesetzten Umgebungsvariable zurück zu liefern.

Beispiele

Beispiel #1 getenv-Beispiel

<?php
// nutzen Sie getenv() ...
$ip = getenv('REMOTE_ADDR');

// ... oder einfach die superglobalen Arrays ($_SERVER oder $_ENV)
$ip = $_SERVER['REMOTE_ADDR'];

// Sicheres Lesen eines Wertes einer Umgebungsvariablen, wobei ignoriert wird,
// ob sie durch die SAPI gesetzt oder durch putenv geändert wurde
$ip = getenv('REMOTE_ADDR', true) ?: getenv('REMOTE_ADDR')
?>

Siehe auch