Sayfa yükleniyor

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

Ders 71 – JSON encode/decode

PHP'de JSON işlemlerinin temelleri, json_encode ve json_decode fonksiyonları, flag kullanımı, hata yönetimi ve yaygın hatalar anlatılıyor.

Ders 71 – JSON encode/decode

JSON (JavaScript Object Notation), modern web uygulamalarının veri alışverişinde en çok tercih edilen formatlardan biridir. PHP geliştiricileri için json_encode ve json_decode fonksiyonları, bu formatı okumak ve üretmek için temel araçlardır. Bu ders, bu iki fonksiyonun detaylarını, flag (bayrak) seçeneklerini, hata yönetimini ve gerçek hayatta karşılaşabileceğiniz yaygın problemleri adım adım ele alacak. JSON ile çalışırken doğru ayarları yapmak, hem performansı artırır hem de güvenli bir veri akışı sağlar.

Temeller

PHP, json_encode ile bir PHP veri yapısını (dizi, nesne) JSON metnine, json_decode ile ise bir JSON metnini PHP veri yapısına dönüştürür. Bu iki fonksiyonun temel imzaları şöyledir:

string json_encode ( mixed $value [, int $options = 0 [, int $depth = 512 ]] )
mixed json_decode ( string $json [, bool $associative = false [, int $depth = 512 [, int $options = 0 ]]] )

Burada $value ve $json parametreleri sırasıyla dönüştürülecek veri ve JSON metnidir. $options parametresi ise bir veya birden fazla flag (bayrak) ile davranışı özelleştirmenizi sağlar.

Adım adım: json_encode ile JSON üretmek

json_encode fonksiyonu, PHP dizileri ve nesneleri UTF-8 kodlu bir JSON stringine çevirir. Ancak bazı durumlarda varsayılan davranış istenmeyebilir. En sık kullanılan flag'lar şunlardır:

  • JSON_UNESCAPED_UNICODE – Unicode karakterlerini kaçış (escape) etmeden çıktıya koyar. Türkçe karakterler \u00f6 gibi bir forma dönüşmez.
  • JSON_PRETTY_PRINT – Çıktıyı okunabilir hâle getirmek için satır sonu ve girinti ekler.
  • JSON_UNESCAPED_SLASHES – / karakterini kaçış yapmaz.
  • JSON_THROW_ON_ERROR (PHP 7.3+) – Hata oluştuğunda false döndürmek yerine JsonException fırlatır.

Aşağıdaki örnek, bu flag'ların nasıl birleştirilebileceğini gösterir:

 "Murat",
    "soyad" => "Yılmaz",
    "şehir" => "İstanbul",
    "url" => "https://example.com/api?param=değer",
    "aktif" => true,
    "puan" => 9.75,
];

try {
    $json = json_encode(
        $data,
        JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR
    );
    echo $json;
} catch (JsonException $e) {
    // Üretim ortamında hatayı loglayın, kullanıcıya gösterme
    error_log('JSON encode hatası: ' . $e->getMessage());
    echo "Veri JSON formatına dönüştürülürken bir hata oluştu.";
}
?>

Bu kodun çıktısı, Türkçe karakterlerin kaçış olmadan ve okunabilir bir biçimde gösterildiği bir JSON olacaktır.

Adım adım: json_decode ile JSON tüketmek

json_decode fonksiyonu, JSON metnini PHP dizisine ya da nesnesine çevirir. En kritik iki parametre şunlardır:

  • $associative – true ise sonuç bir array (ilişkisel dizi) olur, false ise bir stdClass nesnesi döner.
  • JSON_THROW_ON_ERROR – Hata durumunda JsonException fırlatır.

Aşağıdaki örnek, bir API'den gelen JSON yanıtını güvenli bir şekilde nasıl ayrıştırabileceğinizi gösterir:

getMessage());
    echo "Gelen veri geçerli bir JSON değil.";
}
?>

Bu örnekte JSON_THROW_ON_ERROR sayesinde, bozuk bir JSON geldiğinde kodunuz hemen catch bloğuna yönlendirilir; json_decode artık sessizce false dönmez.

Sık hatalar ve nasıl önlenir?

