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
- Kaynağı belirleyin: Veri
$_GET,$_POST,$_COOKIEgibi süper global değişkenlerden mi geliyor?filter_inputdoğrudan bu kaynakları hedef alarak kodunuzu daha okunaklı hâle getirir. - Doğrulama filtresini seçin: PHP,
FILTER_VALIDATE_EMAIL,FILTER_VALIDATE_URL,FILTER_VALIDATE_INTgibi bir dizi hazır filtre sunar. Hangi veri tipini kontrol edeceğinizi belirleyin. - 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çindeoptionsanahtarına yerleştirilir. - Doğrulama sonucunu kontrol edin: Filtre
falsedönerse, kullanıcıya anlamlı bir hata mesajı gösterin; ancak ham hatayı doğrudan ekrana basmaktan kaçının. - 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_EMAILgeç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_varfalsedö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_INTkullanırkenmin_rangevemax_rangegibi sınırları belirtmezseniz, beklenmedik büyük/küçük sayılar kabul edilebilir. - UTF‑8 karakter setini göz ardı etmek:
FILTER_VALIDATE_EMAILASCII tabanlıdır; uluslararası e‑posta adresleri (IDN) için ek bir kütüphane gerekir. - GET parametrelerini doğrudan filtrelemek:
filter_inputileINPUT_GETkullanırken, parametrenin var olup olmadığını kontrol etmeyi unutmayın; aksi takdirdenulldö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_inputvsfilter_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.
Yorumlar
Henüz onaylanmış yorum yok. İlk yorumu siz yazın.
Yorum yaz
Yorumunuz yönetici onayından sonra yayınlanır.