JSON naar PHP

Gerelateerde aanbevelingen

Over JSON naar PHP klasse en PHP entiteitsklasse modellering

Toepassingsgevallen

• Laravel backend ontwikkeling: snel JSON voorbeeld van API interface documentatie converteren naar Eloquent Model / API Resource klassen, antwoorden direct serialiseren met geïntegreerde Jsonable / Arrayable interfaces van Laravel
• Symfony Serializer integratie: JSON geretourneerd door derde partij API's converteren naar PHP klassen in ArrayObject stijl, diep object mapping en gegevensvalidatie doen met Symfony Serializer
• WordPress REST API: JSON structuur geretourneerd door aangepaste endpoints converteren naar PHP klassen in stdClass stijl, directe uitvoer met wp_send_json(), conform standaardgedrag van wp_json_encode()
• PHP 8.1+ readonly DTO: JSON converteren naar final readonly class voor Data Transfer Objects (DTO), onveranderbaar na constructie, voorkomend dat bedrijfslogica per ongeluk antwoordgegevens wijzigt
• Composer pakket ontwikkeling: JSON Schema converteren naar PHP klassen dan publiceren op Packagist als SDK modellaag, zodat andere Composer projecten het require en hergebruiken
• Unit test fixtures: JSON fixtures converteren naar PHP klassen dan gebruiken met json_decode + deserialisatie voor gegevensgebaseerde tests, assertion van gestructureerde velden
• Gegevensmigratie scripts: JSON configuratiebestanden converteren naar PHP klassen dan gebruiken voor sterk getypte toegang in bedrijfslogica, makkelijker IDE autocompletion en typecontrole dan array toegang
• Frontend Mock integratie: backend converteert eerst JSON modellen naar PHP klassen, frontend krijgt tegelijkertijd de bijbehorende TypeScript interface / PHP klasse, houdt typen consistent aan beide uiteinden
• Code review: JSON geretourneerd door API direct converteren naar leesbare PHP klassen, vergemakkelijkt discussie over veldnaamgeving, eigenschapszichtbaarheid tijdens Code Review
• Legacy project refactoring: dynamische toegangscode gebaseerd op associatieve array refactoren naar sterk getypte toegang gebaseerd op PHP klasse, statische analyse doen met PHPStan / Psalm
• PHPUnit DataProvider: JSON testgegevens converteren naar PHP klassen dan injecteren in testcase via DataProvider, IDE suggereert automatisch eigenschapsvelden
• Backend API integratie snake_case: backend API retourneert snake_case velden, frontend PHP systeem activeert 'converteer naar camelCase' + ArrayObject stijl voor naadloze integratie
• Statische analyse PHPStan: gegenereerde klassen hebben natuurlijk typedeclaraties, met phpstan analyse --level=8 typefouten onderscheppen in CI
• Onderwijs en training: in PHP onderwijsscenario's, voorbeeld JSON converteren naar PHP klassen om objectgeoriënteerd modelleren, typesysteem, interface implementatie te demonstreren
• API gateway laag: JSON geretourneerd door upstream microservices converteren naar PHP klassen voor aggregatie in gatewaylaag, downstream PHP diensten consumeren sterk getypt via klasse-eigenschappen
• Berichtenwachtrij consumptie: JSON berichtlichamen geconsumeerd van RabbitMQ / Kafka converteren naar PHP klassen dan opslaan of doorsturen, rigoureuze analyse met JSON_THROW_ON_ERROR
• E-commerce SKU/SPU modellering: product JSON structuur (multi-specificatie / multi-afbeelding / multi-attribuut) converteren naar PHP klassen, met ArrayObject stijl N+1 query optimalisatie doen in Laravel
• WebHook callback handtekeningverificatie: JSON handtekeningverificatiestructuur van betalingsgateways, logistieke callbacks converteren naar PHP klassen, handtekeningverificatie met hash_hmac()
• OpenAPI toolchain: OpenAPI 3.x JSON schema converteren naar PHP klassen, integreren met PHP client generatie workflow van Swagger Codegen / Apifox
• Gegevens ETL pipeline: JSON van upstream gegevensbronnen (MySQL JSON veld / MongoDB / Elasticsearch) converteren naar PHP klassen dan gegevensopschoning en opslag

