mod_setenvif - Apache HTTP Sunucusu Sürüm 2.2

Apache HTTP Sunucusu Sürüm 2.2

Apache > HTTP Sunucusu > Belgeleme > Sürüm 2.2 > Modüller

# Apache Modülü mod_setenvif

Mevcut Diller: en | ja | ko | tr

Açıklama: | Ortam değişkenlerinin isteğin özelliklerine uygun olarak atanmasını sağlar
Durum: | Temel
Modül Betimleyici: | setenvif_module
Kaynak Dosyası: | mod_setenvif.c

### Özet

`mod_setenvif` modülü, dahili ortam değişkenlerinin, isteğin farklı bileşenlerinin belirttiğiniz düzenli ifade ile eşleşmesine bağlı olarak atanmasını mümkün kılar. Bu ortam değişkenleri, CGI betiklerinde ve SSI sayfalarında da kullanılabilir hale gelmenin yanı sıra sunucunun çeşitli kısımlarında yapılacak eylemlere karar verirken kullanılabilirler.

Yönergeler yapılandırma dosyasında yer aldıkları sıraya göre ele alınırlar. Böylece daha karmaşık dizilimler kullanılabilir, bu örnekteki tarayıcı Mozilla ise `netscape` ortam değişkeni atanmakta, MSIE ise atanmamaktadır.

`BrowserMatch ^Mozilla netscape
BrowserMatch MSIE !netscape
`

### Yönergeler

### Ayrıca bakınız:

- Apache’de Ortam Değişkenleri

- Yorum

## BrowserMatch Yönergesi

Açıklama: | Ortam değişkenlerini HTTP kullanıcı arayüzüne göre belirler.
Sözdizimi: | `BrowserMatch düzifd [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ...`
Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess
Geçersizleştirme: | FileInfo
Durum: | Temel
Modül: | mod_setenvif

`BrowserMatch` yönergesi `SetEnvIf` yönergesinin özel bir halidir ve ortam değişkenlerine `User-Agent` HTTP istek başlığının değerine göre atama yapar. Aşağıdaki iki satır aynı etkiye sahiptir:

`BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot
`

Başka örnekler:

`BrowserMatch ^Mozilla forms jpeg=yes browser=netscape
BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript
BrowserMatch MSIE !javascript
`

## BrowserMatchNoCase Yönergesi

Açıklama: | Ortam değişkenlerini HTTP kullanıcı arayüzünün harf büyüklüğüne duyarsız eşleşmelerine bağlı olarak belirler.
Sözdizimi: | `BrowserMatchNoCase düzifd [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ...`
Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess
Geçersizleştirme: | FileInfo
Durum: | Temel
Modül: | mod_setenvif

`BrowserMatchNoCase` yönergesi sözdizimsel ve anlamsal olarak `BrowserMatch` yönergesinin eşdeğeridir. Ancak, eşleşmelerde harf büyüklüğüne duyarsızdır. Örnek:

`BrowserMatchNoCase mac platform=macintosh
BrowserMatchNoCase win platform=windows
`

`BrowserMatch` ve `BrowserMatchNoCase` yönergeleri `SetEnvIf` ve `SetEnvIfNoCase` yönergelerinin özel halleridir. Bu bakımda aşağıdaki iki satır aynı etkiye sahiptir:

`BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot
`

## SetEnvIf Yönergesi

Açıklama: | Ortam değişkenlerini isteğin özniteliklerine göre atar.
Sözdizimi: | `SetEnvIf öznitelik düzifd [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ...`
Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess
Geçersizleştirme: | FileInfo
Durum: | Temel
Modül: | mod_setenvif

`SetEnvIf` yönergesi ortam değişkenlerini isteğin özniteliklerine göre tanımlar. İlk bileşen olarak belirtilen `öznitelik` şu üç şeyden biri olabilir:

1. Bir HTTP istek başlığı alanı (ayrıntılı bilgi için bak: RFC2616); örneğin: `Host`, `User-Agent`, `Referer` ve `Accept-Language`. Bir düzenli ifade kullanılarak birden fazla istek başlığı belirtilebilir.
2. İsteğin aşağıdaki bileşenlerinden biri:
   - `Remote_Host` - isteği yapan istemcinin konak ismi (varsa)
   - `Remote_Addr` -isteği yapan istemcinin IP adresi
   - `Server_Addr` - isteği alan sunucunun IP adresi (sadece 2.0.43 sonrası sürümler için)
   - `Request_Method` - kullanılan yöntemin ismi (`GET`, `POST`, vs.)
   - `Request_Protocol` - İsteğin yapıldığı protokolün ismi ve numarası ("HTTP/0.9", "HTTP/1.1" gibi)
   - `Request_URI` - HTTP istek satırında belirtilen özkaynak; genellikle sorgu dizgesi olmaksızın şema ve konak ismini içeren bir URL parçasıdır. Sorgu dizgeleriyle eşleşmeler hakkında ayrıntılı bilgi edinmek için `mod_rewrite` modülünün `RewriteCond` yönergesinin açıklamasına bakınız.
