Sayfa yükleniyor

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

Ders 69 – Dosya sistemi fonksiyonları

PHP dosya sistemi fonksiyonlarını adım adım öğrenin: file_get_contents, file_put_contents, is_file ve mkdir kullanımı, örnek kodlar ve sık yapılan hatalar.

Ders 69 – Dosya sistemi fonksiyonları

Web uygulamaları geliştirirken dosya sistemi ile etkileşim kaçınılmazdır. Kullanıcıların gönderdiği verileri kaydetmek, log tutmak, dinamik içerik oluşturmak ya da konfigürasyon dosyalarını okumak gibi birçok senaryoda PHP’nin dosya sistemi fonksiyonları devreye girer. Bu derste, file_get_contents, file_put_contents, is_file ve mkdir fonksiyonlarını derinlemesine inceleyecek, gerçek dünya örnekleriyle pekiştirecek ve yaygın hatalardan kaçınmanın yollarını öğreneceksiniz.

Temeller

PHP, dosya sistemiyle çalışmak için çok sayıda yerleşik fonksiyon sunar. Bunların içinde en çok kullanılanlar şunlardır:

  • file_get_contents(string $filename, bool $use_include_path = false, resource $context = null, int $offset = 0, int $maxlen = null): string|false – Bir dosyanın tüm içeriğini bir string olarak okur.
  • file_put_contents(string $filename, mixed $data, int $flags = 0, resource $context = null): int|false – Veriyi bir dosyaya yazar; FILE_APPEND bayrağı ile ekleme yapabilir.
  • is_file(string $filename): bool – Verilen yolun gerçek bir dosya olup olmadığını kontrol eder.
  • mkdir(string $pathname, int $mode = 0777, bool $recursive = false, resource $context = null): bool – Yeni bir dizin oluşturur; $recursive true ise ara dizinleri de oluşturur.

Bu fonksiyonların ortak özelliği, hata yönetiminin geliştirici sorumluluğunda olmasıdır. Fonksiyonlar başarısız olduğunda false döner; bu yüzden === false kontrolü yapılmalı ve gerekirse error_get_last() ile detay alınmalıdır.

Adım adım

Aşağıda, tipik bir dosya okuma‑yazma akışını adım adım açıklıyoruz.

  1. Dosyanın varlığını ve tipini kontrol edin. is_file() ve is_readable() fonksiyonları sayesinde dosyanın gerçekten bir dosya olduğunu ve okunabilir olduğunu teyit edebilirsiniz.
  2. İçeriği okuyun. file_get_contents() ile dosyanın tamamını bir string değişkene aktarın. Küçük (< 2 MB) dosyalar için bu yöntem en pratiktir.
  3. Veriyi işleyin. Okunan metni dizele, JSON’a çevir, satır satır analiz et vb. işlemleri burada yapın.
  4. Yazma iznini kontrol edin. Hedef dizinin is_writable() olup olmadığını kontrol edin. Yoksa chmod() ya da chmod komut satırı ile izinleri ayarlayın.
  5. Veriyi dosyaya yazın. file_put_contents() kullanın. Yeni dosya oluşturulacaksa FILE_APPEND olmadan, var olan dosyaya ekleme yapılacaksa FILE_APPEND bayrağını ekleyin.
  6. Gerekirse dizin oluşturun. Hedef yol mevcut değilse mkdir() ile eksik dizinleri yaratın. $recursive = true parametresi, birden çok eksik ara dizini aynı anda oluşturmanıza olanak tanır.
  7. Hata yönetimi. Her adımda === false kontrolü yapın ve kullanıcıya güvenli bir mesaj gösterin. Geliştirme ortamında error_log() ile detayları loglayın.

Örnek kod

Aşağıdaki örnek, bir log dosyasına gelen veriyi eklerken aynı zamanda dosyanın mevcut olup olmadığını, dizinin yazılabilirliğini ve olası hataları kontrol eder.

<?php
$logDosyasi = __DIR__ . "/logs/app.log";
$logDizin   = dirname($logDosyasi);
$satir      = "[" . date('Y-m-d H:i:s') . "] Kullanıcı girişi\n";

// 1. Dizin var mı? Yoksa oluştur.
if (!is_dir($logDizin)) {
    if (!mkdir($logDizin, 0755, true)) {
        die("Log dizini oluşturulamadı: $logDizin");
    }
}

// 2. Dizin yazılabilir mi?
if (!is_writable($logDizin)) {
    die("Log dizini yazılabilir değil: $logDizin");
}

// 3. Log dosyasına ekle.
$result = file_put_contents($logDosyasi, $satir, FILE_APPEND);
if ($result === false) {
    die("Log dosyasına yazılamadı: $logDosyasi");
}

