JSON to PHP

Raccomandazioni correlate

Informazioni su JSON to classe PHP e modellazione classi entità PHP

Casi d'uso

• Sviluppo backend Laravel: convertire rapidamente JSON di esempio da documentazione interfaccia API in classi Eloquent Model / API Resource, serializzare risposte direttamente con interfacce Jsonable / Arrayable integrate di Laravel
• Integrazione Symfony Serializer: convertire JSON restituito da API di terze parti in classi PHP stile ArrayObject, fare mapping oggetti profondo e validazione dati con Symfony Serializer
• WordPress REST API: convertire struttura JSON restituita da endpoint personalizzati in classi PHP stile stdClass, output diretto con wp_send_json(), conforme al comportamento predefinito di wp_json_encode()
• PHP 8.1+ readonly DTO: convertire JSON in final readonly class per Data Transfer Object (DTO), immutabili dopo costruzione, evitando che la logica di business modifichi accidentalmente i dati di risposta
• Sviluppo pacchetti Composer: convertire JSON Schema in classi PHP quindi pubblicare su Packagist come strato modello SDK, in modo che altri progetti Composer lo richiedano e riutilizzino
• Fixture test unitari: convertire fixture JSON in classi PHP quindi utilizzare json_decode + deserializzazione per test basati su dati, assertion di campi strutturati
• Script migrazione dati: convertire file di configurazione JSON in classi PHP quindi utilizzarle per accesso fortemente tipizzato nella logica di business, più facile autocompletamento IDE e controllo tipi rispetto all'accesso array
• Integrazione Frontend Mock: backend converte prima modelli JSON in classi PHP, frontend ottiene contemporaneamente l'interfaccia TypeScript / classe PHP corrispondente, mantenendo i tipi coerenti ad entrambe le estremità
• Code review: convertire JSON restituito da API direttamente in classi PHP leggibili, facilitando discussione su denominazione campi, visibilità proprietà durante Code Review
• Refactoring progetti legacy: refattorizzare codice di accesso dinamico basato su array associativo in accesso fortemente tipizzato basato su classe PHP, fare analisi statica con PHPStan / Psalm
• PHPUnit DataProvider: convertire dati di test JSON in classi PHP quindi iniettare nel caso di test tramite DataProvider, l'IDE suggerisce automaticamente i campi delle proprietà
• Integrazione API backend snake_case: API backend restituisce campi snake_case, il sistema PHP frontend attiva 'converti in camelCase' + stile ArrayObject per integrazione trasparente
• Analisi statica PHPStan: le classi generate hanno naturalmente dichiarazioni di tipo, con phpstan analyse --level=8 intercettare errori di tipo in CI
• Insegnamento e formazione: in scenari di insegnamento PHP, convertire JSON di esempio in classi PHP per dimostrare modellazione orientata agli oggetti, sistema di tipi, implementazione interfacce
• Strato gateway API: convertire JSON restituito da microservizi a monte in classi PHP per aggregazione in strato gateway, i servizi PHP a valle consumano fortemente tipizzati tramite proprietà classe
• Consumazione code di messaggi: convertire corpi di messaggi JSON consumati da RabbitMQ / Kafka in classi PHP quindi archiviare o inoltrare, analisi rigorosa con JSON_THROW_ON_ERROR
• Modellazione SKU/SPU e-commerce: convertire struttura JSON prodotto (multi-specifica / multi-immagine / multi-attributo) in classi PHP, con stile ArrayObject fare ottimizzazione query N+1 in Laravel
• Verifica firma callback WebHook: convertire struttura verifica firma JSON di gateway di pagamento, callback logistici in classi PHP, verifica firma con hash_hmac()
• Toolchain OpenAPI: convertire schema JSON di OpenAPI 3.x in classi PHP, integrare con flusso di generazione client PHP di Swagger Codegen / Apifox
• Pipeline ETL dati: convertire JSON da fonti di dati a monte (campo JSON MySQL / MongoDB / Elasticsearch) in classi PHP quindi pulizia dati e archiviazione

Come utilizzare

