getenv

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

getenvOrtam değişkenlerinden birinin veya tümünün değerini döndürür

Açıklama

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

Ortam değişkenlerinden birinin veya tümünün 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.

Bağımsız Değişkenler

değişken

Ortam değişkeninin ismi, null olabilir.

yerel

true belirtilirse, yalnızca değişken bir dizge ise yalnızca 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 belirtilen ortam değişkeninin değerini döndürür. değişken null ise, tüm ortam değişkenlerini içeren ilişkisel bir dizi döner.

Sürüm Bilgisi

Sürüm: Açıklama
8.0.0 değişken artık null olabiliyor.
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.
7.0.9 yerel bağımsız değişkeni eklendi.

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

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 bağımsız değişkeni kullanılır.

Ayrıca Bakınız