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 ========================================================== -->
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
18 http://www.apache.org/licenses/LICENSE-2.0
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.
27 <manualpage metafile="handler.xml.meta">
29 <title>Apache Eylemcilerinin Kullanımı</title>
32 <p>Bu belgede Apache Eylemcilerinin kullanımı açıklanmıştır.</p>
35 <section id="definition">
36 <title>Eylemci Nedir?</title>
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>
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>
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
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>
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>
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>
80 <li><strong>send-as-is</strong>: Dosyayı HTTP başlıklarıyla olduğu gibi
81 gönderir. (<module>mod_asis</module>)</li>
83 <li><strong>cgi-script</strong>: Dosyayı bir CGI betiği olarak ele alır.
84 (<module>mod_cgi</module>)</li>
86 <li><strong>imap-file</strong>: Dosyayı bir resim eşleme kuralları
87 dosyası olarak çözümler. (<module>mod_imagemap</module>)</li>
89 <li><strong>server-info</strong>: Sunucunun yapılandırma bilgisini
90 döndürür. (<module>mod_info</module>)</li>
92 <li><strong>server-status</strong>: Sunucunun durum raporunu döndürür.
93 (<module>mod_status</module>)</li>
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>
100 <section id="examples">
101 <title>Örnekler</title>
103 <section id="example1">
104 <title>Bir CGI betiği kullanarak durağan içeriğin değiştirilmesi</title>
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>
111 Action add-footer /cgi-bin/footer.pl<br/>
112 AddHandler add-footer .html
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>
121 <section id="example2">
122 <title>HTTP başlıklı dosyalar</title>
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>
131 <Directory /siteler/htdocs/asis><br/>
132 <indent>SetHandler send-as-is</indent>
138 <section id="programmer">
139 <title>Yazılım Geliştirenler İçin</title>
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
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->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>