Hoe te gebruiken

1. Plak JSON object (aanbevolen) of array in linker editor, of klik op 'Sample' om Chinees voorbeeld te laden (met geneste address / company / tags)
2. Klik op 'Instellingen' knop in werkbalk, selecteer in dialoog: ① stel root klassenaam in (bijv. User) en namespace (bijv. App\Models); ② selecteer codestijl (ArrayObject / stdClass / readonly class); ③ selecteer codefunctionaliteiten (typed properties / Laravel integratie / Symfony Serializer); ④ selecteer veldnaamgevingsstrategie (origineel behouden / camelCase / alles kleine letters / UPPER_SNAKE)
3. Tool converteert automatisch binnen 400ms, rechts toont alle gegenereerde PHP klassen (elke klasse een aparte kaart, titelbalk toont huidige stijl badge in realtime); als JSON formaatfouten heeft wordt knop 'JSON repareren' weergegeven
4. Controleer dat gegenereerde klassenamen, eigenschapnamen en interfaces aan verwachtingen voldoen; als aanpassing nodig kunt u sleutelnamen van bron JSON wijzigen of Instellingen opnieuw openen om opties te wijzigen
5. Wanneer tevreden kunt u op 'Kopiëren' knop van individuele klasse klikken om in IDE te plakken, of op 'Download ZIP' in werkbalk klikken om alle klassen in één klik te downloaden (mapstructuur georganiseerd op namespace pad)

Functies

• Twee vrij schakelbare codestijlen: ArrayObject (breidt \ArrayObject uit, ondersteunt array-stijl toegang $obj['key']) / stdClass (breidt \stdClass uit, ondersteunt object-stijl toegang $obj->key), compatibel met verschillende scenario's zoals Laravel serialisatie, WordPress REST, Symfony Serializer
• Compleet PHP sjabloon: genereert automatisch namespace declaratie + use statements + klasse header commentaar (Copyright + generatie timestamp) + klassedefinitie + openbare getypte eigenschappen (PHP 7.4+), direct via require in Composer project te gebruiken zonder handmatig boilerplate aan te vullen
• Automatisch geïmplementeerde JsonSerializable interface: elke gegenereerde klasse maakt automatisch public function jsonSerialize(): mixed { return [...] }, serialiseert JSON direct met json_encode(), nul extra boilerplate code
• Optionele PHP 8.1+ readonly class: bij activering voegt gegenereerde klasse final readonly class toe, alle eigenschappen zijn readonly, onveranderbaar na constructie, geschikt voor scenario's met onveranderlijke API response DTO's
• Intelligente type inferentie: string → string, integer → int, float → float, bool → bool, array → array, geneste objecten → onafhankelijke klasse, null → ?type (nullable eigenschap), zonder handmatige veldtypespecificatie
• Geneste klassen automatisch opgesplitst: geneste objecten genereren onafhankelijke PHP klassen met eerste letter van veldnaam hoofdletter (bijv. address → Address), objecten in arrays benoemd volgens regel 'verwijder s aan het eind' (bijv. users → User), alle geneste klassen implementeren ook JsonSerializable
• 4 veldnaamgevingsstrategieën: origineel behouden / snake_case naar camelCase (user_name → userName) / alles kleine letters / UPPER_SNAKE constante stijl, conform verschillende coderingsstandaarden PSR-1 / Laravel / Symfony
• Laravel integratie met één klik: bij activering automatisch Jsonable, Arrayable interfaces geïmplementeerd, toArray() / toJson() methodes toegevoegd, direct bruikbaar als Eloquent API Resource, met Composer autoload
• Kopieer individuele klasse + multi-file ZIP download: elke PHP klasse heeft aparte 'Kopiëren' knop, kan met één klik ZIP-pakket downloaden, georganiseerd op namespace mapstructuur (bijv. App/Models/User.php), uitpakken en gebruiken
• Lokale browser uitvoering + geschiedenis: JSON analyse, PHP klasse generatie, ZIP pakketvorming via JavaScript (quicktype-core + JSZip) in browser, gegevens niet geüpload naar server; geïntegreerde localStorage geschiedenis voor 200 recente items

