JSON vers PHP

Recommandations connexes

À propos de JSON vers classe PHP et modélisation de classes d'entité PHP

Cas d'utilisation

• Développement backend Laravel : convertir rapidement JSON d'exemple de documentation d'interface API en classes Eloquent Model / API Resource, sérialiser réponses directement avec interfaces Jsonable / Arrayable intégrées de Laravel
• Intégration Symfony Serializer : convertir JSON retourné par API tierces en classes PHP style ArrayObject, faire mappage d'objets profond et validation de données avec Symfony Serializer
• WordPress REST API : convertir structure JSON retournée par endpoint personnalisé en classes PHP style stdClass, sortie directe avec wp_send_json(), conforme au comportement par défaut de wp_json_encode()
• PHP 8.1+ readonly DTO : convertir JSON en final readonly class pour objets de transfert de données (DTO), immuables après construction, évitant que logique métier ne modifie accidentellement données de réponse
• Développement de paquets Composer : convertir JSON Schema en classes PHP puis publier sur Packagist comme couche modèle SDK, pour que autres projets Composer le require et réutilisent
• Fixture de tests unitaires : convertir fixture JSON en classes PHP puis utiliser json_decode + désérialisation pour tests basés sur données, assertion de champs structurés
• Scripts de migration de données : convertir fichiers de configuration JSON en classes PHP puis les utiliser pour accès fortement typé en logique métier, plus facile complétion automatique IDE et vérification de types que accès tableau
• Intégration Frontend Mock : backend convertit d'abord modèles JSON en classes PHP, frontend obtient simultanément la TypeScript interface / PHP class correspondante, maintenant types cohérents aux deux extrémités
• Revue de code : convertir JSON retourné par API directement en classes PHP lisibles, facilitant discussion de nommage de champs, visibilité de propriétés pendant Code Review
• Refactorisation de projets legacy : refactoriser code d'accès dynamique basé sur tableau associatif en accès fortement typé basé sur classe PHP, faire analyse statique avec PHPStan / Psalm
• Fournisseur de données PHPUnit : convertir données de test JSON en classes PHP puis injecter dans cas de test via DataProvider, IDE suggère automatiquement champs de propriétés
• Intégration API backend snake_case : API backend retourne champs snake_case, système PHP frontend active 'convertir en camelCase' + style ArrayObject pour intégration transparente
• Analyse statique PHPStan : classes générées ont naturellement déclarations de types, avec phpstan analyse --level=8 intercepter erreurs de type en CI
• Enseignement et formation : dans scénarios d'enseignement PHP, convertir JSON d'exemple en classes PHP pour démontrer modélisation orientée objet, système de types, implémentation d'interfaces
• Couche passerelle API Gateway : convertir JSON retourné par microservices en amont en classes PHP pour agrégation en couche passerelle, services PHP en aval consomment fortement typés par propriétés de classe
• Consommation de files de messages : convertir corps de messages JSON consommés de RabbitMQ / Kafka en classes PHP puis stocker ou réexpédier, analyse stricte avec JSON_THROW_ON_ERROR
• Modélisation SKU / SPU e-commerce : convertir structure JSON de produit (multi-spécifications / multi-images / multi-attributs) en classes PHP, avec style ArrayObject faire optimisation de requêtes N+1 dans Laravel
• Vérification de signature de callback WebHook : convertir structure de vérification de signature JSON de passerelles de paiement, callbacks logistiques en classes PHP, vérification de signature avec hash_hmac()
• Chaîne d'outils OpenAPI : convertir schema JSON d'OpenAPI 3.x en classes PHP, intégrer avec flux de génération client PHP de Swagger Codegen / Apifox
• Pipeline ETL de données : convertir JSON de sources de données en amont (champ JSON MySQL / MongoDB / Elasticsearch) en classes PHP puis nettoyage de données et stockage

Comment utiliser

