json_decode($json, true) fonksiyonu, bir JSON dizgesini PHP değerlerine dönüştürür; burada true parametresi kullanıldığında her bir JSON nesnesi ilişkisel bir diziye çevrilir. Eğer true belirtilmezse, JSON nesneleri bunun yerine -> operatörü ile erişilen stdClass nesneleri haline gelir. Hatalı JSON formatları ise null değerini döndürür.
PHP:
<?php
$json = '{"name": "Ada", "age": 36, "langs": ["php", "js"], "admin": true}';
$data = json_decode($json, true); // associative array
echo $data['name'], "\n";
echo $data['langs'][1], "\n";
$obj = json_decode($json); // stdClass object
echo $obj->name, "\n";
echo $obj->langs[0], "\n";
print_r($data);
Çıktı:
Kod:
Ada
js
Ada
php
Array
(
[name] => Ada
[age] => 36
[langs] => Array
(
[0] => php
[1] => js
)
[admin] => 1
)
Seçtiğiniz yöntem ne olursa olsun, JSON dizileri her zaman PHP listelerine dönüştürülür. Bu işlemin tersini, yani PHP'den JSON'a dönüşümü ise
json_encode() fonksiyonu gerçekleştirir.Nesne mi yoksa İlişkisel Dizi mi: true ve false Farkı
Her iki mod da aslında aynı veriyi saklar, bu yüzden kodunuzun okunabilirliğine göre bir tercih yapabilirsiniz. Diziler;
array_column, array_map veya isset($data['key']) gibi tüm dizi fonksiyonlarıyla uyumlu çalıştığı için çoğu geliştirici true parametresini tercih eder. Nesnelerde ise, sayı veya tire içeren ve standart özellik ismi kurallarına uymayan anahtarlar için süslü parantez söz dizimini kullanmak gerekir:
PHP:
<?php
$json = '{"first-name": "Ada", "0": "zero", "address": {"city": "London"}}';
$arr = json_decode($json, true);
echo $arr['first-name'], ' ', $arr[0], ' ', $arr['address']['city'], "\n";
$obj = json_decode($json);
echo $obj->{'first-name'}, ' ', $obj->{'0'}, ' ', $obj->address->city, "\n";
var_dump($obj->address);
Çıktı:
Kod:
Ada zero London
Ada zero London
object(stdClass)#2 (1) {
["city"]=>
string(6) "London"
}
Fonksiyonun dördüncü parametresi bayraklar (flags) içindir.
JSON_OBJECT_AS_ARRAY bayrağı da dizi döndürür, ancak bu yalnızca ikinci argüman null (varsayılan değeri) olduğunda geçerlidir: json_decode($json, flags: JSON_OBJECT_AS_ARRAY) kullanımı dizi döndürürken, json_decode($json, false, 512, JSON_OBJECT_AS_ARRAY) kullanımı yine nesne döndürür.İç İçe JSON Verileriyle Çalışmak
API yanıtları genellikle bir nesne içerisindeki nesne listelerinden oluşur. Veriyi bir kez çözümledikten sonra
foreach ile döngüye alabilir ve eksik olabilecek alanlar için ?? (null coalescing) operatörünü kullanabilirsiniz:
PHP:
<?php
$json = <<<'JSON'
{
"page": 1,
"users": [
{"id": 1, "name": "Ada", "email": "ada@example.com", "roles": ["admin", "editor"]},
{"id": 2, "name": "Linus", "roles": []},
{"id": 3, "name": "Grace", "email": "grace@example.com", "roles": ["editor"]}
]
}
JSON;
$data = json_decode($json, true);
foreach ($data['users'] as $user) {
$email = $user['email'] ?? 'no email';
$roles = $user['roles'] ? implode(', ', $user['roles']) : 'none';
echo "#{$user['id']} {$user['name']} <$email> roles: $roles\n";
}
$names = array_column($data['users'], 'name', 'id');
print_r($names);
Çıktı:
Kod:
#1 Ada <ada@example.com> roles: admin, editor
#2 Linus <no email> roles: none
#3 Grace <grace@example.com> roles: editor
Array
(
[1] => Ada
[2] => Linus
[3] => Grace
)
Hatalı JSON Verilerini Yönetme
json_decode() fonksiyonu, geçersiz bir JSON ile karşılaştığında null döndürür. Ancak JSON metninin kendisi gerçekten "null" olduğunda da sonuç null olacağı için, sadece bu değere bakarak işlemin başarısız olup olmadığını anlayamazsınız. Hatanın sebebini öğrenmek için json_last_error_msg() fonksiyonunu kullanabilirsiniz. Büyük belgelerdeki hataları tespit etmek için metni hatalı satırı gösteren bir JSON biçimlendiriciye yapıştırmak etkili bir yoldur. Daha temiz bir yaklaşım ise, JsonException hatası fırlatan JSON_THROW_ON_ERROR bayrağını kullanmaktır:
PHP:
<?php
var_dump(json_decode('{"a": 1,}')); // trailing comma
echo json_last_error_msg(), "\n";
var_dump(json_decode('null')); // valid JSON, also null
echo json_last_error_msg(), "\n";
try {
$data = json_decode("{'a': 1}", true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
echo 'Invalid JSON: ', $e->getMessage(), "\n";
}
Çıktı:
Kod:
NULL
Syntax error
NULL
No error
Invalid JSON: Syntax error
Üçüncü parametre olan
512, izin verilen maksimum iç içe geçme derinliğidir (varsayılan değer). Adlandırılmış argümanlar kullanarak bu parametreyi atlayabilirsiniz: json_decode($json, true, flags: JSON_THROW_ON_ERROR).json_validate() ile JSON Geçerliliğini Kontrol Etme
PHP 8.3 sürümüyle birlikte
json_validate() fonksiyonu eklenmiştir. Bu fonksiyon, veriyi tamamen çözümleyip diziye dönüştürmeden sadece geçerli olup olmadığını true veya false olarak bildirir. Örneğin, bir istek gövdesini hızlıca reddetmek istediğinizde, belleği daha verimli kullanmak için çözümleme yapmaktan daha mantıklıdır:
PHP:
<?php
$inputs = ['{"a": 1}', '[1, 2, 3]', '"text"', '{a: 1}', "{'a': 1}", ''];
foreach ($inputs as $input) {
$ok = json_validate($input) ? 'valid' : 'invalid: ' . json_last_error_msg();
echo str_pad(var_export($input, true), 14), $ok, "\n";
}
Çıktı:
Kod:
'{"a": 1}' valid
'[1, 2, 3]' valid
'"text"' valid
'{a: 1}' invalid: Syntax error
'{\'a\': 1}' invalid: Syntax error
'' invalid: Syntax error
Eğer veriyi çözümledikten sonra zaten kullanacaksanız,
json_validate() adımını atlayıp doğrudan JSON_THROW_ON_ERROR ile çözümleme yapın; aksi takdirde metin iki kez ayrıştırılmış olur.JSON Dosyalarını Okumak
Bir dosyayı önce
file_get_contents() ile okuyup ardından içeriğini çözümleyebilirsiniz. Aşağıdaki örnekte, okunacak bir dosya oluşturmak adına önce settings.json dosyası yazılmaktadır:
PHP:
<?php
file_put_contents('settings.json', '{"theme": "dark", "fontSize": 14, "plugins": ["git", "lint"]}');
$text = file_get_contents('settings.json');
if ($text === false) {
exit("Cannot read settings.json\n");
}
$settings = json_decode($text, true, flags: JSON_THROW_ON_ERROR);
echo "Theme: {$settings['theme']}\n";
echo "Plugins: ", count($settings['plugins']), "\n";
// Change a value and write the file back
$settings['fontSize'] = 16;
file_put_contents('settings.json', json_encode($settings, JSON_PRETTY_PRINT));
echo file_get_contents('settings.json'), "\n";
Çıktı:
Kod:
Theme: dark
Plugins: 2
{
"theme": "dark",
"fontSize": 16,
"plugins": [
"git",
"lint"
]
}
json_decode Neden null Döndürür: Yaygın Hatalar
JSON formatı, JavaScript veya PHP dizi yazımına göre çok daha katı kurallara sahiptir. Aşağıdaki örneklerin her biri ilk bakışta doğru görünse de aslında
null döndürür. Her birinin neden hata verdiğini görmek için kodu çalıştırabilir, ardından hatayı düzeltip tekrar deneyebilirsiniz:
PHP:
<?php
$cases = [
'single quotes' => "{'name': 'Ada'}",
'unquoted key' => '{name: "Ada"}',
'trailing comma' => '{"name": "Ada",}',
'comment' => '{"name": "Ada" /* admin */}',
'byte order mark' => "\xEF\xBB\xBF" . '{"name": "Ada"}',
'too deep' => '[[["Ada"]]]',
];
foreach ($cases as $label => $json) {
$depth = $label === 'too deep' ? 2 : 512;
$result = json_decode($json, true, $depth);
echo str_pad($label, 17), $result === null ? json_last_error_msg() : 'ok', "\n";
}
// Big integers lose precision unless you ask for strings
var_dump(json_decode('{"id": 12345678901234567890}', true)['id']);
var_dump(json_decode('{"id": 12345678901234567890}', true, 512, JSON_BIGINT_AS_STRING)['id']);
Çıktı:
Kod:
single quotes Syntax error
unquoted key Syntax error
trailing comma Syntax error
comment Syntax error
byte order mark Syntax error
too deep Maximum stack depth exceeded
float(1.2345678901234567E+19)
string(20) "12345678901234567890"
Çoğu editörde görünmeyen Bayt Sırası İşareti (BOM), JSON dosyasının "doğru görünmesine" rağmen çözümlenememesinin klasik nedenlerinden biridir. Bu sorunu önlemek için çözümleme işleminden önce şu kodla BOM karakterini temizleyebilirsiniz:
$text = preg_replace('/^\xEF\xBB\xBF/', '', $text);.Şu an konuyu görüntüleyenler (Toplam : 0, Üye: 0, Misafir: 0)
Benzer konular
- Cevaplar
- 2
- Görüntüleme
- 20
- Cevaplar
- 15
- Görüntüleme
- 84
- Cevaplar
- 5
- Görüntüleme
- 28
- Cevaplar
- 1
- Görüntüleme
- 11
- Cevaplar
- 2
- Görüntüleme
- 22
