Apache Modülü mod_dir

Özet

Bir dizin içerik dosyası şu iki kaynaktan birinden gelebilir:

• Kullanıcı tarafından yazılmış ve ismi genellikleindex.html olan bir dosya. Dosya ismiDirectoryIndex yönergesi ile belirlenir. Bu,mod_dir modülü tarafından denetlenir.
• Aksi takdirde içerik listesi sunucu tarafından üretilir. Bu,mod_autoindex modülü tarafından sağlanır.

Bu iki işlev tamamen birbirinden ayrıdır, dolayısıyla eğer isterseniz kendiliğinden dizin içerik listesi üretimini tamamen iptal edebilirsiniz.

Sunucuhttp://example.com/filanca/birdizin şeklinde bir istek aldığındabirdizin bir dizinin ismiyse ‘bölü çizgisiyle biten’ bir yönlendirme söz konusudur. Dizinler URL sonuna bir bölü çizgisi eklenmesini gerektirir, bu bakımdanmod_dir modülü isteğihttp://example.com/filanca/birdizin/ şeklinde yönlendirir.

Yönergeler

• DirectoryCheckHandler
• DirectoryIndex
• DirectoryIndexRedirect
• DirectorySlash
• FallbackResource

Bulunan hatalar

• httpd günlüğü
• Bilinenler
• Hata bildir

Ayrıca bakınız:

• Yorumlar

DirectoryCheckHandlerYönergesi

DirectoryCheckHandler yönergesi, geçerli URL için başka bir eylemcinin yapılandırılmış olması durumunda,mod_dir modülünün index dosyaları için dizine mi bakacağını yoksa URL'nin sonuna bölü çizgisi mi ekleyeceğini belirler. EylemcilerSetHandler gibi yönergelerle atanabileceği gibi dizin işlemleri sırasındamod_rewrite gibi modüller tarafından da atanabilir.

2.4 öncesi sürümlerde, bir URL için başka bir eylemcinin yapılandılmış olması durumunda bu modül herhangi bir eylemde bulunmaz ve sonuç olarak, tüm dizin için birSetHandler belirtildiği durumda index dosyalarının sunulmasının yanındamod_rewrite gibi modüller de ayrıca bazı çelişkili sonuçlar oluşturabilir.

DirectoryIndexYönergesi

DirectoryIndex yönergesi, istemci, dizinin sonuna bir bölü çizgisi ekleyerek dizin içeriğinin listelenmesini istediğinde bakılmak üzere özkaynakları listeler.yerel-url, sunucu üstünde istenen dizine göreli bir belgenin URL’sidir; normal olarak dizin içindeki bir dosyanın ismidir. Çeşitli URL’ler verilebilirse de sunucu daima ilk bulduğuyla dönecektir. Eğer özkaynakların hiçbiri yoksa veIndexes seçeneği atanmışsa sunucu dizin içeriğinden bir liste üretecektir.

DirectoryIndex index.html

Bu yapılandırmadan sonra yapılan birhttp://sunucum/belgeler/ isteğine karşılık, sunucu, mevcutsahttp://sunucum/belgeler/index.html dosyasını döndürecek, değilse ürettiği dizin içerik listesini gönderecektir.

Belgelerin dizine göreli olmasının gerekmediğine dikkat ediniz.

DirectoryIndex index.html index.txt  /cgi-bin/index.pl

Bu örnekte ise dizin içinde neindex.html ne deindex.txt mevcut olduğunda/cgi-bin/index.pl CGI betiği çalıştırılacaktır.

disabled değeri tek başınamod_dir’in bir dizin listesi aramasını engeller.disabled değiştirgesi öncesinde ve sonrasında başka bir değiştirge hatta birdisabled daha olsa bile sadece birdisabled verilmiş gibi yorumlanır.

Bilginize:Aynı bağlamdaki çok sayıdaDirectoryIndex yönergesi bir öncekini değiştirmek yerine onun bulunduğu listeye eklenir:

# 1. örnek: İçerik dosyası olarak index.html atayıp sonraki satırda buna# index.php'yi ekleyebilirsiniz.<Directory "/foo">    DirectoryIndex index.html    DirectoryIndex index.php</Directory># 2. Örnek: Atamaların tet bir satırda yapıldığı bu örnek 1. örneğe denktir.<Directory "/foo">    DirectoryIndex index.html index.php</Directory># 3. Örnek: Listeyi tamamen değiştirmek için, listeyi önce sıfırlamalısınız:# Bu örnekte içerik dosyası olarak listede sadece index.php kalır.<Directory "/foo">    DirectoryIndex index.html    DirectoryIndex disabled    DirectoryIndex index.php</Directory>