Codevoorbeelden

<?php

require_once 'vendor/autoload.php';

use App\Models\User;

// Simuleer JSON string ontvangen van API
$jsonString = '{"id":1,"name":"Alice","email":"a****@***********","isActive":true}';

// 1) Deserialiseer naar klasse gegenereerd door deze tool
$userData = json_decode($jsonString, true);
$user = new User(
    $userData['id'],
    $userData['name'],
    $userData['email'],
    $userData['isActive']
);

// 2) Sterk getypte veldtoegang (IDE autocompletion + PHPStan statische controle)
echo $user->name;          // Alice
echo $user->email;         // a****@***********
echo $user->isActive ? 'Actief' : 'Inactief'; // Actief

// 3) json_encode() roept automatisch jsonSerialize() aan, geen extra code nodig
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

Veelgestelde vragen

Probleemoplossing

Woordenlijst

namespace

Naamruimte mechanisme geïntroduceerd in PHP 5.3+ om klassenaamconflicten te voorkomen. Deze tool genereert automatisch volgens door gebruiker geconfigureerde namespace en organiseert in ZIP per map App/Models/.

class

Sjabloon die objecten definieert in PHP. Deze tool genereert standaard PHP class, direct instantieerbaar via new User(...).

ArrayObject

Klasse in PHP's standaard SPL bibliotheek die interfaces zoals ArrayAccess implementeert. Klassen gegenereerd in ArrayObject stijl door deze tool erven van \ArrayObject, ondersteunen dubbele array en object toegangsstijl.

stdClass

Ingebouwde generieke objectklasse van PHP; json_decode($json, false) retourneert dit type standaard. Klassen gegenereerd in stdClass stijl door deze tool erven van \stdClass, ondersteunen alleen object-stijl toegang.

typed properties

Eigenschapstypedeclaraties geïntroduceerd in PHP 7.4+ (bijv. public int $id). Eigenschappen gegenereerd door deze tool hebben standaard typedeclaraties; IDE en statische analysetools kunnen direct typecontrole doen.

readonly class

Alleen-lezen klasse geïntroduceerd in PHP 8.1+; alle eigenschappen in de klasse zijn automatisch readonly, niet wijzigbaar na constructie. Deze tool genereert final readonly class in readonly stijl, geschikt voor onveranderlijke DTO scenario's.

JsonSerializable

Interface geïntroduceerd in PHP 5.4+; objecten die deze interface implementeren roepen automatisch methode jsonSerialize() aan tijdens json_encode(). Alle klassen van deze tool implementeren automatisch deze interface.

Jsonable (Laravel)

Contract interface van Laravel framework; na implementatie kan object toJson() aanroepen om JSON weer te geven. Laravel integratie stijl van deze tool implementeert automatisch deze interface.

Arrayable (Laravel)

Contract interface van Laravel framework; na implementatie kan object toArray() aanroepen om array weer te geven. Laravel integratie stijl van deze tool implementeert automatisch deze interface.

Composer

Officieel afhankelijkheidsbeheer hulpmiddel van PHP. Bij gebruik van door deze tool gegenereerde code is het nodig om PSR-4 autoload te configureren in composer.json (bijv. App\\: src/).

PSR-4

Autoload standaard gespecificeerd door PHP-FIG, die klassebestanden laadt via namespace naar map mapping. ZIP-pakket gegenereerd door deze tool is georganiseerd per namespace pad, voldoet aan PSR-4 standaard.

Symfony Serializer

Serialisatie framework van Symfony component. Klassen gegenereerd in ArrayObject stijl door deze tool kunnen samenwerken met PropertyNormalizer van Symfony Serializer voor diepe serialisatie en deserialisatie.

Eloquent API Resource

API resource klasse van Laravel Eloquent, gebruikt voor het formatteren van API antwoorden. Klassen gegenereerd in Laravel integratie stijl door deze tool kunnen direct worden gebruikt als API Resource basisklassen.

composer.json

Configuratiebestand van Composer project. Na plaatsen van door deze tool gegenereerde code in src map, is het nodig om autoload sectie in composer.json te configureren en composer dump-autoload uit te voeren.

