JSON a PHP

Relacionats

Sobre JSON a classe PHP i modelatge de classes d'entitat PHP

Casos d'ús

• Desenvolupament backend Laravel: convertir ràpidament JSON d'exemple de documentació d'interfície API en classes Eloquent Model / API Resource, serialitzar respostes directament amb interfícies Jsonable / Arrayable integrades de Laravel
• Integració Symfony Serializer: convertir JSON retornat per APIs de tercers en classes PHP estil ArrayObject, fer mapping profund d'objectes i validació de dades amb Symfony Serializer
• WordPress REST API: convertir estructura JSON retornada per endpoints personalitzats en classes PHP estil stdClass, sortida directa amb wp_send_json(), conforme al comportament per defecte de wp_json_encode()
• PHP 8.1+ readonly DTO: convertir JSON en final readonly class per a Data Transfer Object (DTO), immutables després de construcció, evitant que la lògica de negoci modifiqui accidentalment les dades de resposta
• Desenvolupament de paquets Composer: convertir JSON Schema en classes PHP després publicar a Packagist com a capa model SDK, perquè altres projectes Composer el requereixin i reutilitzin
• Fixture de tests unitaris: convertir fixture JSON en classes PHP després utilitzar amb json_decode + deserialització per a tests basats en dades, assertion de camps estructurats
• Scripts de migració de dades: convertir fitxers de configuració JSON en classes PHP després utilitzar-les per a accés fortament tipat en lògica de negoci, més fàcil autocompletat IDE i comprovació de tipus que accés array
• Integració Frontend Mock: backend converteix primer models JSON en classes PHP, frontend obté simultàniament la interfície TypeScript / classe PHP corresponent, mantenint els tipus consistents als dos extrems
• Code review: convertir JSON retornat per API directament en classes PHP llegibles, facilitant discussió sobre nomenclatura de camps, visibilitat de propietats durant Code Review
• Refactorització de projectes llegats: refactoritzar codi d'accés dinàmic basat en array associatiu en accés fortament tipat basat en classe PHP, fer anàlisi estàtica amb PHPStan / Psalm
• PHPUnit DataProvider: convertir dades de test JSON en classes PHP després injectar en cas de test mitjançant DataProvider, l'IDE suggereix automàticament els camps de propietats
• Integració API backend snake_case: API backend retorna camps snake_case, el sistema PHP frontend activa 'converteix a camelCase' + estil ArrayObject per a integració transparent
• Anàlisi estàtica PHPStan: les classes generades tenen naturalment declaracions de tipus, amb phpstan analyse --level=8 interceptar errors de tipus en CI
• Ensenyament i formació: en escenaris d'ensenyament PHP, convertir JSON d'exemple en classes PHP per demostrar modelatge orientat a objectes, sistema de tipus, implementació d'interfícies
• Capa passarel·la API: convertir JSON retornat per microserveis aigües amunt en classes PHP per a agregació en capa passarel·la, els serveis PHP aigües avall consumeixen fortament tipats mitjançant propietats de classe
• Consum de cues de missatges: convertir cossos de missatges JSON consumits de RabbitMQ / Kafka en classes PHP després emmagatzemar o reenviar, anàlisi rigorosa amb JSON_THROW_ON_ERROR
• Modelatge SKU/SPU e-commerce: convertir estructura JSON de producte (multi-especificació / multi-imatge / multi-atribut) en classes PHP, amb estil ArrayObject fer optimització de consultes N+1 a Laravel
• Verificació de signatura de callback WebHook: convertir estructura de verificació de signatura JSON de passarel·les de pagament, callbacks logístics en classes PHP, verificació de signatura amb hash_hmac()
• Toolchain OpenAPI: convertir schema JSON d'OpenAPI 3.x en classes PHP, integrar amb flux de generació de client PHP de Swagger Codegen / Apifox
• Pipeline ETL de dades: convertir JSON de fonts de dades aigües amunt (camp JSON MySQL / MongoDB / Elasticsearch) en classes PHP després neteja de dades i emmagatzematge

