Bir API’den gelen JSON dosyasının başarıyla çözülmesi, içindeki verinin uygulamanız için uygun olduğunu göstermez. {"adet":"on"} geçerli JSON’dur; fakat tam sayı miktar bekleyen stok işlemi için uygun değildir. Sözdizimi kontrolüyle iş verisi doğrulamasını ayrı kurmak gerekir.

Önce beklenen biçimi tarif edin

Örnekte kökte bir nesne, içinde kod ve adet alanları beklensin. Kod boş olmayan bir metin, adet ise 1 ile 10000 arasında tam sayı olsun. Liste, null veya eksik alan aynı işlem için kabul edilmesin. Bu aralık çalışma örneğinin kuralıdır; gerçek uygulamada iş ihtiyacına göre seçilmelidir.

<?php
function parseOrder(string $raw): array {
    if (strlen($raw) > 65536) {
        throw new InvalidArgumentException('Girdi fazla büyük.');
    }
    try {
        $data = json_decode($raw, false, 32, JSON_THROW_ON_ERROR);
    } catch (JsonException $error) {
        throw new InvalidArgumentException('JSON biçimi geçersiz.');
    }
    if (!($data instanceof stdClass)) {
        throw new InvalidArgumentException('Bir nesne bekleniyor.');
    }
    if (!isset($data->kod, $data->adet)
        || !is_string($data->kod) || !is_int($data->adet)) {
        throw new InvalidArgumentException('Alan türleri geçersiz.');
    }
    $code = trim($data->kod);
    if ($code === '' || strlen($code) > 40
        || $data->adet < 1 || $data->adet > 10000) {
        throw new InvalidArgumentException('Alan değerleri geçersiz.');
    }
    return ['kod' => $code, 'adet' => $data->adet];
}

Nesne olarak çözmek, kökte JSON nesnesiyle JSON listesini açıkça ayırır. Örnekte kod sınırı byte üzerinden kontrol edilir; çok dilli karakter sınırı gerekiyorsa Unicode uyumlu uzunluk yaklaşımını ayrıca seçin. Bilinmeyen ek alanlar işleme alınmaz; daha sıkı bir şemada bunları reddetmeyi tercih edebilirsiniz.

Geçerli JSON ile geçerli siparişi karıştırmayın

"3" metindir, 3 tam sayıdır. İkisini otomatik eşitlemek veri sözleşmesini belirsizleştirebilir. Örnek, metin miktarı reddeder. Ondalıklı miktar kabul edilecekse tip ve hassasiyet yaklaşımı farklı kurulmalıdır. JSON sayılarıyla finansal hesabı doğrudan kayan nokta üzerinden yapmak ayrıca dikkat ister.

Kodun veritabanında gerçekten bulunması, miktarın stokla uyumu ve kullanıcının yetkisi bu parser’ın işi değildir. Çözülmüş veriyi güvenli parametreli sorgularla kullanın. Kod değerini SQL metnine veya HTML çıktısına ham eklemeyin.

İstek boyutunu daha erken de sınırlayın

Fonksiyondaki boyut kontrolü, raw metin zaten belleğe alındıktan sonra çalışır. Sunucuda ve istek okuma katmanında uygun sınırlar da kurulmalıdır. Bu örneği tek başına büyük istek saldırılarına karşı tam koruma gibi sunmayın.

Bozuk JSON, boş nesne, liste, null, metin miktar, sıfır miktar ve normal nesneyle test yapın. Hata yanıtında bütün ham isteği geri döndürmeyin; kişisel veya hassas veri bulunabilir. Kontrollü ve açık bir veri sözleşmesi, sonradan sessizce yanlış sonuç üretmekten daha anlaşılırdır.

Kaynak: PHP — json_decode, JsonException.

İlgili okumalar