JSON ke PHP

Rekomendasi Terkait

Tentang konverter JSON ke PHP dan pemodelan kelas entitas PHP

Kasus penggunaan

• Pengembangan backend Laravel: dengan cepat mengonversi contoh JSON dari dokumen antarmuka API menjadi kelas Eloquent Model / API Resource, langsung menserialisasi respons dengan antarmuka Jsonable / Arrayable bawaan Laravel
• Integrasi Symfony Serializer: mengonversi JSON yang dikembalikan oleh API pihak ketiga menjadi kelas PHP gaya ArrayObject, melakukan pemetaan objek terperinci dan validasi data dengan Symfony Serializer
• WordPress REST API: mengonversi struktur JSON yang dikembalikan oleh endpoint kustom menjadi kelas PHP gaya stdClass, langsung mengeluarkan dengan wp_send_json(), menyesuaikan perilaku default wp_json_encode()
• readonly DTO PHP 8.1+: mengonversi JSON menjadi final readonly class sebagai objek transfer data (DTO), tidak dapat diubah setelah konstruksi, mencegah logika bisnis salah mengubah data respons
• Pengembangan paket Composer: mengonversi JSON Schema menjadi kelas PHP lalu mempublikasikannya ke Packagist sebagai lapisan model SDK, dapat di-require dan digunakan kembali oleh proyek Composer lain
• Fixture pengujian unit: mengonversi fixture JSON menjadi kelas PHP, melakukan penggerakan data pengujian dengan json_decode + deserialisasi, melakukan asersi pada field terstruktur
• Skrip migrasi data: mengonversi file konfigurasi JSON menjadi kelas PHP untuk akses bertipe kuat dalam logika bisnis, lebih mudah untuk autocompletion IDE dan pengecekan tipe daripada akses array
• Kolaborasi Mock frontend: backend pertama mengonversi model JSON menjadi kelas PHP, frontend mendapatkan TypeScript interface / kelas PHP yang sesuai secara bersamaan untuk menjaga konsistensi tipe di kedua sisi
• Tinjauan kode: langsung mengonversi JSON respons API menjadi kelas PHP yang mudah dibaca, memudahkan diskusi penamaan field, visibilitas properti saat Code Review
• Refactoring proyek legacy: memfaktorkan ulang kode akses dinamis berdasarkan array asosiatif menjadi akses bertipe kuat berbasis kelas PHP, melakukan analisis statis dengan PHPStan / Psalm
• PHPUnit DataProvider: mengonversi data pengujian JSON menjadi kelas PHP dan menginjeksi ke kasus pengujian melalui DataProvider, IDE secara otomatis menyarankan field properti
• Koneksi API backend snake_case: ketika API backend mengembalikan field snake_case, aktifkan 'Ubah ke camelCase' + gaya ArrayObject di sistem PHP frontend untuk koneksi yang mulus
• Analisis statis PHPStan: kelas yang dihasilkan secara alami memiliki deklarasi tipe, menangkap kesalahan tipe dengan phpstan analyse --level=8 di CI
• Edukasi dan pelatihan: mengonversi contoh JSON menjadi kelas PHP dalam skenario pendidikan PHP, mendemonstrasikan pemodelan berorientasi objek, sistem tipe, implementasi antarmuka
• Lapisan API Gateway: mengonversi JSON yang dikembalikan oleh mikroservis hulu menjadi kelas PHP untuk agregasi di lapisan gateway, layanan PHP hilir mengonsumsi data bertipe kuat melalui properti kelas
• Konsumsi pesan antrean: mengonversi badan pesan JSON yang dikonsumsi dari RabbitMQ / Kafka menjadi kelas PHP untuk penyimpanan atau penerusan, melakukan parsing ketat dengan JSON_THROW_ON_ERROR
• Pemodelan SKU/SPU e-commerce: mengonversi struktur JSON produk (multi-spesifikasi/multi-gambar/multi-atribut) menjadi kelas PHP, melakukan optimalisasi kueri N+1 di Laravel dengan gaya ArrayObject
• Verifikasi tanda tangan callback WebHook: mengonversi struktur verifikasi tanda tangan JSON dari gateway pembayaran, callback logistik menjadi kelas PHP, melakukan pemeriksaan tanda tangan dengan hash_hmac()
• Toolchain OpenAPI: mengonversi JSON skema OpenAPI 3.x menjadi kelas PHP, menghubungkan ke alur pembuatan klien PHP Swagger Codegen / Apifox
• Pipeline ETL data: mengonversi JSON dari sumber data hulu (field JSON MySQL / MongoDB / Elasticsearch) menjadi kelas PHP untuk pembersihan dan penyimpanan data