Com usar-ho

1. Enganxa objecte JSON (recomanat) o array a l'editor esquerre, o fes clic a 'Sample' per carregar exemple en xinès (amb address / company / tags imbricats)
2. Fes clic al botó 'Configuració' a la barra d'eines, al diàleg selecciona: ① estableix nom de classe arrel (ex. User) i namespace (ex. App\Models); ② selecciona estil de codi (ArrayObject / stdClass / readonly class); ③ selecciona funcionalitats de codi (typed properties / integració Laravel / Symfony Serializer); ④ selecciona estratègia de nomenclatura de camps (mantenir original / camelCase / tot minúscules / UPPER_SNAKE)
3. L'eina convertirà automàticament en 400ms, la dreta mostra totes les classes PHP generades (cada classe una targeta independent, la barra de títol mostra badge d'estil actual en temps real); si JSON té errors de format es mostrarà botó 'Repara JSON'
4. Verifica que els noms de classe generats, noms de propietats i interfícies compleixin les expectatives; si cal adaptació pots modificar els noms de clau del JSON font o reobrir Configuració per modificar les opcions
5. Quan satisfet pots fer clic al botó 'Copiar' de classe individual per enganxar a l'IDE, o fer clic a 'Download ZIP' a la barra d'eines per descarregar totes les classes amb un clic (estructura de directoris organitzada per camí namespace)

Característiques

• Dos estils de codi commutables lliurement: ArrayObject (estén \ArrayObject, admet accés estil array $obj['key']) / stdClass (estén \stdClass, admet accés estil objecte $obj->key), compatible amb diferents escenaris com serialització Laravel, WordPress REST, Symfony Serializer
• Plantilla PHP completa: genera automàticament declaració namespace + instruccions use + comentari de capçalera de classe (Copyright + timestamp de generació) + definició de classe + propietats públiques tipades (PHP 7.4+), es pot requerir directament en projecte Composer sense completar manualment el boilerplate
• Interfície JsonSerializable implementada automàticament: cada classe generada crea automàticament public function jsonSerialize(): mixed { return [...] }, serialitza JSON directament amb json_encode(), zero codi boilerplate addicional
• readonly class PHP 8.1+ opcional: en activar-se, la classe generada afegeix final readonly class, totes les propietats són readonly, immutables després de construcció, adequat per a escenaris DTO de resposta API immutables
• Inferència de tipus intel·ligent: string → string, integer → int, float → float, bool → bool, array → array, objectes imbricats → classe independent, null → ?type (propietat nullable), sense especificació manual de tipus de camp
• Classes imbricades dividides automàticament: objectes imbricats generen classes PHP independents amb primera lletra del nom de camp en majúscula (ex. address → Address), objectes en arrays nomenats segons regla 'eliminar s final' (ex. users → User), totes les classes imbricades també implementen JsonSerializable
• 4 estratègies de nomenclatura de camps: mantenir original / snake_case a camelCase (user_name → userName) / tot minúscules / estil constants UPPER_SNAKE, conformes a diferents estàndards de codificació PSR-1 / Laravel / Symfony
• Integració Laravel en un clic: en activar-se, implementa automàticament interfícies Jsonable, Arrayable, afegeix mètodes toArray() / toJson(), es pot utilitzar directament com Eloquent API Resource, amb autoload Composer
• Copiar classe individual + descàrrega ZIP multi-fitxer: cada classe PHP té botó 'Copiar' independent, pot descarregar amb un clic paquet ZIP organitzat per estructura de directoris namespace (ex. App/Models/User.php), descomprimir i utilitzar
• Execució local al navegador + historial: anàlisi JSON, generació de classes PHP, empaquetat ZIP mitjançant JavaScript (quicktype-core + JSZip) al navegador, dades no pujades a servidor; historial localStorage integrat per a 200 entrades recents