1. Incolla oggetto JSON (consigliato) o array nell'editor a sinistra, o clicca su 'Sample' per caricare esempio in cinese (con address / company / tags annidati)
2. Clicca sul pulsante 'Impostazioni' nella toolbar, nella finestra di dialogo seleziona: ① imposta nome classe radice (es. User) e namespace (es. App\Models); ② seleziona stile codice (ArrayObject / stdClass / readonly class); ③ seleziona funzionalità codice (typed properties / integrazione Laravel / Symfony Serializer); ④ seleziona strategia denominazione campi (mantieni originale / camelCase / tutto minuscolo / UPPER_SNAKE)
3. Lo strumento convertirà automaticamente in 400ms, la destra mostra tutte le classi PHP generate (ogni classe una scheda separata, la barra del titolo mostra badge stile attuale in tempo reale); se JSON ha errori di formato verrà visualizzato pulsante 'Ripara JSON'
4. Verifica che nomi di classe generati, nomi proprietà e interfacce soddisfino le aspettative; se è necessario un adattamento puoi modificare i nomi delle chiavi del JSON sorgente o riaprire Impostazioni per modificare le opzioni
5. Quando soddisfatto puoi cliccare sul pulsante 'Copia' della classe singola per incollare nell'IDE, o cliccare su 'Download ZIP' nella toolbar per scaricare tutte le classi in un clic (struttura directory organizzata per percorso namespace)

Funzionalità

• Due stili di codice commutabili liberamente: ArrayObject (estende \ArrayObject, supporta accesso stile array $obj['key']) / stdClass (estende \stdClass, supporta accesso stile oggetto $obj->key), compatibile con diversi scenari come serializzazione Laravel, WordPress REST, Symfony Serializer
• Template PHP completo: genera automaticamente dichiarazione namespace + istruzioni use + commento intestazione classe (Copyright + timestamp generazione) + definizione classe + proprietà pubbliche tipizzate (PHP 7.4+), utilizzabile direttamente tramite require in progetto Composer senza completare manualmente il boilerplate
• Interfaccia JsonSerializable implementata automaticamente: ogni classe generata crea automaticamente public function jsonSerialize(): mixed { return [...] }, serializza JSON direttamente con json_encode(), zero codice boilerplate aggiuntivo
• readonly class PHP 8.1+ opzionale: all'attivazione, la classe generata aggiunge final readonly class, tutte le proprietà sono readonly, immutabili dopo costruzione, adatto a scenari DTO risposta API immutabili
• Inferenza tipi intelligente: string → string, integer → int, float → float, bool → bool, array → array, oggetti annidati → classe indipendente, null → ?type (proprietà nullable), senza specificazione manuale dei tipi di campo
• Classi annidate divise automaticamente: oggetti annidati generano classi PHP indipendenti con prima lettera nome campo maiuscola (es. address → Address), oggetti in array nominati secondo regola 'rimuovi s finale' (es. users → User), tutte le classi annidate implementano anche JsonSerializable
• 4 strategie denominazione campi: mantieni originale / snake_case a camelCase (user_name → userName) / tutto minuscolo / stile costanti UPPER_SNAKE, conformi a diversi standard di codifica PSR-1 / Laravel / Symfony
• Integrazione Laravel in un clic: all'attivazione, implementa automaticamente interfacce Jsonable, Arrayable, aggiunge metodi toArray() / toJson(), utilizzabile direttamente come Eloquent API Resource, con autoload Composer
• Copia classe singola + download ZIP multi-file: ogni classe PHP ha pulsante 'Copia' separato, può scaricare in un clic pacchetto ZIP organizzato per struttura directory namespace (es. App/Models/User.php), decomprimere e utilizzare
• Esecuzione locale nel browser + cronologia: analisi JSON, generazione classi PHP, creazione pacchetto ZIP tramite JavaScript (quicktype-core + JSZip) nel browser, dati non caricati su server; cronologia localStorage integrata per 200 voci recenti

Esempi di codice

<?php

require_once 'vendor/autoload.php';

use App\Models\User;

// Simula stringa JSON ricevuta da API
$jsonString = '{"id":1,"name":"Alice","email":"a****@***********","isActive":true}';

// 1) Deserializza in classe generata da questo strumento
$userData = json_decode($jsonString, true);
$user = new User(
    $userData['id'],
    $userData['name'],
    $userData['email'],
    $userData['isActive']
);

// 2) Accesso ai campi fortemente tipizzato (autocompletamento IDE + controllo statico PHPStan)
echo $user->name;          // Alice
echo $user->email;         // a****@***********
echo $user->isActive ? 'Attivo' : 'Disattivato'; // Attivo

