granicus.if.org Git - apache/blob - docs/manual/handler.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: 1174747:1330883 (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 <manualpage metafile="handler.xml.meta">
  28
  29   <title>Apache Eylemcilerinin Kullanımı</title>
  30
  31   <summary>
  32     <p>Bu belgede Apache Eylemcilerinin kullanımı açıklanmıştır.</p>
  33   </summary>
  34
  35   <section id="definition">
  36     <title>Eylemci Nedir?</title>
  37     <related>
  38       <modulelist>
  39         <module>mod_actions</module>
  40         <module>mod_asis</module>
  41         <module>mod_cgi</module>
  42         <module>mod_imagemap</module>
  43         <module>mod_info</module>
  44         <module>mod_mime</module>
  45         <module>mod_negotiation</module>
  46         <module>mod_status</module>
  47      </modulelist>
  48       <directivelist>
  49         <directive module="mod_actions">Action</directive>
  50         <directive module="mod_mime">AddHandler</directive>
  51         <directive module="mod_mime">RemoveHandler</directive>
  52         <directive module="core">SetHandler</directive>
  53       </directivelist>
  54     </related>
  55
  56
  57     <p>Bir <em>eylemci</em> bir dosya çağrıldığında uygulanacak eylemin Apache
  58       dahilindeki gösterimidir. Genellikle dosyaların kendi türüne bağlı
  59       olarak örtük eylemcileri vardır. Normalde tüm dosyalar basitçe sunucu
  60       tarafından sunulurlar, fakat bazı dosya türleri normalden farklı şekilde
  61       ele alınırlar.</p>
  62
  63     <p>Eylemciler, dosya türünden bağımsız olarak dosyanın bulunduğu yere veya
  64       dosya ismi uzantısına göre de yapılandırılabilirler. Gerek, zarif bir
  65       çözüm oluşuyla gerekse, hem dosya türünü hem de bir dosya ile ilişkili
  66       bir eylemciyi mümkün kılması sebebiyle bunun getirisi daha yüksektir.
  67       (Ayrıca, <a href="mod/mod_mime.html#multipleext">çok uzantılı
  68       dosyalara</a> da bakınız.)</p>
  69
  70     <p>Eylemciler sunucu içinde derlenebileceği gibi bir modül olarak ya da
  71       <directive module="mod_actions">Action</directive> yönergesi ile de
  72       sunucuya dahil edilebilirler. Standart dağıtımda bulunan yerleşik
  73       eylemciler şunlardır:</p>
  74
  75     <ul>
  76       <li><strong>default-handler</strong>: Dosyayı, öntanımlı olarak durağan
  77         içeriği işlemekte kullanılan <code>default_handler()</code> işlevini
  78         kullanarak gönderir. (<module>core</module>)</li>
  79
  80       <li><strong>send-as-is</strong>: Dosyayı HTTP başlıklarıyla olduğu gibi
  81         gönderir. (<module>mod_asis</module>)</li>
  82
  83       <li><strong>cgi-script</strong>: Dosyayı bir CGI betiği olarak ele alır.
  84         (<module>mod_cgi</module>)</li>
  85
  86       <li><strong>imap-file</strong>: Dosyayı bir resim eşleme kuralları
  87         dosyası olarak çözümler. (<module>mod_imagemap</module>)</li>
  88
  89       <li><strong>server-info</strong>: Sunucunun yapılandırma bilgisini
  90         döndürür. (<module>mod_info</module>)</li>
  91
  92       <li><strong>server-status</strong>: Sunucunun durum raporunu döndürür.
  93         (<module>mod_status</module>)</li>
  94
  95       <li><strong>type-map</strong>: Dosyayı içerik uzlaşımı için bir tür
  96         eşlem dosyası olarak çözümler. (<module>mod_negotiation</module>)</li>
  97     </ul>
  98   </section>
  99
 100   <section id="examples">
 101     <title>Örnekler</title>
 102
 103     <section id="example1">
 104       <title>Bir CGI betiği kullanarak durağan içeriğin değiştirilmesi</title>
 105
 106       <p>Aşağıdaki yönergeler sayesinde, <code>html</code> uzantılı dosyalar
 107         için yapılan istekler <code>footer.pl</code> CGI betiğininin
 108         çalıştırılmasına sebep olacaktır.</p>
 109
 110       <example>
 111         Action add-footer /cgi-bin/footer.pl<br/>
 112         AddHandler add-footer .html
 113       </example>
 114
 115       <p>Bu yapılandırmayla, istenen belgenin özgün haliyle mi (yeri
 116         <code>PATH_TRANSLATED</code> ortam değişkenindedir) yoksa istenen
 117         değişiklikler veya eklemeler yapıldıktan sonra mı gönderileceğinden
 118         CGI betiği sorumlu olacaktır.</p>
 119
 120     </section>
 121     <section id="example2">
 122       <title>HTTP başlıklı dosyalar</title>
 123
 124       <p>Aşağıdaki yönergeler kendi HTTP başlıklarını içeren dosyalar için
 125         kullanılan <code>send-as-is</code> eylemcisini etkinleştirmek amacıyla
 126         kullanılmıştır. <code>/siteler/htdocs/asis/</code> dizinindeki tüm
 127         dosyalar dosya ismi uzantılarına bakılmaksızın <code>send-as-is</code>
 128         eylemcisi tarafından işleme sokulacaktır.</p>
 129
 130       <example>
 131         &lt;Directory /siteler/htdocs/asis&gt;<br/>
 132         <indent>SetHandler send-as-is</indent>
 133         &lt;/Directory&gt;
 134       </example>
 135
 136     </section>
 137   </section>
 138   <section id="programmer">
 139     <title>Yazılım Geliştirenler İçin</title>
 140
 141     <p>Eylemci özellikleri gerçeklenirken kullanılmak üzere <a
 142       href="developer/API.html">Apache API</a>’ye bir ekleme yapılmıştır.
 143       Özellikle de, <code>request_rec</code> yapısına yeni bir kayıt
 144       eklenmiştir:</p>
 145
 146     <example>
 147       char *handler
 148     </example>
 149
 150     <p>Modülünüzün bir eylemciyi devreye sokmasını isterseniz, tek yapacağınız
 151       isteğin <code>invoke_handler</code> aşamasının hemen öncesinde
 152       <code>r-&gt;handler</code> alanına eylemcinin ismini atamak olacaktır.
 153       Eylemciler daha önce de bahsedildiği gibi bir içerik türü yerine bir
 154       eylemci ismi kullanılarak gerçeklenirler. Çok gerekli olmamakla
 155       birlikte, eylemciler için kullanılan adlandırma uzlaşımları gereğince,
 156       ismi oluşturan sözcükler, ortam türü isim alanını ihlal etmemek amacıyla
 157       bölü imleri ile değil tire imleri ile ayrılırlar.</p>
 158   </section>
 159 </manualpage>