granicus.if.org Git - apache/blob - docs/manual/custom-error.xml.tr

   1 <?xml version="1.0" encoding="UTF-8" ?>
   2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
   3 <?xml-stylesheet type="text/xsl" href="./style/manual.tr.xsl"?>
   4 <!-- English Revision: 558686 -->
   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 <manualpage metafile="custom-error.xml.meta">
  28
  29   <title>Hata Yanıtlarının Kişiselleştirilmesi</title>
  30
  31   <summary>
  32     <p>Apache, bazı sorunlara ve hatalara karşılık vereceği yanıtların
  33       yapılandırabilmesini mümkün kılan ek bir işlevselliğe sahiptir.</p>
  34
  35     <p>Site yöneticisi tarafından kişiselleştirilebilen bu tür yanıtlar,
  36       sunucu belli hatalar veya sorunlarla karşılaştığında etkin kılınmak
  37       üzere tanımlanabilir.</p>
  38
  39     <p>Bir betik bir hata nedeniyle bir "500 Server Error" yanıtının
  40       verilmesine sebep olursa bu yanıt yerine başka bir adrese
  41       yönlendirilerek (dahili veya harici) veya doğrudan daha dostça bir
  42       metin sunulabilir.</p>
  43   </summary>
  44
  45   <section id="behavior">
  46     <title>Davranış</title>
  47
  48     <section>
  49       <title>Eski Davranış</title>
  50
  51       <p>NCSA httpd 1.3, çoğunlukla kullanıcıya anlamsız gelen ve sebebiyle
  52         kavramsal bir bağ kurulamayan günlük kayıtları üreten, can sıkıcı
  53         bazı hata/sorun yanıtları döndürürdü.</p>
  54     </section>
  55
  56     <section>
  57       <title>Yeni Davranış</title>
  58
  59       <p>Sunucudan NCSA kodlu iletiler yerine</p>
  60
  61       <ul>
  62         <li>başka bir metin göstermesi,</li>
  63
  64         <li>istemciyi başka bir yerel adrese yönlendirmesi veya</li>
  65
  66         <li>istemciyi bir harici adrese yönlendirmesi</li>
  67       </ul>
  68
  69       <p>istenebilir. Başka bir adrese yönlendirme, hata veya sorunu daha iyi
  70         açıklamakta kullanılabilecek bazı bilgilerin aktarılması şartıyla
  71         oldukça kullanışlı olabilir.</p>
  72
  73       <p>Apache, buna olanak vermek için CGI benzeri yeni ortam değişkenleri
  74         tanımlamıştır:</p>
  75
  76       <example>
  77         REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap,
  78             image/jpeg<br />
  79         REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX A.09.05
  80             9000/712)<br />
  81         REDIRECT_PATH=.:/bin:/usr/local/bin:/etc<br />
  82         REDIRECT_QUERY_STRING=<br />
  83         REDIRECT_REMOTE_ADDR=121.345.78.123<br />
  84         REDIRECT_REMOTE_HOST=ooh.ahhh.dom<br />
  85         REDIRECT_SERVER_NAME=batti.balik.yan.gider.edu<br />
  86         REDIRECT_SERVER_PORT=80<br />
  87         REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br />
  88         REDIRECT_URL=/cgi-bin/hatalar.pl
  89       </example>
  90
  91       <p><code>REDIRECT_</code> önekine dikkat edin.</p>
  92
  93       <p>Yeni adrese (hedefin bir CGI betiği veya SSI sayfası olduğu
  94         kabulüyle) en azından <code>REDIRECT_URL</code> ve
  95         <code>REDIRECT_QUERY_STRING</code> değişkenleri aktarılır. Diğer
  96         değişkenler ise sadece hata veya sorunun öncesinde mevcut oldukları
  97         takdirde aktarılacaklardır. Eğer <em>harici</em> yönlendirmeyi
  98         <directive module="core">ErrorDocument</directive> yönergesi
  99         üzerinden yapıyorsanız bunlara <strong>None</strong> değeri
 100         atanacaktır. (Yönlendirme adresi <code>http:</code> ile başlıyorsa
 101         adres aynı sunucuya ait olsa bile bu bir harici yönlendirme olarak
 102         ele alınır.)</p>
 103     </section>
 104   </section>
 105
 106   <section id="configuration">
 107     <title>Yapılandırma</title>
 108
 109     <p><directive module="core">ErrorDocument</directive> yönergesinin
 110       <code>.htaccess</code> dosyalarında kullanılması sadece <directive
 111       module="core">AllowOverride</directive> yönergesine uygun bir değer
 112       atanmışsa mümkündür.</p>
 113
 114     <p>Bazı örnekler:</p>
 115
 116     <example>
 117       ErrorDocument 500 /cgi-bin/hata-kurtarma <br />
 118       ErrorDocument 500 "Pardon, galiba bizim betik hata verdi." <br />
 119       ErrorDocument 500 http://xxx/ <br />
 120       ErrorDocument 404 /ozuru_kabahatinden_buyuk/yok.html <br />
 121       ErrorDocument 401 /Uyeler/NASIL_uye_olunur.html
 122     </example>
 123
 124     <p>Burada sözdizimi şöyledir:</p>
 125
 126     <example>
 127       ErrorDocument &lt;3-rakamlı-kod&gt; &lt;eylem&gt;
 128     </example>
 129
 130     <p><code><em>eylem</em></code> şunlardan biri olabilir:</p>
 131
 132     <ul>
 133       <li>Gösterilecek metin. Metin tırnak (") içine alınmalıdır.</li>
 134
 135       <li>Yönlendirmenin yapılacağı harici adres.</li>
 136
 137       <li>Yönlendirmenin yapılacağı dahili adres.</li>
 138     </ul>
 139   </section>
 140
 141   <section id="custom">
 142     <title>Özel Hata Yanıtları ve Yönlendirme</title>
 143
 144     <p>Apache’nin yönlendirme ile ilgili davranışı bir CGI betiği veya SSI
 145       sayfası sözkonusu olduğunda bazı ek ortam değişkenleri ile
 146       yapılandırılabilir.</p>
 147
 148     <section>
 149       <title>Eski Davranış</title>
 150
 151       <p>Yönlendirme yapılan betikte standart CGI değişkenleri kullanılırdı.
 152         Yönlendirmenin kaynağı ile ilgili bir belirtiye rastlanmazdı.</p>
 153     </section>
 154
 155     <section>
 156       <title>Yeni Davranış</title>
 157
 158       <p>Yönlendirme yapılan betikte kullanılmak üzere özel olarak
 159         tanımlanmış ortam değişkenleri vardır. Her değişkenin ismi
 160         <code>REDIRECT_</code> ile başlar. <code>REDIRECT_</code> ortam
 161         değişkenleri, yönlendirme öncesinde tanımlanmış CGI ortam
 162         değişkenlerinin isimlerinin başına <code>REDIRECT_</code> öneki
 163         getirilerek oluşturulur. Yani, <code>HTTP_USER_AGENT</code> değişkeni
 164         <code>REDIRECT_HTTP_USER_AGENT</code> haline gelir. Bunlara ek
 165         olarak, betiğe olayın izini sürmekte yardımcı olması için
 166         <code>REDIRECT_URL</code> ve <code>REDIRECT_STATUS</code>
 167         değişkenleri tanımlanmıştır. Erişim günlüğüne özgün adresle birlikte
 168         yönlendirme adresi de kaydedilir.</p>
 169
 170       <p>Eğer <directive module="core">ErrorDocument</directive> yönergesi
 171         bir yerel CGI betiğine yönlendirme belirtiyorsa, hatanın kaynağı
 172         hakkında istemciye bilgi vermek amacıyla betiğin çıktısında bir
 173         "<code>Status:</code>" başlık alanına yer verilmesi önerilir.
 174         Örneğin, bir Perl betiği şunları içerebilirdi:</p>
 175
 176       <example>
 177         ... <br />
 178         print  "Content-type: text/html; charset=UTF-8\n"; <br />
 179         printf "Status: %s durumu saptandı.\n", $ENV{"REDIRECT_STATUS"}; <br />
 180         ...
 181       </example>
 182
 183       <p>Eğer betik,  <code>404&nbsp;Not&nbsp;Found</code> gibi, belli bir
 184         hata durumunu ele almaya adanmışsa duruma özel kod ve hata metni
 185         kullanılabilir.</p>
 186
 187       <p>Eğer yanıt, (istemci taraflı yönlendirme yapılırken) bir
 188         <code>Location:</code> başlığı da içeriyorsa betiğin çıktıya uygun
 189         bir <code>Status:</code> başlığı (<code>302&nbsp;Found</code> gibi)
 190         eklemesinin <em>gerekli</em> oluşuna dikkat ediniz. Aksi takdirde,
 191         <code>Location:</code> başlığı etkisiz olabilir.</p>
 192     </section>
 193   </section>
 194 </manualpage>