Cara Penggunaan

1. Tempel objek JSON (direkomendasikan) atau array ke editor di sebelah kiri, atau klik 'Sample' untuk memuat contoh Indonesia (termasuk address / company / tags bersarang)
2. Klik tombol 'Settings' di toolbar, pilih berikut di popup: ① Atur nama kelas root (mis. User) dan namespace (mis. App\Models); ② Pilih gaya kode (ArrayObject / stdClass / readonly class); ③ Pilih fitur kode (typed properties / integrasi Laravel / Symfony Serializer); ④ Pilih strategi penamaan field (tetap asli / camelCase / semua huruf kecil / UPPER_SNAKE)
3. Alat akan mengonversi secara otomatis dalam 400ms, menampilkan semua kelas PHP yang dihasilkan di sebelah kanan (setiap kelas adalah kartu mandiri, bilah judul menampilkan badge gaya saat ini secara real-time); jika ada kesalahan format JSON, tombol 'Perbaiki JSON' akan ditampilkan
4. Periksa apakah nama kelas, nama properti, antarmuka yang dihasilkan sesuai harapan; jika perlu penyesuaian, ubah nama kunci JSON sumber atau buka kembali Settings untuk mengubah opsi
5. Setelah puas, klik tombol 'Salin' pada kelas individual untuk menempel ke IDE, atau klik 'Download ZIP' di toolbar untuk mengunduh semua kelas sekaligus (diatur menurut struktur direktori sesuai jalur namespace)

Fitur

• Dua gaya kode dapat diubah secara bebas: ArrayObject (mewarisi \ArrayObject, mendukung akses gaya array $obj['key']) / stdClass (mewarisi \stdClass, mendukung akses gaya objek $obj->key), kompatibel dengan berbagai skenario seperti serialisasi Laravel, WordPress REST, Symfony Serializer
• Template PHP lengkap: otomatis menghasilkan deklarasi namespace + pernyataan use + komentar header class (Copyright + timestamp pembuatan) + definisi class + properti public bertipe (PHP 7.4+), dapat langsung di-require ke proyek Composer tanpa melengkapi boilerplate secara manual
• Implementasi otomatis antarmuka JsonSerializable: setiap kelas otomatis menghasilkan public function jsonSerialize(): mixed { return [...] }, dapat langsung menserialisasi JSON dengan json_encode(), tanpa kode boilerplate tambahan
• Opsi readonly class PHP 8.1+: setelah diaktifkan, class yang dihasilkan akan ditambahkan final readonly class, semua properti menjadi readonly dan tidak dapat diubah setelah konstruksi, cocok untuk skenario DTO respons API yang tidak dapat diubah
• Inferensi tipe cerdas: string → string, integer → int, float → float, bool → bool, array → array, objek bersarang → class mandiri, null → ?type (properti nullable), tidak perlu menentukan tipe field secara manual
• Pemecahan kelas bersarang otomatis: objek bersarang menggunakan huruf kapital pertama dari nama field sebagai nama kelas PHP mandiri (mis. address → Address), objek dalam array mengikuti aturan 'hapus huruf s di akhir' (mis. users → User), semua kelas bersarang juga mengimplementasikan JsonSerializable
• 4 strategi penamaan field: tetap asli / snake_case ke camelCase (user_name → userName) / semua huruf kecil / gaya konstanta UPPER_SNAKE, memenuhi konvensi kode PSR-1 / Laravel / Symfony
• Integrasi sekali klik Laravel: setelah dicentang, otomatis mengimplementasikan antarmuka Jsonable, Arrayable, menambahkan metode toArray() / toJson(), dapat langsung digunakan sebagai Eloquent API Resource dengan autoload Composer
• Salin kelas tunggal + unduh ZIP banyak file: setiap kelas PHP memiliki tombol 'Salin' mandiri, paket ZIP yang diatur menurut struktur direktori namespace dapat diunduh dalam satu klik (mis. App/Models/User.php), dapat langsung digunakan setelah diekstrak
• Berjalan lokal di browser + riwayat: parsing JSON, pembuatan kelas PHP, pengemasan ZIP semuanya diselesaikan di browser oleh JavaScript (quicktype-core + JSZip), data tidak diunggah ke server; 200 input terbaru disimpan sebagai riwayat di localStorage