1. Collez objet JSON (recommandé) ou tableau dans éditeur gauche, ou cliquez sur 'Sample' pour charger exemple en chinois (avec address / company / tags imbriqués)
2. Cliquez sur bouton 'Settings' dans barre d'outils, dans boîte de dialogue sélectionnez : ① définir nom de classe racine (ex. User) et namespace (ex. App\Models) ; ② sélectionner style de code (ArrayObject / stdClass / readonly class) ; ③ sélectionner fonctionnalités de code (typed properties / intégration Laravel / Symfony Serializer) ; ④ sélectionner stratégie de nommage de champs (conserver original / camelCase / tout en minuscules / UPPER_SNAKE)
3. Outil convertira automatiquement en 400ms, droite affiche toutes les classes PHP générées (chaque classe une carte indépendante, barre de titre affiche badge de style actuel en temps réel) ; si JSON a erreur de format affichera bouton 'Réparer JSON'
4. Vérifiez que noms de classe générés, noms de propriétés et interfaces répondent aux attentes ; si ajustement nécessaire pouvez modifier noms de clé du JSON source ou rouvrir Settings pour modifier options
5. Quand satisfait pouvez cliquer sur bouton 'Copier' de classe individuelle pour coller dans IDE, ou cliquer sur 'Download ZIP' dans barre d'outils pour télécharger toutes les classes en un clic (structure de répertoires organisée par chemin namespace)

Fonctionnalités

• Deux styles de code commutables librement : ArrayObject (étend \ArrayObject, prend en charge accès style tableau $obj['key']) / stdClass (étend \stdClass, prend en charge accès style objet $obj->key), compatible avec différents scénarios comme sérialisation Laravel, WordPress REST, Symfony Serializer
• Modèle PHP complet : génère automatiquement déclaration namespace + instructions use + commentaire d'en-tête de classe (Copyright + horodatage de génération) + définition de classe + propriétés publiques typées (PHP 7.4+), peut être require directement dans projet Composer sans compléter manuellement le boilerplate
• Interface JsonSerializable implémentée automatiquement : chaque classe génère automatiquement public function jsonSerialize(): mixed { return [...] }, sérialise JSON directement avec json_encode(), zéro code boilerplate supplémentaire
• PHP 8.1+ readonly class optionnelle : à l'activation, la classe générée ajoute final readonly class, toutes les propriétés sont readonly, immuables après construction, adapté aux scénarios DTO de réponse API immuables
• Inférence de types intelligente : string → string, integer → int, float → float, bool → bool, array → array, objets imbriqués → classe indépendante, null → ?type (propriété nullable), sans spécification manuelle des types de champ
• Classes imbriquées divisées automatiquement : objets imbriqués génèrent classes PHP indépendantes avec première lettre du nom de champ en majuscule (ex. address → Address), objets dans tableaux nommés selon règle 'supprimer s final' (ex. users → User), toutes les classes imbriquées implémentent également JsonSerializable
• 4 stratégies de nommage de champs : conserver original / snake_case vers camelCase (user_name → userName) / tout en minuscules / style constante UPPER_SNAKE, conformes aux différentes normes de code PSR-1 / Laravel / Symfony
• Intégration Laravel en un clic : en cochant, implémente automatiquement interfaces Jsonable, Arrayable, ajoute méthodes toArray() / toJson(), peut être utilisé directement comme Eloquent API Resource, avec chargement automatique Composer
• Copier classe individuelle + téléchargement multi-fichiers ZIP : chaque classe PHP a bouton 'Copier' indépendant, peut télécharger en un clic paquet ZIP organisé par structure de répertoires namespace (ex. App/Models/User.php), décompresser et utiliser
• Exécution locale dans navigateur + historique : analyse JSON, génération de classes PHP, packaging ZIP effectués dans navigateur via JavaScript (quicktype-core + JSZip), données non téléchargées vers aucun serveur ; historique localStorage intégré pour 200 entrées récentes

