DLEFiles API: Modern Dosya Yönetimi

1. Neden DLEFiles?

Eskiden file_put_contents veya unlink kullanırken dosya yolunu tam olarak bilmeniz gerekiyordu. DLEFiles ile DLE'nin ayarlarındaki depolama sürücüsü (Local, FTP, S3 vb.) neyse, eklentiniz otomatik olarak ona uyum sağlar.

2. Temel Fonksiyonlar

Sınıfı kullanmadan önce init etmenize gerek yoktur, DLE bunu otomatik yapar. Ancak özel bir root klasör kullanmak isterseniz DLEFiles::init() çağrılabilir.

Dosya Okuma (Read)

$content = DLEFiles::Read( "test.txt" );
if($content !== false) {
    echo "Dosya içeriği: " . $content;
}

Dosya Yazma / Kaydetme (Save)

$data = "Merhaba Dünya";
$result = DLEFiles::Save( "logs/log_1.txt", $data );

if($result) {
    echo "Başarıyla kaydedildi!";
}

Dosya Silme (Delete)

DLEFiles::Delete( "tmp/temp_file.jpg" );

3. İleri Seviye İşlemler

if( DLEFiles::FileExists("logo.png") ) {
    // İşlem yap
}

$bytes = DLEFiles::Size("data.zip");

Klasör Listeleme (ListDirectory)

Belirli bir klasördeki dosyaları ve alt klasörleri profesyonel bir dizi olarak döner.

$list = DLEFiles::ListDirectory( "photos", ["jpg", "png"] );

foreach($list['files'] as $file) {
    echo "Dosya: " . $file['name'] . " (" . $file['size'] . " bytes)
";
}

4. Güvenlik ve Yol (Path) Yönetimi

DLEFiles otomatik olarak normalize_path() fonksiyonunu kullanır. Ancak yine de şu kurallara dikkat etmelisiniz:

• Dosya yolları her zaman uploads/ klasörüne göre görelidir.
• Sistem dışı klasörlere erişim (örn: ../../etc/passwd) otomatik olarak engellenir.
• Dosya isimlerinde Türkçe karakter veya boşluk kullanmamaya özen gösterin (totranslit() kullanın).