Contoh Kode

<?php

require_once 'vendor/autoload.php';

use App\Models\User;

// Simulasikan string JSON yang diterima dari API
$jsonString = '{"id":1,"name":"Alice","email":"a****@***********","isActive":true}';

// 1) Deserialisasi ke kelas yang dihasilkan oleh alat ini
$userData = json_decode($jsonString, true);
$user = new User(
    $userData['id'],
    $userData['name'],
    $userData['email'],
    $userData['isActive']
);

// 2) Akses field bertipe kuat (autocompletion IDE + pemeriksaan statis PHPStan)
echo $user->name;          // Alice
echo $user->email;         // a****@***********
echo $user->isActive ? 'Aktif' : 'Tidak Aktif'; // Aktif

// 3) json_encode() memanggil otomatis jsonSerialize(), tidak perlu kode tambahan
echo json_encode($user, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
/*
{
    "id": 1,
    "name": "Alice",
    "email": "a****@***********",
    "isActive": true
}
*/

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * GET /api/users/{id}
     */
    public function show(int $id): JsonResponse
    {
        // 1) Ambil data dari database atau API eksternal
        $userData = $this->fetchUserFromApi($id);

        // 2) Bungkus dengan kelas User yang dihasilkan alat ini
        $user = new User(
            $userData['id'],
            $userData['name'],
            $userData['email'],
            $userData['isActive']
        );

        // 3) Langsung return response()->json($user)
        //    Laravel akan otomatis memanggil jsonSerialize()
        return response()->json($user);
    }

    /**
     * POST /api/users
     */
    public function store(Request $request): JsonResponse
    {
        // 4) Penggunaan terbalik: deserialisasi JSON permintaan menjadi kelas User
        $user = User::fromArray($request->all());

        // 5) Dapatkan bentuk array dengan toArray()
        $payload = $user->toArray();

        // 6) Jalankan logika bisnis (seperti simpan ke DB / panggil API pihak ketiga)
        $this->userService->create($payload);

        return response()->json([
            'message' => 'User created',
            'data' => $user,
        ], 201);
    }
}

/*
 * Dependensi composer.json yang sesuai:
 * "require": {
 *     "php": "^8.1",
 *     "laravel/framework": "^11.0"
 * }
 */

<?php

namespace App\Service;

use App\Models\User;
use Symfony\Component\Serializer\SerializerInterface;
use Symfony\Component\Serializer\Normalizer\PropertyNormalizer;

class UserSerializer
{
    private SerializerInterface $serializer;

    public function __construct(SerializerInterface $serializer)
    {
        // Menggunakan PropertyNormalizer untuk menangani properti public
        $this->serializer = $serializer;
    }

    /**
     * Serialisasi objek User menjadi string JSON
     */
    public function toJson(User $user): string
    {
        return $this->serializer->serialize($user, 'json');
    }

    /**
     * Deserialisasi string JSON menjadi objek User
     */
    public function fromJson(string $json): User
    {
        return $this->serializer->deserialize($json, User::class, 'json');
    }

    /**
     * Deserialisasi batch (seperti array JSON yang diekspor dari MongoDB)
     */
    public function fromJsonArray(string $jsonArray): array
    {
        $users = [];
        $data = json_decode($jsonArray, true);

        foreach ($data as $item) {
            $users[] = User::fromArray($item);
        }

        return $users;
    }
}

// Contoh penggunaan
$serializer = new UserSerializer($serializerService);