Exemples de code

<?php

require_once 'vendor/autoload.php';

use App\Models\User;

// Simuler chaîne JSON reçue d'API
$jsonString = '{"id":1,"name":"Alice","email":"a****@***********","isActive":true}';

// 1) Désérialiser en classe générée par cet outil
$userData = json_decode($jsonString, true);
$user = new User(
    $userData['id'],
    $userData['name'],
    $userData['email'],
    $userData['isActive']
);

// 2) Accès aux champs fortement typé (complétion automatique IDE + vérification statique PHPStan)
echo $user->name;          // Alice
echo $user->email;         // a****@***********
echo $user->isActive ? 'Actif' : 'Désactivé'; // Actif

// 3) json_encode() appelle automatiquement jsonSerialize(), aucun code supplémentaire nécessaire
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

FAQ

Dépannage

Glossaire

namespace

Mécanisme d'espaces de noms introduit dans PHP 5.3+ pour éviter conflits de noms de classe. Cet outil génère automatiquement selon namespace configuré par utilisateur et organise dans ZIP par répertoire App/Models/.

class

Modèle définissant objets dans PHP. Cet outil génère class PHP standard, instanciable directement via new User(...).

ArrayObject

Classe dans bibliothèque standard SPL de PHP qui implémente interfaces comme ArrayAccess. Classes générées en style ArrayObject par cet outil héritent de \ArrayObject, prenant en charge accès double style tableau et objet.

stdClass

Classe d'objet générique intégrée de PHP ; json_decode($json, false) retourne ce type par défaut. Classes générées en style stdClass par cet outil héritent de \stdClass, prennent uniquement en charge accès style objet.

typed properties

Déclarations de type de propriété introduites dans PHP 7.4+ (ex. public int $id). Propriétés générées par cet outil ont déclarations de type par défaut ; IDE et outils d'analyse statique peuvent faire vérification de types directement.

readonly class

Classe en lecture seule introduite dans PHP 8.1+ ; toutes les propriétés dans classe sont automatiquement readonly, non modifiables après construction. Cet outil génère final readonly class en style readonly, adapté aux scénarios DTO immuables.

JsonSerializable

Interface introduite dans PHP 5.4+ ; objets implémentant cette interface appellent automatiquement méthode jsonSerialize() lors de json_encode(). Toutes les classes de cet outil implémentent automatiquement cette interface.

Jsonable (Laravel)

Interface de contrat du framework Laravel ; après implémentation, objet peut appeler toJson() pour afficher JSON. Style intégration Laravel de cet outil implémente automatiquement cette interface.

Arrayable (Laravel)

Interface de contrat du framework Laravel ; après implémentation, objet peut appeler toArray() pour afficher tableau. Style intégration Laravel de cet outil implémente automatiquement cette interface.

Composer

Outil officiel de gestion de dépendances de PHP. Lors de l'utilisation de code généré par cet outil, nécessaire de configurer chargement automatique PSR-4 dans composer.json (ex. App\\: src/).

PSR-4

Norme de chargement automatique spécifiée par PHP-FIG, chargeant fichiers de classe via mappage namespace vers répertoire. Paquet ZIP généré par cet outil est organisé par chemin namespace, conforme à la norme PSR-4.

Symfony Serializer

Framework de sérialisation du composant Symfony. Classes générées en style ArrayObject par cet outil peuvent fonctionner avec PropertyNormalizer de Symfony Serializer pour sérialisation et désérialisation profondes.

Eloquent API Resource

Classe de ressources API de Laravel Eloquent, utilisée pour formater réponses API. Classes générées en style intégration Laravel par cet outil peuvent être utilisées directement comme classes de base API Resource.

composer.json

Fichier de configuration de projet Composer. Après avoir placé code généré par cet outil dans répertoire src, nécessaire de configurer section autoload dans composer.json et exécuter composer dump-autoload.

