getenv

    (PHP 4, PHP 5, PHP 7, PHP 8)

    getenv — Liefert den Wert einer einzelnen oder aller Umgebungsvariablen

    Beschreibung

    getenv(?string$name = null, bool$local_only = false): string|array|false

    Gibt den Wert einer einzelnen oder aller Umgebungsvariablen zurück.

    Eine Liste aller Umgebungsvariablen lässt sich mit der Funktion phpinfo() anzeigen. Viele dieser Variablen sind im » RFC 3875, insbesondere im Abschnitt 4.1, "Request Meta-Variables", aufgeführt.

    Parameter-Liste

    name

    Der Variablenname als String oder null.

    local_only

    Bei true werden nur lokale Umgebungsvariablen zurückgegeben, die vom Betriebsystem oder durch putenv() gesetzt wurden. Es hat nur dann eine Auswirkung, wenn name ein String ist.

    Rückgabewerte

    Gibt den Wert der Umgebungsvariable varname zurück oder false, wenn die Umgebungsvariable name nicht existiert. Ist namenull, werden alle Umgebungsvariablen als assoziatives Array zurückgegeben.

    Changelog

    VersionBeschreibung
    8.0.0 Der Parameter name ist nun nullable (akzeptiert den null-Wert).
    7.1.0 Der Parameter name 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
    // Verwendung von getenv() ...
    $ip = getenv('REMOTE_ADDR');

    // ... oder einfach eines 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

    Warnung

    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

    To Top