Obrada podataka zapisanih u obliku JavaScript Object Notation (JSON) u jeziku PHP

JavaScript Object Notation (JSON) (Wikipedia, MDN) je jednostavan format za razmjenu podataka koji se intenzivno koristi na suvremenom webu. Standardiziran je u okviru RFC-a 7159 naslovljenog The JavaScript Object Notation (JSON) Data Interchange Format. Primjer objekta zapisanog u JSON-u koji opisuje osobu (inspiriran Wikipedijinim primjerom) je oblika:

{
  "firstName": "Ivan",
  "lastName": "Horvat",
  "isAlive": true,
  "age": 19,
  "address": {
    "streetAddress": "Radmile Matejčić 2a",
    "city": "Rijeka",
    "state": "Primorsko-goranska županija",
    "postalCode": "51000"
  },
  "jobTitle": "junior software engineer",
  "phoneNumbers": [
    {
      "type": "home",
      "number": "051/999-999"
    },
    {
      "type": "office",
      "number": "099/999-9999"
    }
  ],
  "twitterHandle": "@IvanNajjaciHorvat",
  "children": [],
  "spouse": null
}

Iz ovako zapisanih podataka lako je izdvojiti onaj koji nam treba te ga postaviti na odgovarajuće mjesto na web stranici. Za ilustraciju, možemo zamisliti kako bi ime, prezime, titula i korisničko ime na Twitteru bili iskorišteni kod stvaranja stranice Team Sections od Tailwind CSS UI Components koja bi navela Ivana Horvata kao dio tima, ali procesom izrade web stranica na taj način ćemo se detaljnije baviti nekom drugom prigodom.

Kodiranje i dekodiranje JSON-a

Interpreter PHP-a podržava kodiranje i dekodiranje JSON-a od verzije 5.2.0 nadalje.

Kodiranje

Pretvobu PHP-ovih polja u oblik JSON, odnosno kodiranje JSON-a vršimo funkcijom json_encode() (dokumentacija) na način:

<?php

$arr1 = ["moja vrijednost", 1, 3.5, true];
$j1 = json_encode($arr1);
echo $j1;

$arr2 = ["moj kljuc" => "moja vrijednost", "broj" => 8, "drugi broj" => 3.5, "je li istina" => true];
$j2 = json_encode($arr2);
echo $j2;

Pokretanjem ovog koda (u interaktivnom načinu rada, korištenjem sučelja naredbenog retka ili korištenjem ugrađenog web poslužitelja i klijenta po želji) dobivamo za prvo polje zapis podataka u obliku JSON:

["moja vrijednost",1,3.5,true]

te za drugo polje zapis:

{"moj kljuc":"moja vrijednost","broj":8,"drugi broj":3.5,"je li istina":true}

Uočimo da smo kod pretvorbe prvog PHP-ovog polja dobili polje u obliku JSON-u (znakovi [ i ]), a kod pretvorbe drugog objekt (znakovi { i } te znak : koji odvaja ključeve i njihove vrijednosti).

Dodatno, u JSON-u znakovi razmaka i novog retka između vrijednosti ne znače ništa pa funkcija json_encode() radi štednje prostora zapisuje podatke bez tih znakova. Želimo li elegantniji i za ljude čitljiviji ispis, možemo iskoristiti zastavicu JSON_PRETTY_PRINT (dokumentacija) na način:

<?php

$arr1 = ["moja vrijednost", 1, 3.5, true];
$j1 = json_encode($arr1, JSON_PRETTY_PRINT);
echo $j1;

$arr2 = ["moj kljuc" => "moja vrijednost", "broj" => 8, "drugi broj" => 3.5, "je li istina" => true];
$j2 = json_encode($arr2, JSON_PRETTY_PRINT);
echo $j2;

Dobiveni zapisi podataka u obliku JSON su sada čitljiviji ljudima. Za prvo polje dobivamo:

[
    "moja vrijednost",
    1,
    3.5,
    true
]

Za drugo polje dobivamo:

{
    "moj kljuc": "moja vrijednost",
    "broj": 8,
    "drugi broj": 3.5,
    "je li istina": true
}

Ugnježđivanjem polja možemo dobiti složenije strukture:

<?php

$arr1 = ["moja vrijednost", 1, 3.5, true];
$arr2 = ["moj kljuc" => "moja vrijednost", "broj" => 8, "drugi broj" => 3.5, "je li istina" => true];

$arr3 = $arr2;
$arr3["polje"] = $arr1;
// ekvivalentno $arr3 = ["moj kljuc" => "moja vrijednost", "broj" => 8, "drugi broj" => 3.5, "je li istina" => true, "polje" => ["moja vrijednost", 1, 3.5, true]];
$j3 = json_encode($arr3, JSON_PRETTY_PRINT);
echo $j3;

Pokretanjem programa dobivamo zapis podataka u obliku JSON:

{
    "moj kljuc": "moja vrijednost",
    "broj": 8,
    "drugi broj": 3.5,
    "je li istina": true,
    "polje": [
        "moja vrijednost",
        1,
        3.5,
        true
    ]
}

Dekodiranje

Pretvorbu JSON-a u PHP-ova polja, odnosno dekodiranje JSON-a vršimo funkcijom json_decode() (dokumentacija). Uzmimo za primjer objekt koji opisuje osobu od ranije zapisan bez znakova razmaka i novog retka između vrijednosti:

<?php

$j = '{"firstName":"Ivan","lastName":"Horvat","isAlive":true,"age":19,"address":{"streetAddress":"Radmile Matejčić 2a","city":"Rijeka","state":"Primorsko-goranska županija","postalCode":"51000"},"jobTitle":"junior software engineer","phoneNumbers":[{"type":"home","number":"051/999-999"},{"type":"office","number":"099/999-9999"}],"twitterHandle":"@IvanNajjaciHorvat","children":[],"spouse":null}';
$person = json_decode($j, true);
print_r($person);

Prvi parametar funkcije json_decode() je znakovni niz koji sadrži zapis podataka u obliku JSON, a drugi postavljamo na vrijednost true jer želimo kao rezultat pretvorbe uvijek dobiti polje. Naime, zadana vrijednost drugog parametra je null i kod te vrijednosti možemo dobiti polje ili objekt ovisno o postavljenim vrijednostima zastavica. (Moguće je i kod ove funkcije koristiti zastavice na sličan način kao kod funkcije json_encode(), ali nam one neće trebati.) Uvjerimo se pokretanjem koda da smo dekodiranjem JSON-a dobili polje s danim podacima:

Array
(
    [firstName] => Ivan
    [lastName] => Horvat
    [isAlive] => 1
    [age] => 19
    [address] => Array
        (
            [streetAddress] => Radmile Matejčić 2a
            [city] => Rijeka
            [state] => Primorsko-goranska županija
            [postalCode] => 51000
        )

    [jobTitle] => junior software engineer
    [phoneNumbers] => Array
        (
            [0] => Array
                (
                    [type] => home
                    [number] => 051/999-999
                )

            [1] => Array
                (
                    [type] => office
                    [number] => 099/999-9999
                )

        )

    [twitterHandle] => @IvanNajjaciHorvat
    [children] => Array
        (
        )

    [spouse] =>
)

Oblikovanje JSON-a u sučelju naredbenog retka

Van interpretera PHP-a, odnosno u ljusci operacijskog sustava možemo iskoristiti programski alat jq (službena stranica, dokumentacija) za obradu JSON-a slično kao što za obradu običnog teksta koristimo sed. Željeni ispis dobivamo naredbom jq s filterom ulaza . koji kopira ulaz na izlaz bez da mijenja njegov sadržaj, ali ga pritom lijepo oblikuje:

$ echo '{"moj kljuc":"moja vrijednost","broj":8,"drugi broj":3.5,"je li istina":true}' | jq .
{
  "moj kljuc": "moja vrijednost",
  "broj": 8,
  "drugi broj": 3.5,
  "je li istina": true
}

Author: Vedran Miletić