PHP

JSON di PHP: Panduan Lengkap Anti-Pusing Buat Developer Kekinian!
PHP

JSON di PHP: Panduan Lengkap Anti-Pusing Developer Kekinian!

PPLG

PPLG

Penulis
28 Jun 2026
33 x dilihat

Skuy ngab, kita bahas yang lagi hype banget di dunia ngoding, apalagi kalau bukan JSON bareng PHP! Jujur aja nih, kalau kamu mau bikin aplikasi kekinian, entah itu web app atau mobile app yang ngomongin data via API, pasti deh ketemu sama JSON. Ibaratnya, JSON itu kayak bahasa universal biar data kamu bisa ngobrol asik sama backend PHP kamu, atau sebaliknya. Gak pake lama, kita spill tuntas yuk biar ngoding makin auto jago!

Apa Sih JSON Itu? Kenapa Penting Banget?

Gaes, JSON itu singkatan dari JavaScript Object Notation. Jangan terkecoh sama namanya, meski ada 'JavaScript'-nya, dia itu cuma format standar buat tuker-tukeran data yang ringan dan gampang banget dibaca manusia. Plus, machine juga gampang banget pars-nya alias ngertiinnya.

Bayangin aja, kamu punya data di PHP (misal dari database) yang mau dikirim ke frontend (aplikasi React/Vue/Angular) atau aplikasi mobile (Android/iOS). Nah, data itu perlu 'dibungkus' dalam format yang dimengerti semua pihak. Disinilah JSON jadi MVP (Most Valuable Player)! Vibesnya: Ringan, fleksibel, dan universal. Cocok banget buat API dan pertukaran data antar sistem yang beda-beda.

Struktur Dasar JSON: Gak Ribet Kok!

Strukturnya itu mirip banget sama objek di JavaScript atau array asosiatif di PHP, pakai pasangan key: value. Gampang banget kok dipahaminya.

Ada dua tipe struktur utama:

  1. Objek ({}): Koleksi pasangan key: value yang gak berurutan.

    • Key: Harus berupa string (pakai tanda kutip ganda).
    • Value: Bisa string, number, boolean (true/false), null, array, atau objek JSON lain.
    {
  "nama": "Budi Santoso",
  "umur": 23,
  "is_aktif": true,
  "email": null
}

  2. Array ([]): Daftar nilai yang berurutan. Nilainya bisa macem-macem, sama kayak di objek.

    [
  "HTML",
  "CSS",
  "JavaScript",
  "PHP"
]

Kamu juga bisa gabungin keduanya, lho. Contohnya data mahasiswa dengan beberapa mata kuliah:

{
  "nama": "Andi Permana",
  "nim": "2023001",
  "jurusan": "Teknik Informatika",
  "mata_kuliah": [
    {
      "nama_mk": "Pemrograman Web",
      "sks": 3
    },
    {
      "nama_mk": "Basis Data",
      "sks": 4
    }
  ]
}

PHP & JSON: Bestie Abis!

PHP punya built-in function yang super canggih buat nge-handle JSON, jadi kamu gak perlu pusing mikirin parsing manual. Ada dua fungsi utama yang wajib kamu kuasai biar ngoding makin lancar jaya:

1. json_encode(): Dari PHP ke JSON (Membungkus Data)

Fungsi ini buat 'mengubah' (encode) data array atau objek PHP kamu jadi string JSON. Jadi, kalau kamu punya data di PHP yang mau dikirim ke client, pakai ini!

Syntax:

json_encode(mixed $value, int $options = 0, int $depth = 512): string|false
  • $value: Data PHP (array atau objek) yang mau di-encode.
  • $options: Konstanta bitmask yang bisa kamu pakai buat ngatur output JSON (misal JSON_PRETTY_PRINT biar rapi).
  • $depth: Kedalaman maksimum. Defaultnya 512.

Contoh 1: Array Asosiatif PHP ke JSON

Skuy, kita bikin data mahasiswa dalam bentuk array asosiatif di PHP, terus kita ubah jadi JSON.

<?php

$dataMahasiswa = [
    "nama" => "Budi Santoso",
    "umur" => 23,
    "is_aktif" => true,
    "nilai" => [
        "matematika" => 90,
        "fisika" => 85
    ],
    "hobi" => ["membaca", "coding"]
];

$jsonOutput = json_encode($dataMahasiswa);

echo $jsonOutput;
// Output: {"nama":"Budi Santoso","umur":23,"is_aktif":true,"nilai":{"matematika":90,"fisika":85},"hobi":["membaca","coding"]}

?>

Tips: Pakai JSON_PRETTY_PRINT biar JSON-nya rapih dan gampang dibaca, terutama saat debugging atau output API!