3. İstek ile evvelce ilişkilendirilmiş bir ortam değişkeninin ismi. Bu sayede önceki bir eşleşmenin sonucuna karşı yeni bir sınama yapma imkanı ortaya çıkar. Böyle bir sınama için sadece evvelce `SetEnvIf[NoCase]` yönergeleri ile yapılmış atamalardaki ortam değişkenleri kullanılabilir. ‘Evvelce’ derken, sunucu genelinde veya bölüm içinde bu yönergeden önce yer alan `SetEnvIf[NoCase]` yönerge satırları kastedilmektedir. Ortam değişkenlerinin dikkate alınabilmesi için istek öznitelikleri arasında hiçbir eşleşme olmaması ve `öznitelik` olarak bir düzenli ifade belirtilmemiş olması gerekir.

İkinci bileşen (`düzifd`) bir düzenli ifadedir. `düzifd` ile `öznitelik` eşleştiği takdirde yönergenin kalan bileşenleri değerlendirmeye alınır.

Kalan bileşenler atanacak ortam değişkenlerinin isimleri ve isteğe bağlı olarak bunlara atanacak değerlerden oluşur. Bunlar şöyle belirtilebilir:

1. `değişken-adı` veya
2. `!değişken-adı` ya da
3. `değişken-adı=değer`

İlk biçemde değişkene "1" değeri atanır. İkincisinde atanmış bir değişken atanmamış yapılır. Üçüncüsünde ise değişkene belirtilen `değer` bire bir atanır. 2.0.52 sürümünden itibaren parantezli düzenli ifadelerin sonuçları ile değiştirilmek üzere `value` içinde `$1`..`$9` gösterimleri tanınmaktadır.

### Örnek:

`SetEnvIf Request_URI "\.gif$" nesne_bir_resim=gif
SetEnvIf Request_URI "\.jpg$" nesne_bir_resim=jpg
SetEnvIf Request_URI "\.xbm$" nesne_bir_resim=xbm
:
SetEnvIf Referer belgeler\.alanismi\.mesela\.dom dahili_site_istendi
:
SetEnvIf object_is_image xbm XBIT_PROCESSING=1
:
SetEnvIf ^TS* ^[a-z].* TS_VAR
`

İlk üçünde istek bir resim dosyası için yapılmışsa `nesne_bir_resim` ortam değişkeni atanmakta, dördüncüsünde istenen sayfa `belgeler.alanismi.mesela.dom` adlı sitede bulunuyorsa `dahili_site_istendi` ortam değişkeni atanmaktadır.

Son örnekte ise istekte "TS" ile başlayıp [a-z] arasındaki karakterlerle devam eden bir başlık alanı varsa `TS_VAR` ortam değişkeni atanmaktadır.

### Ayrıca bakınız:

- Apache’de Ortam Değişkenleri belgesinde daha fazla örnek bulunabilir.

## SetEnvIfNoCase Yönergesi

Açıklama: | Ortam değişkenlerini isteğin özniteliklerinde harf büyüklüğüne bağlı olmaksızın yapılmış tanımlara göre atar.
Sözdizimi: | `SetEnvIfNoCase öznitelik düzifd [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ...`
Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess
Geçersizleştirme: | FileInfo
Durum: | Temel
Modül: | mod_setenvif

`SetEnvIfNoCase` yönergesi sözdizimsel ve anlamsal olarak `SetEnvIf` yönergesinin eşdeğeridir. Ancak, eşleşmelerde harf büyüklüğüne duyarsızdır. Örnek:

`SetEnvIfNoCase Host Apache\.Org site=apache`

Burada, `Host:` HTTP istek başlığında `Apache.Org`, `apache.org` veya harf büyüklüğünce farklı benzerleri belirtilmişse `site` ortam değişkenine "`apache`" değeri atanmaktadır.

Mevcut Diller: en | ja | ko | tr

## Yorum

Notice:
This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.