DirectoryIndexRedirectYönergesi

Öntanımlı olarak,DirectoryIndex listeyi istemciye şeffaf olarak seçip gönderir.DirectoryIndexRedirect ise harici bir yönlendirmeye sebep olur.

Bunlardan biri kullanılabilir:

• on: Dizin listesi kaynağına bir 302 yönlendirmesi yapılır.
• off: Bir yönlendirme yapılmaz. mod_dir için eski davranış böyleydi.
• permanent: Dizin listesi kaynağına bir 301 (kalıcı) yönlendirmesi yapılır.
• temp: Buon ile aynı etkiye sahiptir.
• seeother: Dizin listesi kaynağına bir 303 yönlendirmesi ("diğerine bak" olarak da bilinir)yapılır.
• 3xx-code: 3xx kodu ile seçilen yönlendirme yapılır.

DirectoryIndexRedirect on

http://example.com/docs/ için yapılan bir istek,http://example.com/docs/index.html (mevcutsa) adresine geçici bir yönlendirme döndürür.

DirectorySlashYönergesi

DirectorySlash yönergesi, bir dizin isteğinde bulunan URL’lerin sonunamod_dir modülü tarafından bir bölü çizgisi eklenip eklenmeyeceğini belirler.

Normalde, bir kullanıcı sona bir bölü çizgisi eklemeden bir dizin için istekte bulunursamod_dir zaten onu aynı özkaynağa yönlendirir, fakat isteğin sonuna bir bölü çizgisi eklenmesinin bazı iyi sebepleri vardır:

• Kullanıcı bunun sonucunda meşru bir URL ile istekte bulunmuş olur.
• mod_autoindex gerektiği gibi çalışır. Yoksa bağlantıdaki yolu sunamayacağından yanlış yolu gösterirdi.
• DirectoryIndex yönergesi sadece bölü çizgisi ile biten dizin istekleri için değerlendirilir.
• HTML sayfa içindeki göreli URL başvuruları gerektiği gibi çalışacaktır.

Siz yine de bu etkiyi istemezseniz ve yukarıdaki sebepler de size uygun değilse yönlendirmeyi aşağıdaki gibi kapatabilirsiniz. Ancak bunu yaparken dikkatli olun, bununla ilgili bazı güvenlik sorunları olasılığı vardır.

# Aşağıdaki güvenlik uyarısına bakınız!
<Location "/bir/yol">
  DirectorySlash Off
  SetHandler bir-eylemci
</Location>

Bir yönlendirme sözkonusu olduğunda bazı tarayıcıların yanlışlıkla POST isteklerini GET istekleri haline getirme (böylece POST verisi iptal olur) olasılığı olduğuna da dikkat edin.

FallbackResourceYönergesi

Dosya sisteminde bulunmayan bir dosya için istek yapıldığında HTTP'nin 404 (Yok) hatasını döndürmemesi için sunulacak dosyanın yolunu tanımlar. Örnek:

FallbackResource /not-404.php

Bu satırla, (mevcut dosyaları etkilemeden) mevcut olmayan dosyaların yerinenot-404.php dosyası sunulacaktır.

Belli bir dizindeki mevcut bir dosya veya betik için yapılanlar dışındaki tüm isteklerin tek bir dosya veya özkaynakla yerine getirilmesi sıkça istenen bir durum olup bu mekanizmaya 'ön denetleyici' adı verilir.

httpd'nin önceki sürümlerinde bir dosya veya dizinin varlığının sınanması için genelliklemod_rewrite modülü ve-f ve-d kullanımı gerekirdi. Bunun için şimdi tek satırlık bir yapılandırma yeterli olmaktadır.

FallbackResource /index.php

Resim, CSS dosyaları gibi mevcut dosyalar normal olarak sunulur.

Üst dizinden hiçbir şeyin miras alınmaması isteniyorsa bu özelliği kapatmak içindisabled değiştirgesini kullanın.

http://example.com/blog/ gibi bir alt URIyerel-url olarak sağlanır:

<Directory "/web/example.com/htdocs/blog">  FallbackResource /blog/index.php</Directory><Directory "/web/example.com/htdocs/blog/images">  FallbackResource disabled</Directory>

Bir acil durum işleyicisi (yukarıdaki durumda,/blog/index.php) özgün istek URL'sine sunucu değişkeniREQUEST_URI üzerinden erişebilir. Örneğin PHP'de bu değişkene erişmek için$_SERVER['REQUEST_URI'] kullanılır.