1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
|
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.tr.xsl"?>
<!-- English Revision: 1174747:1727637 (outdated) -->
<!-- =====================================================
Translated by: Nilgün Belma Bugüner <nilgun belgeler.org>
Reviewed by: Orhan Berent <berent belgeler.org>
========================================================== -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<modulesynopsis metafile="mod_so.xml.meta">
<name>mod_so</name>
<description>Modüllerin ve çalıştırılabilir kodun sunucunun başlatılması veya
yeniden başlatılması sırasında yüklenmesini sağlar.</description>
<status>Extension</status>
<sourcefile>mod_so.c</sourcefile>
<identifier>so_module</identifier>
<compatibility>Windows için bu bir temel modüldür (sunucu bunu daima içerir).</compatibility>
<summary>
<p>Seçilen işletim sistemleri üzerinde bu modül Apache HTTP Sunucusunun
yeniden derlenmesini gerektirmeden modüllerin <a href="../dso.html"
>Devingen Paylaşımlı Nesne</a> (DSO) mekanizması üzerinden
kullanılabilmesini sağlar.</p>
<p>Unix’te yüklenen kod genellikle paylaşımlı nesne dosyalarından
(<code>.so</code> uzantılı dosyalar), Windows’ta ise ya <code>.so</code>
ya da <code>.dll</code> uzantılı dosyalardan gelir.</p>
<note type="warning"><title>Uyarı</title>
<p>Apache HTTP Sunucusunun ana sürümlerinden biri (1.3, 2.0, 2.2, 2.4 gibi)
için derlenmiş modüller genelde bir diğerinde çalışmaz. Genellikle
aralarında API değişikliği sözkonusu olduğundan çalışması için modüllerde
yeni sürüme göre değişiklik yapılması gerekir.</p>
</note>
</summary>
<section id="windows">
<title>Yüklenebilir Modüllerin Windows için Oluşturulması</title>
<note><title>Bilginize</title>
<p>Windows üzeinde yüklenebilir dosyalar genelde <code>.dll</code> sonekini
alırlar. Apache httpd modülleri ise diğer platformlardaki gibi
<code>mod_filanca.so</code> biçeminde isimlendirilmektedir. Bununla
birlikte, üçüncü parti modüllerden bazılarının (PHP gibi) hala
<code>.dll</code> sonekini kullandığı görülmektedir.</p>
<p><code>mod_so</code> modülü <code>ApacheModuleFoo.dll</code> biçeminde
isimlendirilmiş modülleri hala yüklemekteyse de yeni adlandırma uzlaşımı
tercih edilmelidir. Yüklenebilir modülleri 2.0’a dönüştürüyorsanız,
lütfen isimlerini de 2.0 uzlaşımına uygun hale getiriniz.</p></note>
<p>Apache httpd modül programlama arayüzü Unix ve Windows sürümleri
arasında değişiklik göstermez. Unix için kullanılan çoğu modül hiç
değişiklik yapmadan ya da çok küçük bir değişiklikle Windows’ta da
çalışmaktadır. Çalışmayanlar Unix platformunun sahip olduğu ancak Windows
platformunun sahip olmadığı nitelikleri kullanan modüllerdir.</p>
<p>Bir modül Windows’ta çalıştığı zaman, sunucuya iki şekilde
yüklenebilir. Unix’te olduğu gibi, doğrudan sunucunun içinde
derlenebilir. Windows için hazırlanan Apache httpd paketi, Unix için
geçerli olan <code>Configure</code> betiğini içermediğinden modülün
kaynak dosyası ApacheCore proje dosyasına, sembolleri de
<code>os\win32\modules.c</code> dosyasına eklenmelidir.</p>
<p>İkinci yol ise modülü bir paylaşımlı kütüphane olarak çalışma anında
<directive module="mod_so">LoadModule</directive> yönergesi ile yüklemek
için bir DLL olarak derlemektir. Bu DLL modüller dağıtılabilir ve
sunucuyu yeniden derlemek gerekmeksizin her Windows için Apache httpd
kurulumunda çalışabilir.</p>
<p>Bir modül DLL’i oluşturmak için modülün kaynak dosyasında küçük bir
değişiklik yapmak gerekir: Modül kaydının daha sonra oluşturulacak olan
DLL’den ihraç edilebilmesi gerekir (aşağıya bakınız). Bunu yapmak için
modülün modül kaydı tanımına (Apache httpd başlık dosyalarında
tanımlanmış olan) <code>AP_MODULE_DECLARE_DATA</code> eklenmelidir.
Örneğin, modülünüz</p>
<example>
module foo_module;
</example>
<p>diye bir satır içeriyorsa bunu,</p>
<example>
module AP_MODULE_DECLARE_DATA foo_module;
</example>
<p>olarak değiştirmelisiniz. Bunun yalnız Windows üzerinde etkili olduğunu
ve Unix için modül kodunda bir değişiklik gerekmediğini unutmayınız.
Ayrıca, <code>.DEF</code> dosyaları hakkında bilgi sahibi iseniz modül
kodunda değişiklik yapmak yerine modül kaydını bu yöntemle de ihraç
edebilirsiniz.</p>
<p>Artık modülü içeren bir DLL oluşturmaya hazırsınız. Bunu, libhttpd.dll
paylaşımlı kütüphanesi derlenirken oluşturulan libhttpd.lib ihraç
kütüphanesi ile ilintilemeniz gerekecektir. Ayrıca, Apache httpd başlık
dosyalarının doğru konumlandığından emin olmak için derleyici
seçeneklerinde değişiklik yapmanız gerekebilir. Bu kütüphaneyi
sunucunuzun kök dizini altındaki <code>modules</code> dizininde
bulabilirsiniz. En iyisi derleme ortamının doğru yapılandırıldığından
emin olmak için ya ağaçta mevcut modüllerden birinin <code>.dsp</code>
dosyasını gaspedersiniz ya da kendi <code>.dsp</code> dosyanızın
ilintileme seçenekleriyle derleyicininkileri karşılaştırırsınız.</p>
<p>Artık modülünüzün DLL sürümünü oluşturmalısınız. DLL’i sunucunuzun kök
dizininin altında bulunan <code>modules</code> dizinine yerleştirdikten
sonra <directive>LoadModule</directive> yönergesi ile sunucunuza
yükleyebilirsiniz.</p>
</section>
<directivesynopsis>
<name>LoadFile</name>
<description>Belirtilen nesne dosyasını veya kütüphaneyi sunucu ile ilintiler.
</description>
<syntax>LoadFile <em>dosya-ismi</em> [<em>dosya-ismi</em>] ...</syntax>
<contextlist>
<context>server config</context>
</contextlist>
<usage>
<p><directive>LoadFile</directive> yönergesi ismi belirtilen kütüphaneleri
veya nesne dosyalarını sunucu başlatılırken veya yeniden başlatılırken
sunucu ile ilintiler. Yönerge, bazı modüllerin çalışması sırasında
gereken ek kodların yüklenmesi için kullanılır.
<code><em>dosya-ismi</em></code> olarak mutlak bir dosya yolu
belirtilebileceği gibi <directive module="core">ServerRoot</directive>’a
göreli bir dosya yolu da belirtilebilir.</p>
<p>Örnek:</p>
<example>LoadFile libexec/libxmlparse.so</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LoadModule</name>
<description>Belirtilen nesne dosyasını veya kütüphaneyi sunucu ile ilintiler
ve etkin modül listesine ekler.</description>
<syntax>LoadModule <em>modül dosya-ismi</em></syntax>
<contextlist>
<context>server config</context>
</contextlist>
<usage>
<p><directive>LoadModule</directive> yönergesi
<code><em>dosya-ismi</em></code> ile belirtilen nesne dosyasını veya
kütüphaneyi sunucu ile ilintiler ve etkin modül listesine belirtilen
<code><em>modül</em></code> ismiyle ekler. <code><em>modül</em></code>,
modülün kaynak dosyasında <code>module</code> türündeki tek harici
değişkenin ismi olup modül belgelerinde <a
href="module-dict.html#ModuleIdentifier" >Modül Betimleyici</a> olarak
geçer. Örneğin,</p>
<example>
LoadModule status_module modules/mod_status.so
</example>
<p>satırı ile ismi belirtilen dosya <directive
module="core">ServerRoot</directive> dizini altındaki
<code>modules</code> alt dizininden yüklenir.</p>
</usage>
</directivesynopsis>
</modulesynopsis>
|