Apache Modülü mod_setenvif

Mevcut Diller: en | fr | ja | ko | tr

Bu çeviri güncel olmayabilir. Son değişiklikler için İngilizce sürüm geçerlidir.

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ü 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 sunucunun çeşitli kısımlarında yapılacak eylemlere karar verirken kullanılır.

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:

Apache’de Ortam Değişkenleri

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
Uyumluluk:	Apache 1.2 ve sonrasında bulunur (Apache 1.2 sürümünde bu yönerge artık atıl olan mod_browser modülüyle sağlanırdı).

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 dört şeyden biri olabilir:

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.
İ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.
İ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.
Nesne kimliği oid olan bir SSL istemci sertifikası eklentisine bir başvuru. SSL olarak yapılmamış bir istekte veya yapılandırılmış bir oid’in yokluğunda hiçbir değişken ataması yapılmaz. Birden fazla oid söz konusu ise aralarına virgül (',') konarak ilgili dizgeler birleştirilir. oid dizge değerli bir eklentiyi betimlemelidir.

İ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 da
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 OID("2.16.840.1.113730.1.13") "(.*)" NetscapeComment=$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.

Altıncı örnekte NetscapeComment ortam değişkenine ilgili SSL istemci sertifikası alanındaki (varsa) dizge 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
Uyumluluk:	Apache 1.3 ve sonrasında mevcuttur.

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.