$json = '{"id":1,"name":"Alice","address":{"city":"Beijing","zip":"100000"},"tags":["php","symfony"]}';

// Deserialisasi menjadi objek User yang dihasilkan alat ini
$user = $serializer->fromJson($json);
echo $user->name;                  // Alice
echo $user->address->city;         // Beijing (akses bertipe kuat)
print_r($user->tags);              // ['php', 'symfony']

// Serialisasi kembali ke JSON
$jsonOutput = $serializer->toJson($user);

Best Practices

Pertanyaan Umum

Pemecahan Masalah

Glosarium

namespace

Mekanisme ruang nama yang diperkenalkan PHP 5.3+ untuk menghindari bentrokan nama kelas. Alat ini secara otomatis menghasilkan berdasarkan namespace yang ditetapkan pengguna, diatur di direktori App/Models/ dalam ZIP.

class

Templat untuk mendefinisikan objek di PHP. Yang dihasilkan alat ini adalah PHP class standar, dapat langsung diinstansiasi dengan new User(...).

ArrayObject

Kelas pustaka standar SPL PHP, mengimplementasikan antarmuka seperti ArrayAccess. Kelas yang dihasilkan gaya ArrayObject alat ini mewarisi \ArrayObject, mendukung akses gaya array dan objek.

stdClass

Kelas objek generik bawaan PHP, json_decode($json, false) mengembalikan tipe ini secara default. Kelas yang dihasilkan gaya stdClass alat ini mewarisi \stdClass, hanya mendukung akses gaya objek.

typed properties

Deklarasi tipe properti yang diperkenalkan PHP 7.4+ (seperti public int $id). Properti yang dihasilkan alat ini memiliki deklarasi tipe secara default, IDE dan alat analisis statis dapat langsung melakukan pengecekan tipe.

readonly class

Kelas readonly yang diperkenalkan PHP 8.1+, semua properti dalam kelas otomatis menjadi readonly dan tidak dapat diubah setelah konstruksi. Gaya readonly alat ini menghasilkan final readonly class, cocok untuk skenario DTO yang tidak dapat diubah.

JsonSerializable

Antarmuka yang diperkenalkan PHP 5.4+. Objek yang mengimplementasikan antarmuka ini akan secara otomatis memanggil metode jsonSerialize() saat json_encode(). Semua kelas alat ini secara otomatis mengimplementasikan antarmuka ini.

Jsonable (Laravel)

Antarmuka kontrak framework Laravel. Setelah diimplementasikan, objek dapat memanggil toJson() untuk mengeluarkan JSON. Gaya integrasi Laravel alat ini secara otomatis mengimplementasikan antarmuka ini.

Arrayable (Laravel)

Antarmuka kontrak framework Laravel. Setelah diimplementasikan, objek dapat memanggil toArray() untuk mengeluarkan array. Gaya integrasi Laravel alat ini secara otomatis mengimplementasikan antarmuka ini.

Composer

Alat manajemen dependensi resmi PHP. Untuk menggunakan kode yang dihasilkan alat ini, Anda perlu mengatur autoload PSR-4 di composer.json (mis. App\\: src/).

PSR-4

Standar autoload yang ditetapkan oleh PHP-FIG, memetakan namespace ke direktori untuk memuat file kelas. Paket ZIP yang dihasilkan alat ini diatur menurut jalur namespace, sesuai dengan standar PSR-4.

Symfony Serializer

Framework serialisasi komponen Symfony. Kelas yang dihasilkan gaya ArrayObject alat ini dapat digunakan dengan PropertyNormalizer Symfony Serializer untuk serialisasi dan deserialisasi terperinci.

Eloquent API Resource

Kelas API Resource Laravel Eloquent, digunakan untuk memformat respons API. Kelas yang dihasilkan gaya integrasi Laravel alat ini dapat langsung digunakan sebagai kelas dasar API Resource.

composer.json

File konfigurasi proyek Composer. Setelah menempatkan kode yang dihasilkan alat ini di direktori src, perlu mengatur bagian autoload di composer.json dan menjalankan composer dump-autoload.

json_encode / json_decode

