Web uygulamalarında dosya ve klasör yapısını dinamik olarak keşfetmek sıkça ihtiyaç duyulan bir işlemdir. Kullanıcıların yüklediği dosyaları listelemek, yedekleme scriptleri oluşturmak ya da bir dizindeki tüm PHP dosyalarını taramak gibi senaryolarda dizin dolaşma (directory traversal) tekniklerini doğru bir şekilde kullanmak, hem performans hem de güvenlik açısından kritik öneme sahiptir. Bu derste, PHP'nin yerleşik scandir fonksiyonundan SPL (Standard PHP Library) iterator'larına kadar tüm seçenekleri inceleyecek, her birinin avantajlarını ve sınırlamalarını öğreneceksiniz.
Temel Kavramlar
- scandir: Basit bir dizi döndürür,
.ve..gibi özel girdileri içerir. - DirectoryIterator: SPL iterator'ı, dosya bilgilerine (boyut, tip, izinler vb.) nesne üzerinden erişim sağlar.
- RecursiveDirectoryIterator: Alt dizinleri de dahil ederek ağaç yapısını derinlemesine tarar;
RecursiveIteratorIteratorile birleştirildiğinde tam bir dosya sistemi gezgini elde edilir. - Güvenlik: Kullanıcı girdileriyle oluşturulan yol (path) değerlerini mutlaka doğrulamalı,
realpathvebasenamegibi fonksiyonlarla temizlemelisiniz.
Adım Adım Dizin Dolaşma
Bu bölümde, üç farklı yöntemi sırasıyla uygulayacağız. Her adımda kodun ne yaptığını açıklayan yorum satırları ekleyeceğiz.
1. scandir ile Basit Listeleme
Bu yöntem sadece dosya ve klasör adlarını verir; dosya boyutu, tip ya da izin bilgisine ulaşmak için ek stat çağrıları gerekir.
2. DirectoryIterator ile Nesne Tabanlı Yaklaşım
isDot()) {
continue;
}
// Dosya mı, klasör mü? ve boyutu göster
if ($fileInfo->isFile()) {
echo "[F] " . $fileInfo->getFilename() . " (" . $fileInfo->getSize() . " bytes)\n";
} elseif ($fileInfo->isDir()) {
echo "[D] " . $fileInfo->getFilename() . "\n";
}
}
?>
Iterator sayesinde isFile(), isDir(), getSize() gibi faydalı metodları tek satırda çağırabiliyoruz. Büyük dizinlerde bellek tüketimi daha düşüktür çünkü her seferinde tüm listeyi belleğe yüklemez.
3. RecursiveDirectoryIterator ile Tam Ağaç Tarama
getExtension() === 'php') {
echo $file->getRealPath() . "\n";
}
}
?>
Yukarıdaki kod, __DIR__ altındaki tüm alt klasörleri dolaşır ve .php uzantılı dosyaların gerçek yolunu ekrana basar. FilesystemIterator::SKIP_DOTS bayrağı . ve .. girdilerini otomatik olarak filtreler.
Sık Karşılaşılan Hatalar ve Çözüm Önerileri
- Gizli dosyalar atlanıyor:
scandirvarsayılan olarak gizli (dot) dosyaları listeler; iterator'lardaSKIP_DOTSkullanmazsanız.ve..ile karşılaşabilirsiniz. - İzin hataları (Permission denied): Sunucu kullanıcı hesabının okuma izni olmadığı dizinlerde
DirectoryIteratorbirUnexpectedValueExceptionfırlatır.isReadable()kontrolü ekleyin. - Performans düşüklüğü: Çok büyük dosya sistemlerinde
scandirtüm listeyi belleğe alır. SPL iterator'ları tercih edin. - Güvenlik açıkları: Kullanıcıdan gelen yol parametresi
../gibi üst dizin geçişi içerebilir.realpathile mutlak yol elde edip, izin verilen kök dizinle karşılaştırın.
Özet
Bu derste, PHP'de dizin dolaşmanın üç temel yöntemini inceledik:
scandir– en basit, dizi döndürür, küçük ve tek seviye dizinler için uygundur.DirectoryIterator– nesne tabanlı, dosya meta verilerine hızlı erişim sağlar.RecursiveDirectoryIterator+RecursiveIteratorIterator– çok katmanlı ağaçları taramak ve filtrelemek için en güçlü çözümdür.
Doğru yöntemi seçmek, projenizin ölçeği, performans gereksinimleri ve güvenlik politikalarına bağlıdır. Unutmayın, her zaman kullanıcı girdilerini doğrulayın ve üretim ortamında hata mesajlarını log dosyalarına yönlendirin.
SSS
- 1. scandir neden
.ve..döndürür? - UNIX dosya sisteminde bu iki girdi mevcut dizin ve üst dizini temsil eder. Çoğu senaryoda filtrelenmeleri gerekir.
- 2. Iterator'lar bellek tüketimini nasıl azaltır?
- Iterator'lar veriyi tek tek üretir (lazy loading). Tüm dosya listesini bir kerede belleğe almaz, bu da büyük ağaçlarda RAM kullanımını düşürür.
- 3. Kullanıcıdan gelen bir yolun güvenliğini nasıl kontrol ederim?
- Öncelikle
realpathile mutlak yolu alın, ardından bu yolu izin verilen kök dizinlestrposya dastrncmpile karşılaştırın.basenamevefilter_varde ek koruma sağlar.
Kontrol Listesi
- Kod örneklerini
php -d display_errors=0 script.phpile çalıştırıp hatasız çıktıyı doğrulayın. - Kullanıcı girdisi varsa
realpathvebasenameile temizleyin. - Üretim ortamında
ini_set('display_errors', '0');veerror_logkullanın. - Gerekli izinleri
isReadable()vechmodile kontrol edin. - Performans testi için 10.000+ dosya içeren bir klasörde iterator'ı deneyin.
Yorumlar
Henüz onaylanmış yorum yok. İlk yorumu siz yazın.
Yorum yaz
Yorumunuz yönetici onayından sonra yayınlanır.