update for sync with English docs

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1908114 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Nilgun Belma Buguner
2023-03-06 08:43:56 +00:00
parent df7ba2d632
commit 4871936594
3 changed files with 133 additions and 77 deletions

View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.tr.xsl"?>
<!-- English Revision: 1901499:1907151 (outdated) -->
<!-- English Revision: 1907151 -->
<!-- =====================================================
Translated by: Nilgün Belma Bugüner <nilgun belgeler.gen.tr>
Reviewed by: Orhan Berent <berent belgeler.gen.tr>
@ -1412,6 +1412,12 @@ EnableSendfile On
&lt;/IfDefine&gt;
</highlight>
<note type="warning"><title>Ek Bilgi</title>
<p>Bu yönerge, çalışma zamanında değil, yapılandırma işlemi sırasında
değerlendirilir. Sonuç olarak, bu yönerge bir <directive type="section"
module="core">If</directive> bölümü içine alınarak koşullu olarak
değerlendirilemez.</p>
</note>
</usage>
</directivesynopsis>
@ -1795,7 +1801,7 @@ ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M"
ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T"
ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'"
ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'"
ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A"
ErrorLogFormat connection "[%{uc}t] [C:%{c}L] remote\ %a local\ %A"
</highlight>
</usage>
@ -2243,6 +2249,14 @@ takdirde uygulanacak yönergeleri barındırır.</description>
yönerge için kullanılabilir olmayacaktır.
</note>
<note type="warning"><directive>Define</directive>,
<directive>Include</directive> ve <directive>Error</directive> gibi
yapılandırma ayrıştırılırken etkili olan yönergeler, bir <directive
type="section">If</directive> yapılandırma bölümü içine alınarak koşullu
hale getirilemez. Bu bölümler, çalışma anında nasıl değerlendirildiklerine
bakılmaksızın, her zaman yapılandırmanın bir parçasıdır.
</note>
</usage>
<seealso><a href="../expr.html">Apache HTTP Sunucusundaki

View File

@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.tr.xsl"?>
<!-- English Revision: 1899270:1908025 (outdated) -->
<!-- English Revision: 1908025 -->
<!-- =====================================================
Translated by: Nilgün Belma Bugüner <nilgun belgeler.gen.tr>
Reviewed by: Orhan Berent <berent belgeler.gen.tr>
@ -102,6 +102,13 @@
Dosya ismine bir sonek eklenmez, ancak biçem dizgesi '%' karakteri
içeriyorsa buna uyulur.</dd>
<dt><code>-T</code></dt>
<dd>Açıldığında ilk günlük dosyası dışındaki tüm dosyaların kırpılmasına
neden olur. Bu, biçem dizgesi ayın günü gibi döngüsel bir şey içerdiğinde
kullanışlıdır. 2.4.56 ve sonrasında mevcuttur.
</dd>
<dt><code><strong>-v</strong></code></dt>
<dd>Standart hataya verilen çıktı daha ayrıntılı olur. Çıktı,
yapılandırma çözümlemesinin sonuçlarını ve tüm dosya açma/kapama
@ -185,7 +192,9 @@
<section id="examples"><title>Örnekler</title>
<example>
<highlight language="config">
CustomLog "|bin/rotatelogs /var/log/logfile 86400" common
</highlight>
</example>
<p>nnnn, günlük kaydının başladığı sistem zamanı olmak üzere
@ -195,7 +204,9 @@
yeni bir günlük dosyasıılır.</p>
<example>
<highlight language="config">
CustomLog "|bin/rotatelogs -l /var/log/logfile.%Y.%m.%d 86400" common
</highlight>
</example>
<p>yyyy, yıl; mm, ay; dd, ayın gününü belirtmek üzere
@ -203,27 +214,45 @@
geceyarısı yeni bir günlük dosyasına geçilecektir.</p>
<example>
<highlight language="config">
CustomLog "|bin/rotatelogs /var/log/logfile 5M" common
</highlight>
</example>
<p>Günlük dosyası 5 megabaytlık olunca yenisinin oluşturulmasını sağlar.
</p>
<example>
<highlight language="config">
ErrorLog "|bin/rotatelogs /var/log/errorlog.%Y-%m-%d-%H_%M_%S 5M"
</highlight>
</example>
<p>Hata günlüğünün 5 megabaytta bir
<code>errorlog.YYYY-mm-dd-HH_MM_SS</code> biçemli bir isimle
oluşturulmasını sağlar.</p>
<example>
<highlight language="config">
CustomLog "|bin/rotatelogs -t /var/log/logfile 86400" common
</highlight>
</example>
<p>/var/log/logfile dosyasını oluşturur, sunucu başlatılırken ve günde
<p><code>/var/log/logfile</code> dosyasını oluşturur, sunucu başlatılırken ve günde
bir kere dosyanın tepesi kırpılır. Bu senaryoda ayrı bir sürecin (tail
gibi) dosyayı gerçek zamanlı işleyeceği umulur.</p>
<example>
<highlight language="config">
CustomLog "|bin/rotatelogs -T /var/log/logfile.%d 86400" common
</highlight>
</example>
<p>Sunucu ayın birinde başlatılırsa (veya yeniden başlatılırsa), bu,
<code>/var/log/logfile.01</code> dosyasının sonuna eklenir. Ayın ikinci
günü bir günlük girişi yazıldığında, <code>/var/log/logfile.02</code>
kırpılır ve en üste yeni girdiler eklenir. Bu örnek, özel bir bakım
gerektirmeden yaklaşık 1 aylık günlük tutar.</p>
</section>
<section id="portability"><title>Taşınabilirlik</title>