<?php

$jsonOutputPretty = json_encode($dataMahasiswa, JSON_PRETTY_PRINT);

echo $jsonOutputPretty;
/* Output:
{
    "nama": "Budi Santoso",
    "umur": 23,
    "is_aktif": true,
    "nilai": {
        "matematika": 90,
        "fisika": 85
    },
    "hobi": [
        "membaca",
        "coding"
    ]
}
*/
?>

Ada juga opsi lain seperti JSON_UNESCAPED_SLASHES buat ngilangin backslash dari URL, atau JSON_UNESCAPED_UNICODE kalau kamu punya karakter unicode biar gak di-escape.

2. json_decode(): Dari JSON ke PHP (Membuka Bungkus Data)

Kalau yang ini kebalikannya, ngab. Fungsi ini buat 'mengubah' (decode) string JSON jadi data PHP. Bisa jadi array asosiatif atau objek standar. Ini berguna banget pas kamu nerima data dari API lain atau dari frontend dalam format JSON.

Syntax:

json_decode(string $json, bool $associative = false, int $depth = 512, int $options = 0): mixed
  • $json: String JSON yang mau di-decode.
  • $associative: Ini parameter PENTING!
    • Kalau true, hasilnya akan jadi array asosiatif PHP.
    • Kalau false (default), hasilnya akan jadi objek standar PHP (stdClass).
  • $depth: Kedalaman maksimum.
  • $options: Konstanta bitmask (misal JSON_BIGINT_AS_STRING buat angka besar).

Contoh 1: JSON String ke Array Asosiatif PHP

Yuk, kita spill data JSON yang tadi kita buat, terus kita ubah jadi array asosiatif di PHP.

<?php

$jsonString = '{
    "nama": "Budi Santoso",
    "umur": 23,
    "is_aktif": true,
    "nilai": {
        "matematika": 90,
        "fisika": 85
    },
    "hobi": [
        "membaca",
        "coding"
    ]
}';

// Decode jadi array asosiatif (parameter kedua di-set true)
$dataMahasiswaArray = json_decode($jsonString, true);

echo "Nama: " . $dataMahasiswaArray["nama"] . "\n";
echo "Umur: " . $dataMahasiswaArray["umur"] . "\n";
echo "Nilai Matematika: " . $dataMahasiswaArray["nilai"]["matematika"] . "\n";
echo "Hobi pertama: " . $dataMahasiswaArray["hobi"][0] . "\n";

/* Output:
Nama: Budi Santoso
Umur: 23
Nilai Matematika: 90
Hobi pertama: membaca
*/

?>

Contoh 2: JSON String ke Objek PHP

Kalau mau jadi objek standar PHP, tinggal hilangkan parameter $associative atau set ke false.

<?php

// Menggunakan jsonString yang sama
// Decode jadi objek PHP (parameter kedua di-set false atau dihilangkan)
$dataMahasiswaObject = json_decode($jsonString);

echo "Nama: " . $dataMahasiswaObject->nama . "\n";
echo "Umur: " . $dataMahasiswaObject->umur . "\n";
echo "Nilai Fisika: " . $dataMahasiswaObject->nilai->fisika . "\n";
echo "Hobi kedua: " . $dataMahasiswaObject->hobi[1] . "\n";

/* Output:
Nama: Budi Santoso
Umur: 23
Nilai Fisika: 85
Hobi kedua: coding
*/

?>

Penting! Cek Error Decode!

Fungsi json_decode() bisa balikin NULL kalau ada error (misal string JSON-nya gak valid). Makanya, wajib banget cek pakai json_last_error() dan json_last_error_msg() setelah proses decode. Ini penting banget biar aplikasi kamu robust, ngab!

<?php

$invalidJsonString = '{"nama": "Budi", "umur": 23, "email": "budi@contoh.com"'; // JSON tidak valid

$data = json_decode($invalidJsonString);

if ($data === null && json_last_error() !== JSON_ERROR_NONE) {
    echo "Gagal decode JSON, ngab! Error: " . json_last_error_msg() . "\n";
    // Misalnya, kamu bisa log error ini atau kembalikan pesan error ke user
} else {
    echo "JSON berhasil di-decode!\n";
    print_r($data);
}

?>

Implementasi Nyata: Bikin API Sederhana di PHP (Contoh)

Bayangin kamu mau bikin endpoint /api/mahasiswa yang ngembaliin data mahasiswa dalam format JSON. Gampang banget, gaes!

Bikin file api_mahasiswa.php:

<?php

// 1. Set header Content-Type biar client tahu kalau yang kita kirim itu JSON
header('Content-Type: application/json');

