(PHP 4, PHP 5, PHP 7, PHP 8)
getenv — Bir ortam değişkeninin değerini döndürür
$değişken
, bool $yerel
= false
) : string|falseBelirtilen ortam değişkeninin değerini döndürür.
Tüm ortam değişkenlerini phpinfo() işlevini kullanarak bir liste halinde görebilirsiniz. Bunların pek çoğunun anlamlarını » RFC 3875 belgesinin özellikle 4.1 "Request Meta-Variables" bölümünde bulabilirsiniz.
değişken
Ortam değişkeninin ismi.
yerel
true
belirtilirse sacece yerel ortam değişkenleri (işletim sistemi
veya putenv ile atanır) döner.
değişken
diye bir ortam değişkeni yoksa false
aksi
takdirde değişken
ile belirtilen ortam değişkeninin
değerini döndürür. değişken
atlanırsa, tüm ortam
değişkenlerini içeren ilişkisel bir dizi döner.
Sürüm: | Açıklama |
---|---|
7.1.0 |
değişken artık atlanabiliyor, bu durumda tüm
ortam değişkenlerini içeren ilişkisel bir dizi dönüyor.
|
5.5.38, 5.6.24, 7.0.9 |
yerel değiştirgesi eklendi.
|
PHP, Fast CGI gibi bir SAPI olarak çalışıyorsa, bu işlev daima SAPI
tarafından atanan bir ortam değişkeninin değerini döndürür
(putenv() ile aynı isimde yerel bir ortam değişkeni
tanımlanmış olsa bile). Yerel olarak tanımlanmış ortam değişkenlerini
döndürmek için yerel
değiştirgesi kullanılır.
Örnek 1 - getenv() örneği
<?php
// getenv() kullanım örneği
$ip = getenv('REMOTE_ADDR');
//Veya basitçe bir süper küresel kullan ($_SERVER veya $_ENV)
$ip = $_SERVER['REMOTE_ADDR'];
// Bir ortam değişkeninin değeri, bir SAPI tarafından ayarlanıp
// ayarlanmadığına veya putenv ile değiştirilip değiştirilmediğine
// bakılmaksızın rahatça alınabilir
$ip = getenv('REMOTE_ADDR', true) ?: getenv('REMOTE_ADDR')
?>