// 3) json_encode() chiama automaticamente jsonSerialize(), nessun codice aggiuntivo necessario
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) 从数据库或外部 API 获取数据
        $userData = $this->fetchUserFromApi($id);

        // 2) 用本工具生成的 User 类包装
        $user = new User(
            $userData['id'],
            $userData['name'],
            $userData['email'],
            $userData['isActive']
        );

        // 3) 直接 return response()->json($user)
        //    Laravel 会自动调用 jsonSerialize()
        return response()->json($user);
    }

    /**
     * POST /api/users
     */
    public function store(Request $request): JsonResponse
    {
        // 4) 反向用法：把请求 JSON 反序列化为 User 类
        $user = User::fromArray($request->all());

        // 5) 用 toArray() 获取数组形式
        $payload = $user->toArray();

        // 6) 执行业务逻辑（如入库 / 调用第三方 API）
        $this->userService->create($payload);

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

/*
 * 对应 composer.json 依赖：
 * "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)
    {
        // 使用 PropertyNormalizer 处理 public 属性
        $this->serializer = $serializer;
    }

    /**
     * 将 User 对象序列化为 JSON 字符串
     */
    public function toJson(User $user): string
    {
        return $this->serializer->serialize($user, 'json');
    }

    /**
     * 将 JSON 字符串反序列化为 User 对象
     */
    public function fromJson(string $json): User
    {
        return $this->serializer->deserialize($json, User::class, 'json');
    }

    /**
     * 批量反序列化（如从 MongoDB 导出的 JSON 数组）
     */
    public function fromJsonArray(string $jsonArray): array
    {
        $users = [];
        $data = json_decode($jsonArray, true);

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

        return $users;
    }
}

// 使用示例
$serializer = new UserSerializer($serializerService);

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

// 反序列化为本工具生成的 User 对象
$user = $serializer->fromJson($json);
echo $user->name;                  // Alice
echo $user->address->city;         // Beijing (强类型访问)
print_r($user->tags);              // ['php', 'symfony']

// 序列化回 JSON
$jsonOutput = $serializer->toJson($user);

Best Practices

Domande frequenti

Risoluzione dei problemi

Glossario

namespace

Meccanismo di namespace introdotto in PHP 5.3+ per evitare conflitti di nomi di classe. Questo strumento genera automaticamente in base al namespace configurato dall'utente e organizza nel ZIP per directory App/Models/.

class

Modello che definisce oggetti in PHP. Questo strumento genera class PHP standard, istanziabile direttamente tramite new User(...).

ArrayObject

Classe nella libreria standard SPL di PHP che implementa interfacce come ArrayAccess. Le classi generate in stile ArrayObject da questo strumento ereditano da \ArrayObject, supportando accesso doppio stile array e oggetto.

stdClass

Classe oggetto generica integrata di PHP; json_decode($json, false) restituisce questo tipo per impostazione predefinita. Le classi generate in stile stdClass da questo strumento ereditano da \stdClass, supportano solo accesso stile oggetto.

typed properties

Dichiarazioni di tipo di proprietà introdotte in PHP 7.4+ (es. public int $id). Le proprietà generate da questo strumento hanno dichiarazioni di tipo per impostazione predefinita; l'IDE e gli strumenti di analisi statica possono eseguire il controllo dei tipi direttamente.

readonly class

Classe di sola lettura introdotta in PHP 8.1+; tutte le proprietà nella classe sono automaticamente readonly, non modificabili dopo costruzione. Questo strumento genera final readonly class in stile readonly, adatto a scenari DTO immutabili.

JsonSerializable

Interfaccia introdotta in PHP 5.4+; gli oggetti che implementano questa interfaccia chiamano automaticamente il metodo jsonSerialize() durante json_encode(). Tutte le classi di questo strumento implementano automaticamente questa interfaccia.

Jsonable (Laravel)

Interfaccia di contratto del framework Laravel; dopo l'implementazione, l'oggetto può chiamare toJson() per restituire JSON. Lo stile integrazione Laravel di questo strumento implementa automaticamente questa interfaccia.

Arrayable (Laravel)

Interfaccia di contratto del framework Laravel; dopo l'implementazione, l'oggetto può chiamare toArray() per restituire array. Lo stile integrazione Laravel di questo strumento implementa automaticamente questa interfaccia.

Composer

Strumento ufficiale di gestione delle dipendenze di PHP. Quando si utilizza il codice generato da questo strumento, è necessario configurare l'autoload PSR-4 in composer.json (es. App\\: src/).

PSR-4

Standard di autoload specificato da PHP-FIG, che carica i file di classe tramite mapping namespace a directory. Il pacchetto ZIP generato da questo strumento è organizzato per percorso namespace, conforme allo standard PSR-4.

Symfony Serializer

Framework di serializzazione del componente Symfony. Le classi generate in stile ArrayObject da questo strumento possono collaborare con PropertyNormalizer di Symfony Serializer per serializzazione e deserializzazione profonde.