Exemples de codi

<?php

require_once 'vendor/autoload.php';

use App\Models\User;

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

// 1) Deserialitza a classe generada per aquesta eina
$userData = json_decode($jsonString, true);
$user = new User(
    $userData['id'],
    $userData['name'],
    $userData['email'],
    $userData['isActive']
);

// 2) Accés als camps fortament tipat (autocompletat IDE + comprovació estàtica PHPStan)
echo $user->name;          // Alice
echo $user->email;         // a****@***********
echo $user->isActive ? 'Actiu' : 'Inactiu'; // Actiu

// 3) json_encode() crida automàticament jsonSerialize(), cap codi addicional necessari
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

Preguntes freqients

Solució de problemes

Glossari

namespace

Mecanisme d'espais de noms introduït a PHP 5.3+ per evitar conflictes de noms de classe. Aquesta eina genera automàticament segons namespace configurat per usuari i organitza al ZIP per directori App/Models/.

class

Plantilla que defineix objectes a PHP. Aquesta eina genera class PHP estàndard, instanciable directament mitjançant new User(...).

ArrayObject

Classe a la biblioteca estàndard SPL de PHP que implementa interfícies com ArrayAccess. Classes generades en estil ArrayObject per aquesta eina hereten de \ArrayObject, suportant accés doble estil array i objecte.

stdClass

Classe d'objecte genèric integrada de PHP; json_decode($json, false) retorna aquest tipus per defecte. Classes generades en estil stdClass per aquesta eina hereten de \stdClass, suporten només accés estil objecte.

typed properties

Declaracions de tipus de propietat introduïdes a PHP 7.4+ (ex. public int $id). Les propietats generades per aquesta eina tenen declaracions de tipus per defecte; l'IDE i les eines d'anàlisi estàtica poden fer comprovació de tipus directament.

readonly class

Classe de només lectura introduïda a PHP 8.1+; totes les propietats de la classe són automàticament readonly, no modificables després de construcció. Aquesta eina genera final readonly class en estil readonly, adequada per a escenaris DTO immutables.

JsonSerializable

Interfície introduïda a PHP 5.4+; els objectes que implementen aquesta interfície criden automàticament el mètode jsonSerialize() durant json_encode(). Totes les classes d'aquesta eina implementen automàticament aquesta interfície.

Jsonable (Laravel)

Interfície de contracte del framework Laravel; després d'implementació, l'objecte pot cridar toJson() per retornar JSON. L'estil integració Laravel d'aquesta eina implementa automàticament aquesta interfície.

Arrayable (Laravel)

Interfície de contracte del framework Laravel; després d'implementació, l'objecte pot cridar toArray() per retornar array. L'estil integració Laravel d'aquesta eina implementa automàticament aquesta interfície.

Composer

Eina oficial de gestió de dependències de PHP. Quan utilitzis el codi generat per aquesta eina, cal configurar autoload PSR-4 a composer.json (ex. App\\: src/).

PSR-4

Estàndard d'autoload especificat per PHP-FIG, que carrega fitxers de classe mitjançant mapping de namespace a directori. El paquet ZIP generat per aquesta eina està organitzat per camí namespace, conforme a l'estàndard PSR-4.

Symfony Serializer

Framework de serialització del component Symfony. Classes generades en estil ArrayObject per aquesta eina poden col·laborar amb PropertyNormalizer de Symfony Serializer per a serialització i deserialització profundes.

Eloquent API Resource

Classe de recursos API de Laravel Eloquent, utilitzada per formatar respostes API. Classes generades en estil integració Laravel per aquesta eina es poden utilitzar directament com a classes base API Resource.

composer.json

Fitxer de configuració del projecte Composer. Després de col·locar el codi generat per aquesta eina al directori src, cal configurar secció autoload a composer.json i executar composer dump-autoload.

json_encode / json_decode