JSON ile çalışırken yeni başlayanların sıkça karşılaştığı hatalar aşağıda listelenmiştir. Her bir hatanın nedeni ve çözüm önerisi de yer almaktadır.

  • UTF-8 olmayan karakterler – json_encode yalnızca UTF-8 kodlamasını destekler. Veri setinizde ISO‑8859‑9 gibi bir kodlama varsa utf8_encode() ile dönüştürün veya mb_convert_encoding() kullanın.
  • Derinlik sınırı (depth) aşımı – Varsayılan derinlik 512'dir. Çok iç içe geçmiş diziler bu sınırı aşabilir. json_encode($data, $options, 1024) gibi bir değer vererek artırabilirsiniz.
  • Bozuk JSON – Eksik tırnak, virgül hatası gibi durumlar json_decode hatasına yol açar. JSON_THROW_ON_ERROR ile hatayı yakalayın ve loglayın.
  • Associative array vs. object karışıklığı – json_decode varsayılan olarak nesne döndürür. Dizi bekliyorsanız ikinci parametreyi true yapın; aksi takdirde -> yerine ['key'] kullanmaya çalışıp Notice alırsınız.
  • JSON_UNESCAPED_UNICODE eksikliği – Türkçe karakterler \u00f6 gibi kaçış kodlarına dönüşür. Bu, API'lerin bazıları için sorun yaratmaz ama log ve debug çıktılarında okunabilirliği azaltır. Flag ekleyin.
  • Güvenlik: JSON enjeksiyonu – Kullanıcı girdisi doğrudan json_encode içine verildiğinde, özel karakterler kaçışlanır ve enjeksiyon riski azalır. Ancak JSON_UNESCAPED_SLASHES gibi flag'lar kullanırken dikkatli olun; URL içinde <script> gibi kodlar kaçışlanmaz, ek güvenlik katmanı (HTML encode) ekleyin.

Kontrol Listesi

  • Veri setiniz UTF‑8 mi? Değilse mb_convert_encoding ile dönüştürün.
  • JSON üretirken JSON_UNESCAPED_UNICODE ve JSON_THROW_ON_ERROR flag'larını eklediniz mi?
  • JSON tüketirken json_decode ikinci parametresi true mi? (dizi istiyorsanız)
  • Hata durumunda JsonException yakalanıyor ve loglanıyor mu?
  • Üretim ortamında kullanıcıya ham hata mesajı göstermiyor musunuz?
  • Derinlik sınırını (depth) ihtiyacınıza göre ayarladınız mı?
  • Güvenlik açısından kaçış (escaping) ve filtreleme kurallarını uyguladınız mı?

Özet

Bu derste json_encode ve json_decode fonksiyonlarının temel kullanımını, flag seçeneklerini ve hata yönetimini ele aldık. Özellikle JSON_UNESCAPED_UNICODE, JSON_PRETTY_PRINT ve JSON_THROW_ON_ERROR flag'ları, modern PHP projelerinde JSON ile çalışırken vazgeçilmez araçlardır. Hataları yakalamak, veri kodlamasını kontrol etmek ve güvenli bir dönüşüm sağlamak, uygulamanızın stabilitesini ve güvenliğini doğrudan etkiler.

Sık Sorulan Sorular (SSS)

1. json_encode neden false döndürüyor?

Bu durum genellikle veri setinde UTF‑8 olmayan karakterler, çok derin iç içe diziler ya da resource tipindeki değerler (örneğin dosya tanımlayıcıları) bulunmasından kaynaklanır. JSON_THROW_ON_ERROR ekleyerek hatanın nedenini JsonException üzerinden görebilirsiniz.

2. json_decode ile nesne yerine dizi almak istiyorum, ne yapmalıyım?

İkinci parametreyi true olarak ayarlayın: json_decode($json, true). Böylece sonuç bir associative array olur ve ['key'] sözdizimiyle erişilir.

3. Derinlik (depth) limitini nasıl artırabilirim?

json_encode ve json_decode fonksiyonlarının üçüncü parametresi $depth değeridir. Örneğin json_decode($json, true, 1024) ile 1024 seviyeye kadar iç içe geçişe izin verilir.

Bu bilgilerle artık PHP projelerinizde JSON ile sorunsuz ve güvenli bir şekilde çalışabilirsiniz. Bir sonraki derste, JSON Schema doğrulaması ve json_last_error_msg() fonksiyonunun detaylarını inceleyeceğiz.

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