getenv
(PHP 4, PHP 5, PHP 7, PHP 8)
getenv — Liefert den Wert einer Umgebungsvariable
Beschreibung
$varname, bool $local_only = false): string|falseGibt den Wert einer Umgebungsvariable zurück.
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
truewerden nur lokale Umgebungsvariablen zurückgegeben, die vom Betriebsystem oder durch putenv() gesetzt wurden.
Rückgabewerte
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.
Changelog
| Version | Beschreibung |
|---|---|
| 7.1.0 |
Der Parameter varname kann nun ausgelassen
werden, um ein assoziatives Array aller Umgebungsvariablen abzurufen.
|
| 7.0.9 |
Der Parameter local_only wurde hinzugefügt.
|
Beispiele
Beispiel #1 getenv()-Beispiel
<?php
// Verwenden Sie von 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')
?>
Anmerkungen
Wird PHP in einer SAPI wie Fast CGI ausgeführt, gibt diese Funktion immer
den Wert einer Umgebungsvariablenzurück, die von der SAPI gesetzt wurde,
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ückzugeben.
Siehe auch
- putenv() - Setzt den Wert einer Umgebungsvariablen
- apache_getenv() - Liefert eine Apache-Subprocess_env-Variable
- Superglobals
