(PHP 4, PHP 5, PHP 7)
putenv — Setzt den Wert einer Umgebungsvariablen.
$setting
) : bool
Fügt setting zur Server-Umgebung hinzu. Die
Umgebungsvariable existiert nur für die Dauer des aktuellen Request. Am Ende
des Requests wird der Originalzustand der Umgebung wiederhergestellt.
Das Ändern bestimmter Umgebungsvariablen kann potentiell die Sicherheit gefährden. Die safe_mode_allowed_env_vars Direktive enthält eine durch Komma getrennte Liste von Präfixen. Im Safe-Mode kann der Benutzer nur Umgebungsvariablen ändern, deren Name mit einem der in dieser Direktive angegeben Präfix beginnt. Standardmäßig können Benutzer nur Umgebungsvariablen ändern, die mit PHP_ beginnen (z.B. PHP_FOO=BAR). Beachte: ist diese Direktive leer, erlaubt PHP dem Benutzer das Ändern BELIEBIGER Umgebungsvariablen.
Die safe_mode_protected_env_vars Direktive enthält eine durch Komma getrennte Liste von Umgebungsvariablen, die der Endanwender durch putenv() nicht ändern kann. Diese Variablen werden auch dann geschützt, wenn safe_mode_allowed_env_vars so eingestellt ist, dass sie geändert werden könnten.
settingDie Einstellung, beispielsweise "FOO=BAR"
Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.
Beispiel #1 Setzen einer Umgebungsvariablen
<?php
putenv("UNIQID=$uniqid");
?>
Die safe_mode_allowed_env_vars und safe_mode_protected_env_vars Direktiven wirken nur, wenn safe_mode aktiviert ist.