getenv

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

getenvBir ortam değişkeninin değerini döndürür

Açıklama

getenv ( string $değişken , bool $yerel = false ) : string|false
getenv ( ) : array

Belirtilen 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ştirgeler

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.

Dönen Değerler

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 Bilgisi

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.

Notlar

Uyarı

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.

Örnekler

Ö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')
?>

Ayrıca Bakınız