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
\u00f6gibi 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
falsedöndürmek yerineJsonExceptionfı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 –
trueise sonuç birarray(ilişkisel dizi) olur,falseise birstdClassnesnesi döner. - JSON_THROW_ON_ERROR – Hata durumunda
JsonExceptionfı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_encodeyalnızca UTF-8 kodlamasını destekler. Veri setinizde ISO‑8859‑9 gibi bir kodlama varsautf8_encode()ile dönüştürün veyamb_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_decodehatasına yol açar.JSON_THROW_ON_ERRORile hatayı yakalayın ve loglayın. - Associative array vs. object karışıklığı –
json_decodevarsayılan olarak nesne döndürür. Dizi bekliyorsanız ikinci parametreyitrueyapın; aksi takdirde->yerine['key']kullanmaya çalışıpNoticealırsınız. - JSON_UNESCAPED_UNICODE eksikliği – Türkçe karakterler
\u00f6gibi 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_encodeiçine verildiğinde, özel karakterler kaçışlanır ve enjeksiyon riski azalır. AncakJSON_UNESCAPED_SLASHESgibi 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_encodingile dönüştürün. - JSON üretirken
JSON_UNESCAPED_UNICODEveJSON_THROW_ON_ERRORflag'larını eklediniz mi? - JSON tüketirken
json_decodeikinci parametresitruemi? (dizi istiyorsanız) - Hata durumunda
JsonExceptionyakalanı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.
Yorumlar
Henüz onaylanmış yorum yok. İlk yorumu siz yazın.
Yorum yaz
Yorumunuz yönetici onayından sonra yayınlanır.