mod_setenvif
Ortam değişkenlerinin isteğin özelliklerine uygun olarak atanmasını sağlar
Base
mod_setenvif.c
setenvif_module

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 sunucunun çeşitli kısımlarında yapılacak eylemlerin yanında CGI betiklerinde ve SSI sayfalarında kullanılabilir hale gelmelerine karar verilirken 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

mod_autoindex ile dizin listesi oluşturulması veya bir DirectoryIndex için yol aranması gibi bir dahili

alt istek
için sunucu yol araması yaparken isteklere özgü ortam değişkenleri alt istekler tarafından miras alınMAZ. Buna ek olarak, mod_setenvif modülünün devreye girdiği API fazlarından dolayı yapılan alt isteklerde SetEnvIf yönergeleri ayrı ayrı değerlendirilMEZ.
Apache HTTP Sunucusundaki Ortam Değişkenleri
BrowserMatch
Ortam değişkenlerini HTTP kullanıcı arayüzüne göre belirler.
BrowserMatch düzifd [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ...
server config
virtual host
directory
.htaccess
FileInfo

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
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.
BrowserMatchNoCase düzifd [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ...
server config
virtual host
directory
.htaccess
FileInfo

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
Ortam değişkenlerini isteğin özniteliklerine göre atar.
SetEnvIf öznitelik düzifd [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ...
server config
virtual host
directory
.htaccess
FileInfo

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:

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 ifade
dir. `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 Apache httpd parantezli düzenli ifadelerin sonuçları ile değiştirilmek üzere `value` içinde `$1`..`$9` gösterimleri tanınmaktadır.

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\.example\.com 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.example.com` 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.

Apache HTTP Sunucusundaki Ortam Değişkenleri belgesinde daha fazla örnek bulunabilir.
SetEnvIfExpr
Bir ap_expr ifadesine dayanarak ortam değişkenlerine değer atar
SetEnvIfExpr ifade [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ...
server config
virtual host
directory
.htaccess
FileInfo

SetEnvIfExpr yönergesi bir If `ap_expr` ifadesine dayanarak ortam değişkenlerine değer atar. Bu ifadeler çalışma anında değerlendirilirerek SetEnvIf yönergesindeki gibi ort-değişkenine uygulanır.

SetEnvIfExpr "tolower(req('X-Sendfile')) == 'd:\images\very_big.iso')" iso_delivered

Burada uygulamamızın her `X-Sendfile` göndermeye çalışmasında ortam değişkenine `iso_delivered` değeri atanmaktadır.

Uzak IP adresi RFC 1918'e göre özel bir adres ise rfc1918 değişkenine 1 atanması daha kullanışlı bir örnek olurdu:

SetEnvIfExpr "-R '10.0.0.0/8' || -R '172.16.0.0/12' || -R '192.168.0.0/16'" rfc1918
Eksiksiz bir kılavuz ve daha fazla örnek için Apache HTTP Sunucusundaki İfadeler belgesine bakınız.
Benzer sonuçlara ulaşmak için If yönergesi kullanılabilir.
mod_filter
SetEnvIfNoCase
Ortam değişkenlerini isteğin özniteliklerinde harf büyüklüğüne bağlı olmaksızın yapılmış tanımlara göre atar.
SetEnvIfNoCase öznitelik düzifd [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ...
server config
virtual host
directory
.htaccess
FileInfo

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 Example\.Org site=example

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