Sayfa yükleniyor

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

Ders 66 – filter_* ile doğrulama

PHP filter_* fonksiyonlarıyla e‑posta, URL, sayı ve daha fazlasını nasıl doğrular ve temizlersiniz? Adım adım örnekler, sık yapılan hatalar ve kontrol listesi.

Ders 66 – filter_* ile doğrulama

Web uygulamalarında kullanıcıdan gelen veriyi güvenli bir şekilde işlemek, güvenlik açıklarını önlemenin temel taşlarından biridir. PHP, filter_* ailesi sayesinde bu süreci standart, okunabilir ve hatasız bir şekilde gerçekleştirmeyi mümkün kılar. Bu derste, filter_var ve filter_input fonksiyonlarını kullanarak veri doğrulama ve temizleme (sanitize) işlemlerini adım adım inceleyecek, gerçek dünya senaryolarına uygun örnekler üzerinden pratiğe dökeceğiz.

Temeller

PHP'nin filtre uzantısı (filter extension), veri doğrulama (validate) ve temizleme (sanitize) işlemlerini ayrı ayrı ele alır. Doğrulama, bir değerin belirli bir formata (örneğin e‑posta adresi) uygun olup olmadığını kontrol eder ve false dönerse veri kabul edilmez. Temizleme ise, bir değeri istenmeyen karakterlerden arındırarak güvenli bir forma dönüştürür; bu işlem veri hâlâ kullanılabilir, sadece “temizlenmiş” olur.

İki işlem arasındaki farkı karıştırmak, güvenlik açıklarına yol açabilir. Örneğin, bir e‑posta adresini sadece FILTER_SANITIZE_EMAIL ile temizlemek, adresin geçerli bir e‑posta formatına sahip olduğunu garanti etmez; sadece geçersiz karakterleri kaldırır. Bu yüzden, her zaman önce doğrulama, ardından temizleme yaklaşımını benimsemek en sağlıklı yöntemdir.

Adım adım doğrulama

  1. Kaynağı belirleyin: Veri $_GET, $_POST, $_COOKIE gibi süper global değişkenlerden mi geliyor? filter_input doğrudan bu kaynakları hedef alarak kodunuzu daha okunaklı hâle getirir.
  2. Doğrulama filtresini seçin: PHP, FILTER_VALIDATE_EMAIL, FILTER_VALIDATE_URL, FILTER_VALIDATE_INT gibi bir dizi hazır filtre sunar. Hangi veri tipini kontrol edeceğinizi belirleyin.
  3. Seçenekleri yapılandırın: Birçok filtre, ek seçeneklerle (ör. min_range, max_range) özelleştirilebilir. Bu seçenekler bir dizi (array) içinde options anahtarına yerleştirilir.
  4. Doğrulama sonucunu kontrol edin: Filtre false dönerse, kullanıcıya anlamlı bir hata mesajı gösterin; ancak ham hatayı doğrudan ekrana basmaktan kaçının.
  5. Temizleme (opsiyonel): Doğrulama başarılıysa, aynı veri üzerinde bir sanitize filtresi uygulayarak gereksiz karakterleri kaldırabilirsiniz.

Örnek kod

Aşağıdaki örnek, bir POST formundan gelen e‑posta adresini hem doğrulayan hem de temizleyen iki farklı yaklaşımı gösterir. İlk örnek filter_input kullanırken, ikinci örnek aynı işlemi filter_var ile yapar.

<?php
// ders66.php - filter_input ile doğrulama ve temizleme
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // 1. Doğrulama – sadece geçerli bir e‑posta mi?
    $email = filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL);
    if ($email === false) {
        echo 'Geçersiz e‑posta adresi.';
        exit;
    }
    // 2. Temizleme – istenmeyen karakterleri kaldır (ekstra güvenlik)
    $cleanEmail = filter_var($email, FILTER_SANITIZE_EMAIL);
    echo "Doğrulandı ve temizlendi: $cleanEmail";
}
?>

