PHP ile gelen JSON API verisini güvenli biçimde doğrulayacağız.

Vaka

API ad, e-posta ve miktar alıyor. Geçersiz veride doğru HTTP kodu ve JSON hata cevabı döndürülmeli.

Kod

<?php

header(
    'Content-Type: application/json; charset=utf-8'
);

try {

    $ham = file_get_contents(
        'php://input'
    );

    $veri = json_decode(
        $ham,
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    $ad = trim(
        (string)($veri['ad'] ?? '')
    );

    $eposta = trim(
        (string)($veri['eposta'] ?? '')
    );

    $miktar = filter_var(
        $veri['miktar'] ?? null,
        FILTER_VALIDATE_INT
    );

    if ($ad === '') {
        throw new InvalidArgumentException(
            'Ad zorunludur.'
        );
    }

    if (!filter_var(
        $eposta,
        FILTER_VALIDATE_EMAIL
    )) {
        throw new InvalidArgumentException(
            'E-posta geçersiz.'
        );
    }

    if (
        $miktar === false ||
        $miktar < 1
    ) {
        throw new InvalidArgumentException(
            'Miktar en az 1 olmalıdır.'
        );
    }

    http_response_code(200);

    echo json_encode(
        [
            'ok' => true,
            'data' => [
                'ad' => $ad,
                'eposta' => $eposta,
                'miktar' => $miktar
            ]
        ],
        JSON_UNESCAPED_UNICODE |
        JSON_THROW_ON_ERROR
    );

} catch (JsonException $e) {

    http_response_code(400);

    echo json_encode([
        'ok' => false,
        'message' => 'JSON biçimi geçersiz.'
    ], JSON_UNESCAPED_UNICODE);

} catch (InvalidArgumentException $e) {

    http_response_code(422);

    echo json_encode([
        'ok' => false,
        'message' => $e->getMessage()
    ], JSON_UNESCAPED_UNICODE);
}

Nasıl Çalışır?

  1. php://input üzerinden ham request body okunur.
  2. JSON_THROW_ON_ERROR bozuk JSON'u exception olarak yakalar.
  3. E-posta doğrulanır.
  4. Miktarın pozitif integer olması kontrol edilir.
  5. JSON hatası 400, validation hatası 422 döndürür.

Beklenen Sonuç

{
  "ok": true,
  "data": {
    "ad": "Murat",
    "eposta": "[email protected]",
    "miktar": 3
  }
}

Dikkat Edilecek Nokta

Üretim ortamında ham exception mesajlarının tamamını istemciye göndermek yerine kontrollü hata cevapları kullanılmalıdır.