json_encode / json_decode

Ingebouwde JSON serialisatie en deserialisatie functies van PHP. Nadat klassen gegenereerd door deze tool JsonSerializable implementeren, roept json_encode() automatisch methode jsonSerialize() aan.

PHPUnit DataProvider

Gegevensleverancier mechanisme van PHP testframework PHPUnit. PHP klassen gegenereerd door deze tool kunnen als DataProvider in testcase worden geïnjecteerd, verbeteren efficiëntie van het schrijven van tests met IDE autocompletion.

PHPStan

Statische analysetool voor PHP, kan typecontrole, foutdetectie op code doen. Klassen gegenereerd door deze tool, met typed properties, kunnen eigenschapstypen volledig laten afleiden door PHPStan in --level=8 modus.

Psalm

Nog een statische analysetool voor PHP, open-source van Vimeo. Klassen gegenereerd door deze tool kunnen met Psalms PropertyTypeProvider sterke typevalidatie doen.

Doctrine

Set van ORM en DBAL tools in PHP ecosysteem. PHP klassen gegenereerd door deze tool kunnen dienen als skelet voor Doctrine Entity, dan handmatig annotaties zoals #[ORM\Column] toevoegen.

php -l

Syntaxcontrole instructie in PHP opdrachtregel. Klassen gegenereerd door deze tool kunnen eerst php -l User.php uitvoeren voor syntaxvalidatie voor require in project.

Composer dump-autoload

Opdracht om Composer autoload index te laten regenereren. Na plaatsen van klassen gegenereerd door deze tool in src map, moet composer dump-autoload worden uitgevoerd om te worden herkend door PSR-4 autoload.

JSON_THROW_ON_ERROR

Flag voor foutafhandeling van json_decode() in PHP 7.3+; bij activering gooit mislukte JSON analyse JsonException. Laravel voorbeeld van deze tool gebruikt rigoureuze analyse.

Hash (PHP)

Ingebouwde hash functie van PHP, veelgebruikt voor WebHook handtekeningverificatie. WebHook callback klassen gegenereerd door deze tool werken met hash_hmac() voor handtekeningverificatie.

Referentietabel JSON type naar PHP type mapping

JSON datatypen automatisch gedetecteerd door tool en referentie van bijbehorend PHP type:

Vergelijkingstabel 4 PHP codestijlen

4 door tool ondersteunde PHP klasse codestijlen; kies op basis van projectbehoeften:

Privacy & Security

Alle JSON analyse, PHP klasse generatie, ZIP pakketvorming bewerkingen van deze JSON naar PHP tool vinden volledig lokaal plaats in uw browser via JavaScript (quicktype-core + JSZip); ingevoerde JSON gegevens en gegenereerde PHP code worden naar geen enkele server geüpload, noch opgeslagen, in cache geplaatst of opgeslagen in de cloud. Gevoelige JSON met interne interface velden, niet uitgebrachte bedrijfsstructuren, niet-openbare API antwoorden kan veilig worden gebruikt; alle gegevens worden gewist bij pagina sluiting. Deze tool gebruikt geen enkele Cookie voor gebruiker tracking, verzamelt geen e-mail of accountinformatie, integreert geen derde partij statistiekscripts; alle berekeningen vinden plaats in browserproces van het huidige apparaat. Zelfs in offline omgeving (bijv. losgekoppeld of geïsoleerd intranet) werkt het normaal, zolang paginabronnen eenmaal zijn geladen.

Authoritative References

• PHP.netPHP Officiële Documentatie - Klassen en objecten
• PHP.netPHP Officiële Documentatie - JsonSerializable-interface
• PHP.netPHP Officiële Documentatie - Readonly-modificator (PHP 8.1+)
• PHP.netPHP Officiële Documentatie - Getypte eigenschappen (PHP 7.4+)
• PHP-FIGPSR-4 Autoload-standaard
• LaravelLaravel Officiële Documentatie - Eloquent: API Resources
• SymfonySymfony Serializer-component Documentatie
• ComposerComposer Officiële Documentatie - PSR-4 Autoload