View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.tr.xsl"?>
<!-- English Revision: 1869920:1905717 (outdated) -->
<!-- English Revision: 1905717 -->
<!-- =====================================================
Translated by: Nilgün Belma Bugüner <nilgun belgeler.gen.tr>
Reviewed by: Orhan Berent <berent belgeler.gen.tr>
@ -395,9 +395,9 @@ ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofail
module="core">If</directive> bölümü <directive type="section"
module="core">Directory</directive>, <directive type="section"
module="core">Location</directive> ve <directive
type="section" module="core">Files</directive> bölümlerinde bulunabilir fakat
başka bir <directive type="section" module="core">If</directive> bölümünün
içinde bulunamaz. Bu bölümlerin düzenli ifadeli türevleri de benzer tarzda
type="section" module="core">Files</directive> bölümlerinde bulunabilir fakat
başka bir <directive type="section" module="core">If</directive> bölümünün
içinde bulunamaz. Bu bölümlerin düzenli ifadeli türevleri de benzer tarzda
davranır.</p>
<p>İç içe bölümler, aynı türdeki iç içe olmayan bölümlerin sonrasına
@ -492,7 +492,9 @@ ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofail
ve <directive type="section" module="core">LocationMatch</directive>
aynı anda işleme sokulur.</li>
<li><directive type="section" module="core">If</directive>
<li><directive type="section" module="core">If</directive> bölümleri,
önceki bağlamlardan herhangi birinin içine alınmış olsalar bile.
</li>
</ol>
@ -500,35 +502,46 @@ ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofail
<ul>
<li><directive type="section" module="core">Directory</directive>
bölümündekiler hariç, her grup, yapılandırma dosyasında bulundukları
sıraya göre işleme sokulurlar. Örneğin, 4. grupta <em>/foo/bar</em> için yapılan
bir istek <code>&lt;Location "/foo/bar"&gt;</code> ve <code>&lt;Location
"/foo"&gt;</code> bölümleriyle de eşleşir ve bunlar yapılandırma
sıraya göre işleme sokulurlar. Örneğin, 4. grupta <em>/foo/bar</em> için yapılan
bir istek <code>&lt;Location "/foo/bar"&gt;</code> ve <code>&lt;Location
"/foo"&gt;</code> bölümleriyle de eşleşir ve bunlar yapılandırma
dosyalarında bulundukları sıraya göre değerlendirilir.</li>
<li>Yukarıda 1. grup olan <directive type="section"
module="core">Directory</directive> bölümü en kısa dizin elemanından en uzun
dizin elemanına doğru işleme sokulur. Yani, örneğin, <code>&lt;Directory
"/var/web/dir"&gt;</code> bölümü <code>&lt;Directory
<li>Yukarıda 1. grup olan <directive type="section"
module="core">Directory</directive> bölümü en kısa dizin elemanından en uzun
dizin elemanına doğru işleme sokulur. Yani, örneğin, <code>&lt;Directory
"/var/web/dir"&gt;</code> bölümü <code>&lt;Directory
"/var/web/dir/subdir"&gt;</code> bölümünden önce işleme sokulacaktır.</li>
<li>Eğer aynı dizin için birden fazla <directive type="section"
module="core">Directory</directive> bölümü varsa bunlar yapılandırma
<li>Eğer aynı dizin için birden fazla <directive type="section"
module="core">Directory</directive> bölümü varsa bunlar yapılandırma
dosyasında bulundukları sıraya göre işleme sokulurlar.</li>
<li><directive module="core">Include</directive> yönergeleri ile
yapılandırmaya dahil edilen dosyaların içerikleri <directive
module="core">Include</directive> yönergesinin bulunduğu yere konulduktan
<li><directive module="core">Include</directive> yönergeleri ile
yapılandırmaya dahil edilen dosyaların içerikleri <directive
module="core">Include</directive> yönergesinin bulunduğu yere konulduktan
sonra işleme sokulurlar.</li>
<li><directive type="section" module="core">VirtualHost</directive>
bölümlerinin içindeki bölümler, sanal konak tanımı dışındaki
karşılıklarından <em>sonra</em> uygulanırlar. Bu yöntemle ana sunucu
karşılıklarından <em>sonra</em> uygulanırlar. Bu yöntemle ana sunucu
yapılandırmasındaki tanımlar geçersiz kılınabilir</li>
<li>İstek <module>mod_proxy</module> tarafından sunulduğu takdirde,
<directive module="mod_proxy" type="section">Proxy</directive> taşıyıcısı
işlem sırasında <directive module="core" type="section"
>Directory</directive> taşıyıcısının yerini alır.</li>
<li>katıştırma düzeni üzerindeki etkisi nedeniyle, ilgili yapılandırma
yönergelerini <directive type="section" module="core">If</directive>'in
içinde ve dışında karıştırırken dikkatli olunmalıdır. Doğrudan
<directive type="section" module="core" >Else</directive> kullanımının
yardımı olabilir.</li>
<li><code>.htaccess</code> içinde <directive type="section"
module="core">If</directive> kullanıldığında, üst dizindeki sarmalanmış
yönergeler, alt dizinde sarmalanmamış yönergelerden <em>sonra</em>
birleştirilir.</li>
</ul>
<note><title>Bazı Teknik Bilgiler</title>
@ -540,35 +553,35 @@ ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofail
tamamen elden çıkarılır.
</note>
<section id="relationship-module-configuration"><title>Modüllerle
<section id="relationship-module-configuration"><title>Modüllerle
yapılandırma bölümleri arasındaki ilişki</title>
<p>Yapılandırma bölümlerini okurken örneğin <module>mod_rewrite</module>
gibi belli modüllerin yönergelerinin bu bölümlere nasıl katılacağı ve
ne zaman nasıl işleneceği gibi sorular sıkça aklımızdan geçer. Bunun
belli bir yanıtı yoktur ve biraz temel bilgi gerektirir. Her httpd
modülü yapılandırmasını kendi yönetir ve httpd.conf içindeki
yönergelerinin her biri belli bir bağlamdaki bir yapılandırmayı
<p>Yapılandırma bölümlerini okurken örneğin <module>mod_rewrite</module>
gibi belli modüllerin yönergelerinin bu bölümlere nasıl katılacağı ve
ne zaman nasıl işleneceği gibi sorular sıkça aklımızdan geçer. Bunun
belli bir yanıtı yoktur ve biraz temel bilgi gerektirir. Her httpd
modülü yapılandırmasını kendi yönetir ve httpd.conf içindeki
yönergelerinin her biri belli bir bağlamdaki bir yapılandırmayı
belirtir. httpd bir komutu okunduğu sırada çalıştırmaz.</p>
<p>Çalışma anında, httpd çekirdeği geçerli isteğe hangilerinin
uygulanacağını belirlemek için yukarıda açıklanan sırada tanımlı
yapılandırma bölümlerini tekrar tekrar okur. Eşleşen ilk bölümün bu
istek için geçerli yapılandırmayı içerdiği varsayılır. Eğer alt
bölümlerden biri de eşleşmişse bu bölümlerde yönergeleri bulunan her
modüle yapılandırmasını iki bölüm arasında katıştırma şansı verilir.
Sonuç üçüncü bir yapılandırma olup işlem bütün yapılandırma bölümleri
<p>Çalışma anında, httpd çekirdeği geçerli isteğe hangilerinin
uygulanacağını belirlemek için yukarıda açıklanan sırada tanımlı
yapılandırma bölümlerini tekrar tekrar okur. Eşleşen ilk bölümün bu
istek için geçerli yapılandırmayı içerdiği varsayılır. Eğer alt
bölümlerden biri de eşleşmişse bu bölümlerde yönergeleri bulunan her
modüle yapılandırmasını iki bölüm arasında katıştırma şansı verilir.
Sonuç üçüncü bir yapılandırma olup işlem bütün yapılandırma bölümleri
değerlendirilene kadar sürer.</p>
<p>Yukarıdaki adımların ardından HTTP isteğiyle ilgili "asıl" işlem
başlar: her modül ondan istenen görevleri gerçekleştirme şansına sahip
olur. Nasıl davranacaklarını belirlemek için kendilerinin katıştırılmış
<p>Yukarıdaki adımların ardından HTTP isteğiyle ilgili "asıl" işlem
başlar: her modül ondan istenen görevleri gerçekleştirme şansına sahip
olur. Nasıl davranacaklarını belirlemek için kendilerinin katıştırılmış
son yapılandırmalarını http çekirdeğinden alabilirler.</p>
<p>Sürecin tamamı bir örnekle görselleştirilebilir. Aşağıdaki örnekte
belli bir HTTP başlığını ayarlamak için <module>mod_headers</module>
modülünün <directive module="mod_headers">Header</directive> yönergesi
kullanılmıştır. <code>/example/index.html</code> isteği için httpd
<p>Sürecin tamamı bir örnekle görselleştirilebilir. Aşağıdaki örnekte
belli bir HTTP başlığını ayarlamak için <module>mod_headers</module>
modülünün <directive module="mod_headers">Header</directive> yönergesi
kullanılmıştır. <code>/example/index.html</code> isteği için httpd
<code>CustomHeaderName</code> başlığına hangi değeri atayacaktır?
</p>
<highlight language="config">
@ -583,40 +596,40 @@ ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofail
&lt;Directory "/example"&gt;
Header set CustomHeaderName iki
&lt;/Directory&gt;
</highlight>
</highlight>
<ul>
<li><directive>Directory</directive> "/" eşleşir ve ilk yapılandırma
olarak <code>CustomHeaderName</code> başlığı <code>bir</code>
<li><directive>Directory</directive> "/" eşleşir ve ilk yapılandırma
olarak <code>CustomHeaderName</code> başlığı <code>bir</code>
değeriyle oluşturulur.</li>
<li><directive>Directory</directive> "/example" eşleşir ve
<module>mod_headers</module> modülünün koduna göre bir katıştırma
durumundan yeni değer eskiyi geçersiz kılacağından yeni bir
yapılandırma ile <code>CustomHeaderName</code> başlığının değeri
<li><directive>Directory</directive> "/example" eşleşir ve
<module>mod_headers</module> modülünün koduna göre bir katıştırma
durumundan yeni değer eskiyi geçersiz kılacağından yeni bir
yapılandırma ile <code>CustomHeaderName</code> başlığının değeri
<code>iki</code> yapılır.</li>
<li><directive>FilesMatch</directive> ".*" eşleşir ve başka bir
katıştırma fırsatı doğar: <code>CustomHeaderName</code> başlığının
<li><directive>FilesMatch</directive> ".*" eşleşir ve başka bir
katıştırma fırsatı doğar: <code>CustomHeaderName</code> başlığının
değeri <code>yedi</code> yapılır.</li>
<li>Neticede HHP isteğinin sonraki adımlarında
<module>mod_headers</module> çağrılıp <code>yedi</code> değeri
atanmış <code>CustomHeaderName</code> başlığını işleme sokması
istenecektir. <module>mod_headers</module> normalde işini yapmak
için bu yapılandırmayı kullanacaktır. Fakat bundan, bir yönergenin
gerekli olmaması veya kullanımdan kaldırılması ve benzeri nedenlerle
yapılandırmada iptal edilmesi gibi daha karmaşık bir eylemi bir
<li>Neticede HHP isteğinin sonraki adımlarında
<module>mod_headers</module> çağrılıp <code>yedi</code> değeri
atanmış <code>CustomHeaderName</code> başlığını işleme sokması
istenecektir. <module>mod_headers</module> normalde işini yapmak
için bu yapılandırmayı kullanacaktır. Fakat bundan, bir yönergenin
gerekli olmaması veya kullanımdan kaldırılması ve benzeri nedenlerle
yapılandırmada iptal edilmesi gibi daha karmaşık bir eylemi bir
modülün gerçekleştiremeyeceği anlamı çıkarılmamalıdır.</li>
</ul>
<p><directive>Directory</directive> ile aynı katıştırma sırasından dolayı
bu durum .htaccess için de geçerlidir. Burada anlaşılması gereken husus,
<directive>Directory</directive> ve <directive>FilesMatch</directive>
gibi yapılandırma bölümlerinin <directive
module="mod_headers">Header</directive> veya <directive
module="mod_rewrite">RewriteRule</directive> gibi modüle özgü
yönergelerle karşılaştırılmamasıdır, çünkü bunlar farklı seviyelerde
<p><directive>Directory</directive> ile aynı katıştırma sırasından dolayı
bu durum .htaccess için de geçerlidir. Burada anlaşılması gereken husus,
<directive>Directory</directive> ve <directive>FilesMatch</directive>
gibi yapılandırma bölümlerinin <directive
module="mod_headers">Header</directive> veya <directive
module="mod_rewrite">RewriteRule</directive> gibi modüle özgü
yönergelerle karşılaştırılmamasıdır, çünkü bunlar farklı seviyelerde
işlem görür.
</p>
</section>