Bir dosyanın adının .jpg ile bitmesi, gerçekten JPEG görüntü olduğu anlamına gelmez. Tarayıcının gönderdiği MIME bilgisi de güvenilir doğrulamanın yerine geçmez. PHP’de yükleme akışı; istek hatası, boyut, dosya türü, depolama konumu ve erişim yetkisini birlikte yönetmelidir. Aşağıdaki örnek, yalnızca PNG ve JPEG kabul eden sınırlı bir yükleme işleminin temelini gösterir.

Depolama kararını önce verin

Yüklenen dosyaları mümkünse doğrudan çalıştırılabilir web dizininden ayrı bir alanda tutun. Dosyaya erişim gerekiyorsa uygulama üzerinden yetki ve doğru Content-Type kontrolüyle sunulabilir. Upload klasöründe PHP veya başka betiklerin çalışmasına izin vermemek, ad denetiminden bağımsız bir sunucu önlemidir.

Kullanıcının orijinal dosya adını depolama yolu olarak kullanmayın. Rastgele sunucu adı üretin ve gerekiyorsa orijinal adı veritabanında bilgi olarak saklayın. Böylece yol karakterleri, aynı isimli dosyanın üzerine yazılması ve tahmin edilebilir erişim gibi sorunların bir bölümü azaltılır. Dosya adı rastgele olsa bile özel bir dosyanın yetkisiz erişimi ayrıca engellenmelidir.

PHP hata kodunu değerlendirin

$_FILES içindeki error alanını kontrol edin. Boyut sınırı, kısmi yükleme veya hiç dosya seçilmemesi aynı durum değildir. Çok büyük POST isteğinde beklenen alanlar hiç oluşmayabilir. Sunucudaki post_max_size ve upload_max_filesize sınırlarını uygulama sınırıyla uyumlu tutun.

Örnekte kullanıcı oturum ve CSRF kontrolünden geçtikten sonra bu bölüme ulaşıyor varsayılır. Kod tek başına giriş, oran sınırlaması veya dosya sunma sistemi kurmaz. $storage dizini web kökünün dışında, yönetici tarafından önceden oluşturulmuş ve uygun izinlerle sınırlandırılmış olmalıdır.

<?php
$upload = $_FILES['image'] ?? null;
if (!is_array($upload)
    || !isset($upload['error'], $upload['tmp_name'])
    || !is_int($upload['error'])
    || !is_string($upload['tmp_name'])
    || $upload['error'] !== UPLOAD_ERR_OK) {
    throw new RuntimeException('Dosya yüklenemedi.');
}
$tmp = $upload['tmp_name'];
if (!is_uploaded_file($tmp)) {
    throw new RuntimeException('Geçersiz yükleme.');
}
$size = filesize($tmp);
if ($size === false || $size < 1 || $size > 2 * 1024 * 1024) {
    throw new RuntimeException('Dosya en fazla 2 MB olabilir.');
}
$mime = (new finfo(FILEINFO_MIME_TYPE))->file($tmp);
$types = ['image/jpeg' => 'jpg', 'image/png' => 'png'];
if (!is_string($mime) || !isset($types[$mime])) {
    throw new RuntimeException('Yalnızca JPEG veya PNG kabul edilir.');
}
$info = getimagesize($tmp);
if ($info === false || $info[0] < 1 || $info[1] < 1
    || $info[0] > 6000 || $info[1] > 6000) {
    throw new RuntimeException('Görüntü boyutları uygun değil.');
}
$storage = '/srv/app-private/uploads';
if (!is_dir($storage) || !is_writable($storage)) {
    throw new RuntimeException('Depolama alanı kullanılamıyor.');
}
$name = bin2hex(random_bytes(24)) . '.' . $types[$mime];
if (!move_uploaded_file($tmp, $storage . DIRECTORY_SEPARATOR . $name)) {
    throw new RuntimeException('Dosya kaydedilemedi.');
}

MIME kontrolünün sınırını bilin

finfo dosya içeriğinden tür belirlemeye yardım eder; bu sonuç tek başına dosyanın bütün risklerden arındığını kanıtlamaz. Görüntüleri gerçek yayın akışında güvenilir bir kütüphaneyle yeniden çözümleyip kodlamak, metadata politikası ve piksel sınırları eklemek gerekebilir. Görüntü işleme işleminin kendisi de bellek ve işlem sınırlarıyla yönetilmelidir.

PDF, SVG ve ofis dosyaları farklı risk ve kullanım ihtiyaçları taşır. Bu örneğin izin listesine yeni uzantı eklemek, o tür için güvenli bir işlem kurmakla aynı değildir. İş ihtiyacında bulunmayan dosya türlerini sırf kullanıcı kolaylığı için kabul etmeyin.

Başarıdan sonra kayıt ilişkisini kurun

Dosya kaydedildiğinde hangi kullanıcıya ve hangi içeriğe ait olduğunu kaydedin. Veritabanı işlemi başarısız olursa dosya depoda tek başına kalabilir; böyle durumlar için geri alma veya temizleme yolu tasarlayın. Dosya silme isteğinde de kullanıcı yetkisini ve dosyanın gerçek sahipliğini doğrulayın.

Kabul ve ret senaryolarını deneyin

Normal JPEG, normal PNG, yanlış uzantılı metin dosyası, sınırı aşan dosya ve aşırı büyük piksel ölçülü görüntüyle deneme yapın. Her hata için kullanıcıya anlaşılır mesaj verin; sunucu yolunu veya iç hata ayrıntısını göstermeyin. Upload güvenliği bir uzantı listesinden değil, baştan sona kontrollü bir akıştan oluşur.

Kaynaklar: PHP — Handling file uploads, move_uploaded_file.