Apache HTTP Sunucusu Sürüm 2.2
![](feather.gif)
Apache Modülü mod_setenvif
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
Ayrıca bakınız:
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:
- Bir HTTP istek başlığı alanı (ayrıntılı bilgi için bak: RFC2616);
örneğin:
Host
,User-Agent
,Referer
veAccept-Language
. Bir düzenli ifade kullanılarak birden fazla istek başlığı belirtilebilir. - İsteğin aşağıdaki bileşenlerinden biri:
Remote_Host
- isteği yapan istemcinin konak ismi (varsa)Remote_Addr
-isteği yapan istemcinin IP adresiServer_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çinmod_rewrite
modülününRewriteCond
yönergesinin açıklamasına bakınız.
- İ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 alanSetEnvIf[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:
değişken-adı
veya!değişken-adı
ya dadeğ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.