Laravel Validation: Form Doğrulamasında Sık Yapılan Hatalar
İstemci tarafı kontrolü neden yeterli değildir? Laravel doğrulama kurallarını, iç içe verileri ve yetkilendirmeyi gerçekçi bir form örneği üzerinden inceleyelim.
Bir ürün ekleme formunda fiyat alanını tarayıcıda zorunlu yapmanız kullanıcıya hızlı geri bildirim verir. Fakat isteği yalnızca sizin hazırladığınız sayfanın göndereceğini varsayamazsınız. Sunucuya eksik, yanlış tipte veya iş kurallarına uymayan veriler de gelebilir. Bu nedenle doğrulamanın asıl sınırı sunucudur; tarayıcı doğrulaması ise kullanışlı bir ek katmandır.
Kuralı iş ihtiyacından çıkarın
Bir ürün için başlık, fiyat ve isteğe bağlı açıklama aldığımızı düşünelim. Başlığın zorunlu olması, uzunluğunun sınırlanması ve fiyatın negatif olmaması farklı kurallardır. Fiyat için numeric kullanmak yalnızca sayısal kabul edilen bir değer aradığınızı ifade eder; para hesaplarının nasıl saklanacağına ayrıca karar vermeniz gerekir. Ondalıklı para işlemlerinde float hassasiyetini göz önünde bulundurun; gerekirse kuruş cinsinden tam sayı veya uygun bir decimal stratejisi kullanın.
$data = $request->validate([
'title' => ['required', 'string', 'max:160'],
'price_cents' => ['required', 'integer', 'min:0'],
'description' => ['nullable', 'string', 'max:5000'],
]);
Örnekte price_cents alanı kuruş cinsindendir. Kullanıcı “125,50 TL” giriyorsa bunu tam sayıya dönüştürmeden önce biçimi ve yuvarlama kuralını açıkça belirlemek gerekir. Bir alana nullable eklemek onun sınırsız veri kabul edeceği anlamına gelmez; doluysa diğer kurallar uygulanır.
Doğrulama ve yetkilendirme aynı şey değil
Bir kullanıcının category_id göndermesi ve bu kategorinin veritabanında bulunması, kullanıcının o kategori üzerinde işlem yapmaya yetkili olduğunu kanıtlamaz. Çok kiracılı sistemlerde iki müşteriye ait kayıtların birbirine karışmaması için sorguları doğru organizasyon kapsamında sınırlandırın ve policy veya eşdeğer bir yetkilendirme katmanı kullanın.
Örneğin mevcut bir siparişin durumunu güncelleyen uç noktada hem gönderilen durum değerinin geçerli olması hem de oturumdaki kullanıcının o siparişi güncelleme iznine sahip olması gerekir. Bu kontrollerden yalnızca birini yapmak yeterli değildir.
İç içe dizileri açıkça tanımlayın
Sipariş formu birden fazla satır gönderdiğinde dizinin kendisini ve her satırın alanlarını ayrı doğrulayabilirsiniz:
$data = $request->validate([
'items' => ['required', 'array', 'min:1', 'max:50'],
'items.*.product_id' => ['required', 'integer', 'exists:products,id'],
'items.*.quantity' => ['required', 'integer', 'min:1', 'max:100'],
]);
Bu kurallar örnek sınırlar içerir; gerçek limitlerinizi işinize göre belirleyin. exists ürünün varlığını sınar, ancak satışta olup olmadığını, kullanıcıya gösterilip gösterilemeyeceğini veya yeterli stok bulunup bulunmadığını tek başına çözmez. Özellikle stok kontrolünü yalnızca form doğrulamasında yapıp daha sonra güvenle değişmez kabul etmek eş zamanlı taleplerde sorun yaratabilir.
Yalnızca doğrulanmış alanları kullanın
Kontrol etmediğiniz tüm isteği doğrudan modele aktarmak yerine validated() veya örnekteki $data gibi doğrulanmış veriyi kullanın. Bunun yanında modelin toplu atama kurallarını ve hangi alanların gerçekten değiştirilebildiğini de gözden geçirin. İstemciden gelen is_admin veya status gibi alanları kullanıcıya kapalı tutmak yalnızca arayüzde gizlemekle sağlanmaz.
Form büyüdükçe kuralları bir Form Request sınıfına taşımak denetlenebilirliği artırabilir. Burada authorize() ile işlemin kim tarafından yapılabileceğini, rules() ile veri biçimini ayrı düşünmek faydalıdır. İhtiyaç varsa hata mesajlarını kullanıcıların alanı nasıl düzelteceğini anlatacak biçimde sadeleştirin; iç tablo veya sistem ayrıntılarını açığa çıkarmayın.
Nasıl test etmeli?
Geçerli bir formun yanı sıra eksik alan, negatif değer, çok uzun metin, geçersiz ürün kimliği ve başka kullanıcıya ait kaynak senaryolarını deneyin. Tarayıcı isteği ile JSON bekleyen API isteğinin hata yanıtları farklı olabilir; istemcinizin iki akışı doğru işlediğini de test edin. Sonuçta iyi doğrulama yalnızca hatalı isteği reddetmez, doğru kullanıcıya neyi düzeltmesi gerektiğini de söyler.
Kaynak: Laravel doğrulama belgeleri.
BİRLİKTE ÖĞRENELİM
Yorumlar
Henüz yorum yok. Düşünceni paylaşarak sohbeti başlatabilirsin.
Bir Yorum Bırak.
Katkılarını ve deneyimlerini duymak isterim. Yorumlar yayınlanmadan önce incelenir.