Fungsi serialisasi dan deserialisasi JSON bawaan PHP. Ketika kelas yang dihasilkan alat ini mengimplementasikan JsonSerializable, json_encode() akan secara otomatis memanggil metode jsonSerialize().

PHPUnit DataProvider

Mekanisme penyedia data framework pengujian PHPUnit. Kelas PHP yang dihasilkan alat ini dapat diinjeksi ke kasus pengujian sebagai DataProvider, meningkatkan efisiensi penulisan pengujian dengan autocompletion IDE.

PHPStan

Alat analisis statis PHP, melakukan pengecekan tipe dan deteksi kesalahan pada kode. Kelas yang dihasilkan alat ini memiliki typed properties, dapat sepenuhnya menyimpulkan tipe properti dalam mode --level=8 PHPStan.

Psalm

Alat analisis statis PHP open-source lainnya oleh Vimeo. Kelas yang dihasilkan alat ini dapat melakukan verifikasi tipe kuat dengan PropertyTypeProvider Psalm.

Doctrine

Toolset ORM dan DBAL ekosistem PHP. Kelas PHP yang dihasilkan alat ini dapat digunakan sebagai kerangka Doctrine Entity, kemudian tambahkan anotasi seperti #[ORM\Column] secara manual.

php -l

Perintah pemeriksaan sintaks command line PHP. Kelas yang dihasilkan alat ini dapat menjalankan verifikasi sintaks dengan php -l User.php sebelum di-require ke proyek.

Composer dump-autoload

Perintah Composer untuk membuat ulang indeks autoload. Setelah menempatkan kelas yang dihasilkan alat ini di direktori src, perlu menjalankan composer dump-autoload agar diakui oleh autoload PSR-4.

JSON_THROW_ON_ERROR

Flag penanganan kesalahan json_decode() PHP 7.3+. Setelah diaktifkan, akan melempar pengecualian JsonException saat parsing JSON gagal. Contoh Laravel alat ini menggunakan parsing ketat.

Hash (PHP)

Fungsi hash bawaan PHP, sering digunakan untuk verifikasi tanda tangan WebHook. Kelas callback WebHook yang dihasilkan alat ini melakukan pemeriksaan tanda tangan bersama hash_hmac().

Tabel referensi pemetaan tipe JSON ke tipe PHP

Perbandingan tipe data JSON yang disimpulkan otomatis oleh alat dengan tipe PHP yang sesuai:

Tabel perbandingan 4 gaya kode PHP

4 gaya kode kelas PHP yang didukung alat. Pilih sesuai kebutuhan proyek:

Privacy & Security

Semua operasi analisis JSON, pembuatan kelas PHP, pembuatan paket ZIP dari alat JSON ke PHP ini dieksekusi sepenuhnya secara lokal di browser Anda melalui JavaScript (quicktype-core + JSZip); data JSON input dan kode PHP yang dihasilkan tidak diunggah ke server mana pun, juga tidak disimpan, dicache atau disimpan di cloud. JSON sensitif yang berisi field antarmuka internal, struktur bisnis yang belum dirilis, respons API non-publik dapat digunakan dengan aman; semua data dihapus saat halaman ditutup. Alat ini tidak menggunakan Cookie apa pun untuk pelacakan pengguna, tidak mengumpulkan informasi email atau akun, tidak mengintegrasikan skrip statistik pihak ketiga; semua perhitungan terjadi di proses browser perangkat saat ini. Bahkan dalam lingkungan offline (mis. terputus atau intranet terisolasi) berfungsi normal, asalkan sumber daya halaman telah dimuat sekali.

Authoritative References

• PHP.netDokumentasi Resmi PHP - Kelas dan Objek
• PHP.netDokumentasi Resmi PHP - Antarmuka JsonSerializable
• PHP.netDokumentasi Resmi PHP - Modifier Readonly (PHP 8.1+)
• PHP.netDokumentasi Resmi PHP - Typed Properties (PHP 7.4+)
• PHP-FIGStandar Autoload PSR-4
• LaravelDokumentasi Resmi Laravel - Eloquent: API Resources
• SymfonyDokumentasi Komponen Symfony Serializer
• ComposerDokumentasi Resmi Composer - Autoload PSR-4