// 2. Siapkan data dari database atau sumber lain (ini contoh data hardcode)
$daftarMahasiswa = [
    [
        "id" => 1,
        "nama" => "Andi Permana",
        "nim" => "2023001",
        "jurusan" => "Teknik Informatika",
        "email" => "andi@example.com"
    ],
    [
        "id" => 2,
        "nama" => "Siti Aminah",
        "nim" => "2023002",
        "jurusan" => "Sistem Informasi",
        "email" => "siti@example.com"
    ],
    [
        "id" => 3,
        "nama" => "Joko Susilo",
        "nim" => "2023003",
        "jurusan" => "Ilmu Komputer",
        "email" => "joko@example.com"
    ]
];

// 3. Konversi data PHP array ke JSON string
$jsonOutput = json_encode($daftarMahasiswa, JSON_PRETTY_PRINT);

// 4. Kirim output JSON ke client
echo $jsonOutput;

// Output kalau kamu akses api_mahasiswa.php di browser/Postman:
/*
[
    {
        "id": 1,
        "nama": "Andi Permana",
        "nim": "2023001",
        "jurusan": "Teknik Informatika",
        "email": "andi@example.com"
    },
    {
        "id": 2,
        "nama": "Siti Aminah",
        "nim": "2023002",
        "jurusan": "Sistem Informasi",
        "email": "siti@example.com"
    },
    {
        "id": 3,
        "nama": "Joko Susilo",
        "nim": "2023003",
        "jurusan": "Ilmu Komputer",
        "email": "joko@example.com"
    }
]
*/

?>

Tips dan Trik Biar Ngoding Makin Auto Pro:

  1. Validasi Input JSON: Sebelum data JSON diproses lebih lanjut, pastikan JSON yang kamu terima itu valid. Selalu gunakan json_last_error() setelah json_decode() untuk ngecek validitas.
  2. Header Content-Type: Selalu kirim header Content-Type: application/json saat kamu mengembalikan respons JSON dari API PHP. Ini penting biar client (browser, aplikasi mobile, Postman, dll.) tahu cara memproses data yang kamu kirim. 
    header('Content-Type: application/json');
  3. Sanitasi Data:
    • Sebelum json_encode(): Pastikan data yang kamu ambil dari database atau input user sudah bersih dari hal-hal aneh (misal karakter XSS, SQL Injection). Selalu sanitasi data sebelum dikirim.
    • Setelah json_decode(): Data yang kamu terima dari client atau API lain setelah di-decode juga perlu divalidasi dan disanitasi lagi sebelum kamu pakai di aplikasi (misal untuk disimpan ke database).
  4. Gunakan Objek/Array Sesuai Kebutuhan: Pilih mau pakai objek atau array asosiatif saat decode (json_decode($jsonString, true) untuk array, json_decode($jsonString) untuk objek). Biasanya, array asosiatif lebih sering dipakai karena fleksibilitasnya dan kemudahannya dalam manipulasi data.
  5. Error Handling: Jangan pernah lupain error handling! Ini penting banget buat debugging dan biar aplikasi kamu robust. Selain json_last_error(), pastikan juga kamu punya mekanisme logging yang baik.

Kesimpulan

Gimana, gaes? Udah mulai kerasa kan vibes ngoding makin pro setelah kenalan sama JSON di PHP? Ini skill dasar tapi super powerful buat kamu yang mau nyemplung lebih dalam ke dunia API development, microservices, atau bahkan bikin aplikasi realtime. Kemampuan nge-handle JSON dengan baik di PHP bakal jadi kunci sukses kamu berinteraksi dengan berbagai platform dan layanan.

Yuk, langsung coba di proyek kamu sendiri biar makin jago! Jangan cuma baca, langsung praktik ya ngab. Skuy!

0.0

Berikan Rating

Komentar (0)

Silakan login untuk memberikan komentar.

Login Sekarang

Belum ada komentar. Jadilah yang pertama!

Kata Kunci

#json php #php json #json_encode #json_decode #api php #data exchange php #web development php #tutorial json php #belajar json #format data

Menyukai Artikel (0)

Belum ada siswa yang menyukai artikel ini.

Pembaca (1)

OKTAVIA AYU WULANDARI
OKTAVIA AYU WULANDARI (1x)

Rekomendasi Untukmu

Tutorial Belajar Array PHP Lengkap untuk Pemula

17 Jun 2026

Gaskan AI di PHP: Otomatisasi & Kualitas Kode Pakai ML

26 May 2026

Panduan Lengkap Struktur Kontrol PHP: IF, ELSE, ELSEIF, Switch

04 May 2026