(PHP 4, PHP 5, PHP 7)
getenv — Liefert den Wert einer Umgebungsvariable
$varname
[, bool $local_only = FALSE
] ) : stringLiefert 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.
varnameDer Variablenname
local_only
Bei TRUE werden nur lokale Umgebungsvariablen, die vom Betriebsystem
oder durch putenv gesetzt wurden, zurückgeliefert.
Gibt den Wert der Umgebungsvariable varname
zurück oder FALSE, wenn die Umgebungsvariable
varname nicht existiert.
Wird varname ausgelassen, werden alle
Umgebungsvariablen als assoziatives Array zurückgegeben.
| Version | Beschreibung |
|---|---|
| 7.1.0 |
Der Parameter varname kann nun ausgelassen werden,
um ein assoziatives Array aller Umgebungsvariablen abzurufen.
|
| 5.5.38, 5.6.24, 7.0.9 |
Der local_only Parameter wurde hinzugefügt.
|
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.
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')
?>