Funcions integrades de serialització i deserialització JSON de PHP. Després que classes generades per aquesta eina implementin JsonSerializable, json_encode() crida automàticament el mètode jsonSerialize().

PHPUnit DataProvider

Mecanisme de proveïdor de dades del framework de tests PHPUnit. Classes PHP generades per aquesta eina es poden injectar en cas de test com a DataProvider, millorant l'eficiència d'escriptura de tests amb autocompletat IDE.

PHPStan

Eina d'anàlisi estàtica per a PHP, pot fer comprovació de tipus, detecció d'errors en codi. Classes generades per aquesta eina, en tenir typed properties, poden tenir tipus de propietat completament inferits per PHPStan en mode --level=8.

Psalm

Una altra eina d'anàlisi estàtica per a PHP, open-source de Vimeo. Classes generades per aquesta eina, amb PropertyTypeProvider de Psalm, poden fer validació de tipus forta.

Doctrine

Conjunt d'eines ORM i DBAL en l'ecosistema PHP. Classes PHP generades per aquesta eina poden servir d'esquelet per a Doctrine Entity, després afegir manualment anotacions com #[ORM\Column].

php -l

Directiva de comprovació de sintaxi a la línia d'ordres PHP. Classes generades per aquesta eina poden primer executar php -l User.php per a validació de sintaxi abans de requerir en projecte.

Composer dump-autoload

Ordre per fer que Composer regeneri l'índex d'autoload. Després de col·locar classes generades per aquesta eina al directori src, cal executar composer dump-autoload per ser reconegudes per autoload PSR-4.

JSON_THROW_ON_ERROR

Flag per a gestió d'errors de json_decode() a PHP 7.3+; en activar-se, l'anàlisi JSON fallida llança excepció JsonException. L'exemple Laravel d'aquesta eina utilitza anàlisi rigorosa.

Hash (PHP)

Funció de hash integrada de PHP, comunament utilitzada per a verificació de signatura WebHook. Classes de callback WebHook generades per aquesta eina funcionen amb hash_hmac() per a verificació de signatura.

Taula de referència mapping de tipus JSON a tipus PHP

Tipus de dades JSON detectats automàticament per eina i referència del tipus PHP corresponent:

Taula de comparació de 4 estils de codi PHP

4 estils de codi de classe PHP suportats per l'eina; tria segons necessitats del projecte:

Privacy & Security

Totes les operacions d'anàlisi JSON, generació de classes PHP, empaquetat ZIP d'aquesta eina JSON a PHP s'executen completament localment al teu navegador mitjançant JavaScript (quicktype-core + JSZip); les dades JSON d'entrada i el codi PHP generat no es pugen a cap servidor, ni es desen, es posen en memòria cau o s'emmagatzemen al núvol. JSON sensible que conté camps d'interfície interna, estructures de negoci no llançades, respostes API no públiques es pot utilitzar amb seguretat; totes les dades s'esborren en tancar la pàgina. Aquesta eina no utilitza cap Cookie per a seguiment d'usuaris, no recull informació de correu electrònic o compte, no integra scripts d'estadístiques de tercers; tots els càlculs s'executen en procés de navegador del dispositiu actual. Fins i tot en entorn fora de línia (ex. desconnectat o intranet aïllada) funciona normalment, sempre que els recursos de la pàgina s'hagin carregat una vegada.

Authoritative References

• PHP.netDocumentació oficial PHP - Classes i objectes
• PHP.netDocumentació oficial PHP - Interfície JsonSerializable
• PHP.netDocumentació oficial PHP - Modificador Readonly (PHP 8.1+)
• PHP.netDocumentació oficial PHP - Propietats tipades (PHP 7.4+)
• PHP-FIGEstàndard Autoload PSR-4
• LaravelDocumentació oficial Laravel - Eloquent: API Resources
• SymfonyDocumentació del component Symfony Serializer
• ComposerDocumentació oficial Composer - Autoload PSR-4