Aşağıdaki kod ise aynı mantığı bir fonksiyon içinde toplar ve filter_var ile çalışır. Bu yapı, sınıf‑tabanlı projelerde tekrar kullanılabilir bir yardımcı metod oluşturmak için idealdir.

<?php
function validateAndSanitizeEmail(string $email): ?string {
    // Doğrulama
    $valid = filter_var($email, FILTER_VALIDATE_EMAIL);
    if ($valid === false) {
        return null; // Geçersizse null döndür
    }
    // Temizleme
    return filter_var($valid, FILTER_SANITIZE_EMAIL);
}

// Kullanım örneği
$raw = "  john..doe@@example.com  ";
$clean = validateAndSanitizeEmail(trim($raw));
if ($clean === null) {
    echo "E‑posta geçerli değil.";
} else {
    echo "Temiz e‑posta: $clean";
}
?>

Sık yapılan hatalar

  • Doğrulama yerine sadece temizleme kullanmak: FILTER_SANITIZE_EMAIL geçersiz bir e‑posta adresini “temizleyebilir”, fakat adresin hâlâ geçerli olduğunu garanti etmez.
  • Filtre sonuçlarını doğrudan ekrana basmak: filter_var false döndüğünde, hatayı doğrudan kullanıcıya göstermek yerine loglayıp genel bir mesaj vermek gerekir.
  • Seçenekleri atlamamak: Sayısal değerlerde FILTER_VALIDATE_INT kullanırken min_range ve max_range gibi sınırları belirtmezseniz, beklenmedik büyük/küçük sayılar kabul edilebilir.
  • UTF‑8 karakter setini göz ardı etmek: FILTER_VALIDATE_EMAIL ASCII tabanlıdır; uluslararası e‑posta adresleri (IDN) için ek bir kütüphane gerekir.
  • GET parametrelerini doğrudan filtrelemek: filter_input ile INPUT_GET kullanırken, parametrenin var olup olmadığını kontrol etmeyi unutmayın; aksi takdirde null döner.

Özet ve kontrol listesi

Bu derste öğrendiklerimizi kısa bir kontrol listesiyle pekiştirelim. Projenizde filter_* fonksiyonlarını kullanmadan önce aşağıdaki maddeleri gözden geçirin:

  • Kaynağı doğru seçtiniz mi? (filter_input vs filter_var)
  • Doğrulama filtresi veri tipine uygun mu?
  • Gerekli options (ör. min_range, max_range) tanımlandı mı?
  • Doğrulama başarısız olduğunda kullanıcıya güvenli bir hata mesajı gösteriliyor mu?
  • Başarılı doğrulama sonrası temizleme (sanitize) uygulanıyor mu?
  • Hatalar loglanıyor, ama hassas bilgiler kullanıcıya sızdırılmıyor mu?
  • Uluslararası karakterler gerekiyorsa ek bir doğrulama katmanı eklediniz mi?

Bu adımları her form ve API uç noktasına uyguladığınızda, XSS, SQL Injection ve veri bütünlüğü problemlerine karşı çok daha dayanıklı bir yapı elde edersiniz.

SSS

Soru 1: FILTER_SANITIZE_STRING artık PHP 8.1'de kaldırıldı mı?
Evet. FILTER_SANITIZE_STRING PHP 8.1 itibarıyla deprecated olmuş ve gelecekte tamamen kaldırılacak. Bunun yerine htmlspecialchars veya strip_tags gibi fonksiyonlar tercih edilmelidir.

Soru 2: Bir e‑posta adresini sadece FILTER_VALIDATE_EMAIL ile doğrulamak yeterli midir?
Genel kullanım için yeterlidir, ancak uluslararası alan adları (IDN) ve yeni TLD'ler için ek kontroller (ör. filter_var + idn_to_ascii) gerekebilir.

Soru 3: filter_input ile INPUT_SERVER kullanılabilir mi?
Evet, filter_input INPUT_SERVER ve INPUT_ENV gibi diğer süper globalleri de destekler, ancak genellikle kullanıcı girdisi olmayan bu veriler için ekstra filtreleme nadiren gerekir.

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