echo "Log kaydedildi.\n";
?>

İkinci örnek, bir JSON dosyasını okuyup içindeki veriyi diziye dönüştürür, bir öğe ekler ve tekrar dosyaya yazar.

<?php
$jsonDosyasi = __DIR__ . "/data/users.json";

if (!is_file($jsonDosyasi) || !is_readable($jsonDosyasi)) {
    die("JSON dosyası bulunamadı veya okunamıyor.");
}

$icerik = file_get_contents($jsonDosyasi);
if ($icerik === false) {
    die("JSON dosyası okunurken hata oluştu.");
}

$users = json_decode($icerik, true);
if ($users === null && json_last_error() !== JSON_ERROR_NONE) {
    die("JSON ayrıştırma hatası: " . json_last_error_msg());
}

// Yeni bir kullanıcı ekleyelim.
$users[] = [
    "id"   => count($users) + 1,
    "name" => "Yeni Kullanıcı",
    "email"=> "yeni@ornek.com"
];

$newJson = json_encode($users, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
if ($newJson === false) {
    die("JSON kodlama hatası.");
}

if (file_put_contents($jsonDosyasi, $newJson) === false) {
    die("JSON dosyasına yazılamadı.");
}

echo "Kullanıcı başarıyla eklendi.\n";
?>

Sık hatalar

  • İzin sorunları. Çoğu zaman Permission denied hatası, hedef dizinin ya da dosyanın yazılabilir olmamasından kaynaklanır. is_writable() ile ön kontrol yapın.
  • Dosya yolunun hatalı olması. Göreceli yollar __DIR__ gibi sabitlerle birleştirildiğinde hatasız olur. Sabit bir yol kullanıyorsanız, son slash’ı unutmayın.
  • UTF‑8 karakter sorunları. Dosyaya yazarken mb_convert_encoding() ile UTF‑8’e dönüştürmek, özellikle çok‑dilli projelerde veri kaybını önler.
  • Güvenlik açıkları. Kullanıcı girdisini doğrudan dosya ismi olarak kullanmak Directory Traversal saldırılarına kapı açar. basename(), realpath() ve beyaz‑liste kontrolleri uygulayın.
  • Dosya kilitlenmesi. Aynı dosyaya aynı anda birden çok işlem yazıyorsa flock() ile kilitleme yapılmalı, aksi takdirde veri kaybı yaşanabilir.

Özet

Bu derste, PHP’nin temel dosya sistemi fonksiyonlarını hem teorik hem de pratik açıdan ele aldık. file_get_contents ve file_put_contents küçük ve orta ölçekli dosyalar için hızlı bir çözüm sunar; ancak büyük dosyalar için fopen/fread/fwrite akışları tercih edilmelidir. is_file ile dosyanın varlığını ve tipini kontrol etmek, mkdir ile dinamik dizin oluşturmak ve her adımda is_writable, is_readable gibi izin kontrolleri yapmak, hatasız ve güvenli bir dosya yönetimi sağlar.

Unutmayın, dosya sistemi işlemleri uygulamanızın güvenliği ve performansı üzerinde doğrudan etkilidir. Her zaman hata kontrolü, girdi doğrulama ve loglama ilkelerini uygulayın.

SSS

Soru 1: file_get_contents büyük bir dosyayı okurken bellek hatası alıyorum, ne yapmalıyım?

Cevap: Büyük dosyalar için fopen() ile dosyayı satır satır (fgets()) veya blok blok (fread()) okuyun. Böylece tüm dosya belleğe yüklenmez.

Soru 2: file_put_contents ile dosyaya ekleme yaparken aynı anda iki istek geldiğinde veri kaybı oluyor.

Cevap: Yazma işleminden önce flock($fp, LOCK_EX) ile dosyayı kilitleyin, işlem bittiğinde flock($fp, LOCK_UN) ile serbest bırakın.

Soru 3: mkdir() fonksiyonu başarısız oluyor, hata mesajı vermiyor.

Cevap: error_get_last() ile son hatayı alın ve chmod() ile hedef dizinin izinlerini kontrol edin. Ayrıca recursive parametresini true yaparak ara dizinlerin de oluşturulmasını sağlayın.

  • Dosya ve dizin izinlerini her zaman kontrol edin.
  • Kullanıcı girdisini doğrudan dosya yolu olarak kullanmayın.
  • Hata durumunda kullanıcıya teknik detay göstermeyin, loglayın.
  • Gerektiğinde dosya kilitleme (flock) kullanın.
  • Çok büyük dosyalar için akış (stream) fonksiyonlarını tercih edin.
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