granicus.if.org Git - apache/blob - docs/manual/mod/mod_setenvif.xml.tr

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.tr.xsl"?>
   4 <!-- English Revision: 658546:926416 (outdated) -->
   5 <!-- =====================================================
   6  Translated by: Nilgün Belma Bugüner <nilgun belgeler.org>
   7    Reviewed by: Orhan Berent <berent belgeler.org>
   8 ========================================================== -->
   9
  10 <!--
  11  Licensed to the Apache Software Foundation (ASF) under one or more
  12  contributor license agreements.  See the NOTICE file distributed with
  13  this work for additional information regarding copyright ownership.
  14  The ASF licenses this file to You under the Apache License, Version 2.0
  15  (the "License"); you may not use this file except in compliance with
  16  the License.  You may obtain a copy of the License at
  17
  18      http://www.apache.org/licenses/LICENSE-2.0
  19
  20  Unless required by applicable law or agreed to in writing, software
  21  distributed under the License is distributed on an "AS IS" BASIS,
  22  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  23  See the License for the specific language governing permissions and
  24  limitations under the License.
  25 -->
  26
  27 <modulesynopsis metafile="mod_setenvif.xml.meta">
  28
  29 <name>mod_setenvif</name>
  30 <description>Ortam değişkenlerinin isteğin özelliklerine uygun olarak atanmasını sağlar</description>
  31 <status>Base</status>
  32 <sourcefile>mod_setenvif.c</sourcefile>
  33 <identifier>setenvif_module</identifier>
  34
  35
  36 <summary>
  37
  38     <p><module>mod_setenvif</module> modülü ortam değişkenlerinin isteğin
  39       farklı bileşenlerinin belirttiğiniz düzenli ifade ile eşleşmesine bağlı
  40       olarak atanmasını mümkün kılar. Bu ortam değişkenleri sunucunun çeşitli
  41       kısımlarında yapılacak eylemlere karar verirken kullanılır.</p>
  42
  43     <p>Yönergeler yapılandırma dosyasında yer aldıkları sıraya göre ele
  44       alınırlar. Böylece daha karmaşık dizilimler kullanılabilir, bu örnekteki
  45       tarayıcı Mozilla ise <code>netscape</code> ortam değişkeni atanmakta,
  46       MSIE ise atanmamaktadır.</p>
  47
  48     <example>
  49       BrowserMatch ^Mozilla netscape<br />
  50       BrowserMatch MSIE !netscape<br />
  51     </example>
  52 </summary>
  53
  54 <seealso><a href="../env.html">Apache’de Ortam Değişkenleri</a></seealso>
  55
  56 <directivesynopsis>
  57 <name>BrowserMatch</name>
  58 <description>Ortam değişkenlerini HTTP kullanıcı arayüzüne göre belirler.
  59 </description>
  60 <syntax>BrowserMatch <em>düzifd [!]ort-değişkeni</em>[=<em>değer</em>]
  61 [[!]<em>ort-değişkeni</em>[=<em>değer</em>]] ...</syntax>
  62 <contextlist><context>server config</context>
  63 <context>virtual host</context><context>directory</context>
  64 <context>.htaccess</context></contextlist>
  65 <override>FileInfo</override>
  66
  67 <usage>
  68   <p><directive>BrowserMatch</directive> yönergesi <directive
  69     module="mod_setenvif" >SetEnvIf</directive> yönergesinin özel bir halidir
  70     ve ortam değişkenlerine <code>User-Agent</code> HTTP istek başlığının
  71     değerine göre atama yapar. Aşağıdaki iki satır aynı etkiye sahiptir:</p>
  72
  73   <example>
  74     BrowserMatchNoCase Robot is_a_robot<br />
  75     SetEnvIfNoCase User-Agent Robot is_a_robot<br />
  76   </example>
  77
  78   <p>Başka örnekler:</p>
  79
  80   <example>
  81       BrowserMatch ^Mozilla forms jpeg=yes browser=netscape<br />
  82       BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript<br />
  83       BrowserMatch MSIE !javascript<br />
  84   </example>
  85 </usage>
  86 </directivesynopsis>
  87
  88 <directivesynopsis>
  89 <name>BrowserMatchNoCase</name>
  90 <description>Ortam değişkenlerini HTTP kullanıcı arayüzünün harf büyüklüğüne
  91 duyarsız eşleşmelerine bağlı olarak belirler.</description>
  92 <syntax>BrowserMatchNoCase <em>düzifd [!]ort-değişkeni</em>[=<em>değer</em>]
  93 [[!]<em>ort-değişkeni</em>[=<em>değer</em>]] ...</syntax>
  94 <contextlist><context>server config</context>
  95 <context>virtual host</context><context>directory</context>
  96 <context>.htaccess</context></contextlist>
  97 <override>FileInfo</override>
  98 <compatibility>Apache 1.2 ve sonrasında bulunur (Apache 1.2 sürümünde bu
  99 yönerge artık atıl olan mod_browser modülüyle sağlanırdı).</compatibility>
 100
 101 <usage>
 102
 103     <p><directive>BrowserMatchNoCase</directive> yönergesi sözdizimsel ve
 104       anlamsal olarak <directive
 105       module="mod_setenvif">BrowserMatch</directive> yönergesinin eşdeğeridir.
 106       Ancak, eşleşmelerde harf büyüklüğüne duyarsızdır. Örnek:</p>
 107
 108     <example>
 109         BrowserMatchNoCase mac platform=macintosh<br />
 110         BrowserMatchNoCase win platform=windows<br />
 111     </example>
 112
 113     <p><directive>BrowserMatch</directive> ve
 114       <directive>BrowserMatchNoCase</directive> yönergeleri <directive
 115       module="mod_setenvif">SetEnvIf</directive> ve <directive
 116       module="mod_setenvif">SetEnvIfNoCase</directive> yönergelerinin özel
 117       halleridir. Bu bakımda aşağıdaki iki satır aynı etkiye sahiptir:</p>
 118
 119     <example>
 120       BrowserMatchNoCase Robot is_a_robot<br />
 121       SetEnvIfNoCase User-Agent Robot is_a_robot<br />
 122     </example>
 123 </usage>
 124 </directivesynopsis>
 125
 126 <directivesynopsis>
 127 <name>SetEnvIf</name>
 128 <description>Ortam değişkenlerini isteğin özniteliklerine göre atar.
 129 </description>
 130 <syntax>SetEnvIf <em>öznitelik
 131     düzifd [!]ort-değişkeni</em>[=<em>değer</em>]
 132     [[!]<em>ort-değişkeni</em>[=<em>değer</em>]] ...</syntax>
 133 <contextlist><context>server config</context>
 134 <context>virtual host</context><context>directory</context>
 135 <context>.htaccess</context></contextlist>
 136 <override>FileInfo</override>
 137
 138 <usage>
 139     <p><directive>SetEnvIf</directive> yönergesi ortam değişkenlerini isteğin
 140       özniteliklerine göre tanımlar. İlk bileşen olarak belirtilen
 141       <code><em>öznitelik</em></code> şu dört şeyden biri olabilir:</p>
 142
 143     <ol>
 144       <li>Bir HTTP istek başlığı alanı (ayrıntılı bilgi için bak: <a
 145         href="http://www.rfc-editor.org/rfc/rfc2616.txt">RFC2616</a>);
 146         örneğin: <code>Host</code>, <code>User-Agent</code>,
 147         <code>Referer</code> ve <code>Accept-Language</code>.  Bir düzenli
 148         ifade kullanılarak birden fazla istek başlığı  belirtilebilir.</li>
 149
 150       <li>İsteğin aşağıdaki bileşenlerinden biri:
 151         <ul>
 152           <li><code>Remote_Host</code> - isteği yapan istemcinin konak ismi
 153             (varsa)</li>
 154
 155           <li><code>Remote_Addr</code> -isteği yapan istemcinin IP adresi</li>
 156
 157           <li><code>Server_Addr</code> - isteği alan sunucunun IP adresi
 158             (sadece 2.0.43 sonrası sürümler için)</li>
 159
 160           <li><code>Request_Method</code> - kullanılan yöntemin ismi
 161             (<code>GET</code>, <code>POST</code>, vs.)</li>
 162
 163           <li><code>Request_Protocol</code> - İsteğin yapıldığı protokolün
 164             ismi ve numarası ("HTTP/0.9", "HTTP/1.1" gibi)</li>
 165
 166           <li><code>Request_URI</code> - HTTP istek satırında belirtilen
 167             özkaynak; genellikle sorgu dizgesi olmaksızın şema ve konak ismini
 168             içeren bir URL parçasıdır. Sorgu dizgeleriyle eşleşmeler hakkında
 169             ayrıntılı bilgi edinmek için <module>mod_rewrite</module>
 170             modülünün <directive module="mod_rewrite">RewriteCond</directive>
 171             yönergesinin açıklamasına bakınız.</li>
 172         </ul>
 173       </li>
 174
 175       <li>İstek ile evvelce ilişkilendirilmiş bir ortam değişkeninin ismi. Bu
 176         sayede önceki bir eşleşmenin sonucuna karşı yeni bir sınama yapma
 177         imkanı ortaya çıkar. Böyle bir sınama için sadece evvelce
 178         <code>SetEnvIf[NoCase]</code> yönergeleri ile yapılmış atamalardaki
 179         ortam değişkenleri kullanılabilir.  ‘Evvelce’ derken, sunucu genelinde
 180         veya bölüm içinde bu yönergeden önce yer alan
 181         <code>SetEnvIf[NoCase]</code> yönerge satırları kastedilmektedir.
 182         Ortam değişkenlerinin dikkate alınabilmesi için istek öznitelikleri
 183         arasında hiçbir eşleşme olmaması ve <code><em>öznitelik</em></code>
 184         olarak bir düzenli ifade belirtilmemiş olması gerekir.</li>
 185
 186       <li>Nesne kimliği <code><em>oid</em></code> olan bir SSL istemci
 187         sertifikası eklentisine bir başvuru. SSL olarak yapılmamış bir istekte
 188         veya yapılandırılmış bir <code><em>oid</em></code>’in yokluğunda
 189         hiçbir değişken ataması yapılmaz. Birden fazla
 190         <code><em>oid</em></code> söz konusu ise aralarına virgül
 191         (<code>','</code>) konarak ilgili dizgeler birleştirilir.
 192         <code><em>oid</em></code> dizge değerli bir eklentiyi
 193         betimlemelidir.</li>
 194     </ol>
 195
 196     <p>İkinci bileşen (<code><em>düzifd</em></code>) bir <glossary
 197       ref="regex">düzenli ifade</glossary>dir.  <code><em>düzifd</em></code>
 198       ile <code><em>öznitelik</em></code> eşleştiği takdirde yönergenin kalan
 199       bileşenleri değerlendirmeye alınır.</p>
 200
 201     <p>Kalan bileşenler atanacak ortam değişkenlerinin isimleri ve isteğe
 202       bağlı olarak bunlara atanacak değerlerden oluşur. Bunlar şöyle
 203       belirtilebilir:</p>
 204
 205     <ol>
 206       <li><code><em>değişken-adı</em></code> veya</li>
 207
 208       <li><code>!<em>değişken-adı</em></code> ya da </li>
 209
 210       <li><code><em>değişken-adı</em>=<em>değer</em></code></li>
 211     </ol>
 212
 213     <p>İlk biçemde değişkene "1" değeri atanır. İkincisinde atanmış bir
 214       değişken atanmamış yapılır. Üçüncüsünde ise değişkene belirtilen
 215       <code><em>değer</em></code> bire bir atanır. 2.0.52 sürümünden itibaren
 216       parantezli düzenli ifadelerin sonuçları ile değiştirilmek üzere
 217       <code><em>value</em></code> içinde <code>$1</code>..<code>$9</code>
 218       gösterimleri tanınmaktadır.</p>
 219
 220     <example><title>Örnek:</title>
 221       SetEnvIf Request_URI "\.gif$" nesne_bir_resim=gif<br />
 222       SetEnvIf Request_URI "\.jpg$" nesne_bir_resim=jpg<br />
 223       SetEnvIf Request_URI "\.xbm$" nesne_bir_resim=xbm<br />
 224             :<br />
 225       SetEnvIf Referer belgeler\.alanismi\.mesela\.dom dahili_site_istendi<br />
 226             :<br />
 227       SetEnvIf object_is_image xbm XBIT_PROCESSING=1<br />
 228             :<br />
 229       SetEnvIf OID("2.16.840.1.113730.1.13") "(.*)" NetscapeComment=$1<br />
 230             :<br />
 231       SetEnvIf ^TS*  ^[a-z].*  TS_VAR<br />
 232     </example>
 233
 234     <p>İlk üçünde istek bir resim dosyası için yapılmışsa
 235       <code>nesne_bir_resim</code> ortam değişkeni atanmakta, dördüncüsünde
 236       istenen sayfa <code>belgeler.alanismi.mesela.dom</code> adlı sitede
 237       bulunuyorsa <code>dahili_site_istendi</code> ortam değişkeni
 238       atanmaktadır.</p>
 239
 240     <p>Altıncı örnekte <code>NetscapeComment</code> ortam değişkenine ilgili
 241       SSL istemci sertifikası alanındaki (varsa) dizge atanmaktadır.</p>
 242
 243     <p>Son örnekte ise istekte "TS" ile başlayıp [a-z] arasındaki
 244       karakterlerle devam eden bir başlık alanı varsa <code>TS_VAR</code>
 245       ortam değişkeni atanmaktadır.</p>
 246 </usage>
 247
 248 <seealso><a href="../env.html">Apache’de Ortam Değişkenleri</a> belgesinde
 249 daha fazla örnek bulunabilir.</seealso>
 250 </directivesynopsis>
 251
 252 <directivesynopsis>
 253 <name>SetEnvIfNoCase</name>
 254 <description>Ortam değişkenlerini isteğin özniteliklerinde harf büyüklüğüne
 255 bağlı olmaksızın yapılmış tanımlara göre atar.</description>
 256 <syntax>SetEnvIfNoCase <em>öznitelik
 257     düzifd [!]ort-değişkeni</em>[=<em>değer</em>]
 258     [[!]<em>ort-değişkeni</em>[=<em>değer</em>]] ...</syntax>
 259 <contextlist><context>server config</context>
 260 <context>virtual host</context><context>directory</context>
 261 <context>.htaccess</context></contextlist>
 262 <override>FileInfo</override>
 263 <compatibility>Apache 1.3 ve sonrasında mevcuttur.</compatibility>
 264
 265 <usage>
 266     <p><directive>SetEnvIfNoCase</directive> yönergesi sözdizimsel ve anlamsal
 267       olarak <directive module="mod_setenvif">SetEnvIf</directive>
 268       yönergesinin eşdeğeridir. Ancak, eşleşmelerde harf büyüklüğüne
 269       duyarsızdır. Örnek:</p>
 270
 271     <example>
 272       SetEnvIfNoCase Host Apache\.Org site=apache
 273     </example>
 274
 275     <p>Burada, <code>Host:</code> HTTP istek başlığında
 276       <code>Apache.Org</code>, <code>apache.org</code> veya harf büyüklüğünce
 277       farklı benzerleri belirtilmişse <code>site</code> ortam değişkenine
 278       "<code>apache</code>" değeri atanmaktadır.</p>
 279 </usage>
 280 </directivesynopsis>
 281 </modulesynopsis>