json_encode / json_decode

Fonctions intégrées de sérialisation et désérialisation JSON de PHP. Après que classes générées par cet outil implémentent JsonSerializable, json_encode() appelle automatiquement méthode jsonSerialize().

PHPUnit DataProvider

Mécanisme de fournisseur de données du framework de tests PHPUnit. Classes PHP générées par cet outil peuvent être injectées dans cas de test comme DataProvider, améliorant efficacité d'écriture de tests avec complétion automatique IDE.

PHPStan

Outil d'analyse statique PHP, peut faire vérification de types, détection d'erreurs sur code. Classes générées par cet outil, en ayant typed properties, peuvent avoir types de propriété complètement inférés par PHPStan en mode --level=8.

Psalm

Autre outil d'analyse statique PHP, open-source par Vimeo. Classes générées par cet outil, avec PropertyTypeProvider de Psalm, peuvent faire validation de types forte.

Doctrine

Ensemble d'outils ORM et DBAL de l'écosystème PHP. Classes PHP générées par cet outil peuvent servir de squelette pour Doctrine Entity, puis ajouter manuellement annotations comme #[ORM\Column].

php -l

Directive de vérification syntaxique en ligne de commande PHP. Classes générées par cet outil peuvent d'abord exécuter php -l User.php pour validation syntaxique avant require dans projet.

Composer dump-autoload

Commande pour que Composer régénère index de chargement automatique. Après avoir placé classes générées par cet outil dans répertoire src, doit exécuter composer dump-autoload pour être reconnues par chargement automatique PSR-4.

JSON_THROW_ON_ERROR

Indicateur de gestion d'erreurs de json_decode() dans PHP 7.3+ ; à l'activation, échec d'analyse JSON lance exception JsonException. Exemple Laravel de cet outil utilise analyse stricte.

Hash (PHP)

Fonction de hachage intégrée de PHP, couramment utilisée pour vérification de signature WebHook. Classes de callback WebHook générées par cet outil fonctionnent avec hash_hmac() pour vérification de signature.

Tableau de Référence de Mappage de Type JSON vers Type PHP

Types de données JSON inférés automatiquement par outil et référence de type PHP correspondante :

Tableau de Comparaison de 4 Styles de Code PHP

4 styles de code de classe PHP pris en charge par outil ; choisissez selon besoins du projet :

Privacy & Security

Toutes les opérations d'analyse JSON, génération de classes PHP, packaging ZIP de cet outil JSON vers PHP s'effectuent complètement localement dans votre navigateur via JavaScript (quicktype-core + JSZip) ; données JSON d'entrée et code PHP généré ne sont téléchargés vers aucun serveur, ni enregistrés, mis en cache ou stockés dans le cloud. JSON sensible contenant champs d'interface internes, structures métier non lancées, réponses API non publiques peut être utilisé en toute sécurité ; toutes les données sont effacées à la fermeture de page. Cet outil n'utilise aucun Cookie pour suivi utilisateur, ne collecte pas informations d'e-mail ou de compte, n'intègre aucun script de statistiques tiers ; tous les calculs s'effectuent dans processus de navigateur du dispositif actuel. Même en environnement hors ligne (ex. déconnecté ou environnement isolé intranet), fonctionne normalement tant que ressources de page ont été chargées une fois.

Authoritative References

• PHP.netDocumentation officielle PHP - Classes et objets
• PHP.netDocumentation officielle PHP - Interface JsonSerializable
• PHP.netDocumentation officielle PHP - Modificateur Readonly (PHP 8.1+)
• PHP.netDocumentation officielle PHP - Propriétés typées (PHP 7.4+)
• PHP-FIGNorme d'autoload PSR-4
• LaravelDocumentation officielle Laravel - Eloquent: API Resources
• SymfonyDocumentation du composant Symfony Serializer
• ComposerDocumentation officielle Composer - Autoload PSR-4