romegames 1
romegames
BySadoTR60 1
BySadoTR60
aslan6474 1
aslan6474
Reklam vermek için turkmmo@gmail.com

Altın Konu PHP json_decode() Kullanımı: JSON Verilerini Diziye veya Nesneye Dönüştürme

  • Konuyu başlatan Konuyu başlatan Agora Metin2
  • Başlangıç tarihi Başlangıç tarihi
  • Cevaplar Cevaplar 2
  • Görüntüleme Görüntüleme 21
image.jpeg


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)

Geri
Üst