Eloquent API Resource

Classe di risorse API di Laravel Eloquent, utilizzata per formattare le risposte API. Le classi generate in stile integrazione Laravel da questo strumento possono essere utilizzate direttamente come classi base API Resource.

composer.json

File di configurazione del progetto Composer. Dopo aver posizionato il codice generato da questo strumento nella directory src, è necessario configurare la sezione autoload in composer.json ed eseguire composer dump-autoload.

json_encode / json_decode

Funzioni integrate di serializzazione e deserializzazione JSON di PHP. Dopo che le classi generate da questo strumento implementano JsonSerializable, json_encode() chiama automaticamente il metodo jsonSerialize().

PHPUnit DataProvider

Meccanismo di fornitore di dati del framework di test PHPUnit. Le classi PHP generate da questo strumento possono essere iniettate nel caso di test come DataProvider, migliorando l'efficienza di scrittura dei test con l'autocompletamento IDE.

PHPStan

Strumento di analisi statica per PHP, può eseguire controllo dei tipi, rilevazione di errori sul codice. Le classi generate da questo strumento, avendo typed properties, possono avere i tipi di proprietà completamente dedotti da PHPStan in modalità --level=8.

Psalm

Un altro strumento di analisi statica per PHP, open-source di Vimeo. Le classi generate da questo strumento, con PropertyTypeProvider di Psalm, possono eseguire una validazione dei tipi forte.

Doctrine

Set di strumenti ORM e DBAL nell'ecosistema PHP. Le classi PHP generate da questo strumento possono servire da scheletro per Doctrine Entity, quindi aggiungere manualmente annotazioni come #[ORM\Column].

php -l

Direttiva di controllo sintassi nella riga di comando PHP. Le classi generate da questo strumento possono prima eseguire php -l User.php per la validazione della sintassi prima di richiederle nel progetto.

Composer dump-autoload

Comando per far sì che Composer rigeneri l'indice di autoload. Dopo aver posizionato le classi generate da questo strumento nella directory src, è necessario eseguire composer dump-autoload per essere riconosciute dall'autoload PSR-4.

JSON_THROW_ON_ERROR

Flag per la gestione degli errori di json_decode() in PHP 7.3+; all'attivazione, l'analisi JSON fallita lancia eccezione JsonException. L'esempio Laravel di questo strumento utilizza l'analisi rigorosa.

Hash (PHP)

Funzione di hash integrata di PHP, comunemente utilizzata per la verifica della firma WebHook. Le classi di callback WebHook generate da questo strumento funzionano con hash_hmac() per la verifica della firma.

Tabella di riferimento mapping tipo JSON a tipo PHP

Tipi di dati JSON rilevati automaticamente dallo strumento e riferimento del tipo PHP corrispondente:

Tabella di confronto 4 stili di codice PHP

4 stili di codice classe PHP supportati dallo strumento; scegli in base alle esigenze del progetto:

Privacy & Security

Tutte le operazioni di analisi JSON, generazione classi PHP, creazione pacchetto ZIP di questo strumento JSON to PHP avvengono completamente localmente nel tuo browser tramite JavaScript (quicktype-core + JSZip); i dati JSON di input e il codice PHP generato non vengono caricati su nessun server, né salvati, messi in cache o archiviati nel cloud. JSON sensibile contenente campi interfaccia interni, strutture business non rilasciate, risposte API non pubbliche può essere utilizzato in sicurezza; tutti i dati vengono cancellati alla chiusura della pagina. Questo strumento non utilizza alcun Cookie per il tracciamento degli utenti, non raccoglie informazioni di e-mail o account, non integra script di statistiche di terze parti; tutti i calcoli avvengono nel processo del browser del dispositivo attuale. Anche in ambiente offline (es. disconnesso o intranet isolato) funziona normalmente, a condizione che le risorse della pagina siano state caricate una volta.

Authoritative References

• PHP.netDocumentazione ufficiale PHP - Classi e oggetti
• PHP.netDocumentazione ufficiale PHP - Interfaccia JsonSerializable
• PHP.netDocumentazione ufficiale PHP - Modificatore Readonly (PHP 8.1+)
• PHP.netDocumentazione ufficiale PHP - Proprietà tipizzate (PHP 7.4+)
• PHP-FIGStandard Autoload PSR-4
• LaravelDocumentazione ufficiale Laravel - Eloquent: API Resources
• SymfonyDocumentazione componente Symfony Serializer
• ComposerDocumentazione ufficiale Composer - Autoload PSR-4