Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 70 – Dizin dolaşma

PHP ile dosya ve klasörleri güvenli bir şekilde taramak, scandir, DirectoryIterator ve RecursiveDirectoryIterator kullanımlarını adım adım öğrenin.

Ders 70 – Dizin dolaşma

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; RecursiveIteratorIterator ile birleştirildiğinde tam bir dosya sistemi gezgini elde edilir.
  • Güvenlik: Kullanıcı girdileriyle oluşturulan yol (path) değerlerini mutlaka doğrulamalı, realpath ve basename gibi 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: scandir varsayılan olarak gizli (dot) dosyaları listeler; iterator'larda SKIP_DOTS kullanmazsanız . ve .. ile karşılaşabilirsiniz.
  • İzin hataları (Permission denied): Sunucu kullanıcı hesabının okuma izni olmadığı dizinlerde DirectoryIterator bir UnexpectedValueException fırlatır. isReadable() kontrolü ekleyin.
  • Performans düşüklüğü: Çok büyük dosya sistemlerinde scandir tü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. realpath ile 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:

  1. scandir – en basit, dizi döndürür, küçük ve tek seviye dizinler için uygundur.
  2. DirectoryIterator – nesne tabanlı, dosya meta verilerine hızlı erişim sağlar.
  3. 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 realpath ile mutlak yolu alın, ardından bu yolu izin verilen kök dizinle strpos ya da strncmp ile karşılaştırın. basename ve filter_var de ek koruma sağlar.

Kontrol Listesi

  • Kod örneklerini php -d display_errors=0 script.php ile çalıştırıp hatasız çıktıyı doğrulayın.
  • Kullanıcı girdisi varsa realpath ve basename ile temizleyin.
  • Üretim ortamında ini_set('display_errors', '0'); ve error_log kullanın.
  • Gerekli izinleri isReadable() ve chmod ile kontrol edin.
  • Performans testi için 10.000+ dosya içeren bir klasörde iterator'ı deneyin.
Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

PHP serisinin son dersinde ileri seviye konular, framework seçimi, Composer ekosistemi, mikro pro…

Ders 99 – Güvenli yapılandırma kontrol listesi

Üretim ortamı için PHP yapılandırma ayarlarını adım adım kontrol eden, hatasız ve güvenli bir yap…

Ders 98 – OpCache ve performans ipuçları

OpCache'ın çalışma prensibi, yapılandırma adımları ve gerçek dünyada performans artırmak için pra…

Ders 97 – Fibers’a kısa bakış (PHP 8.1)

PHP 8.1 ile gelen Fibers özelliğini adım adım öğrenin, kooperatif concurrency kavramını kavrayın …

Demo
Büyütülmüş Görsel