JSON na PHP

Powiązane Rekomendacje

O konwerterze JSON na PHP i modelowaniu klas encji PHP

Przypadki użycia

• Rozwój backendu Laravel: szybka konwersja przykładowego JSON z dokumentacji interfejsu API na klasy Eloquent Model / API Resource, bezpośrednia serializacja odpowiedzi z wbudowanymi interfejsami Jsonable / Arrayable Laravel
• Integracja Symfony Serializer: konwersja JSON zwracanego przez API trzecich na klasy PHP w stylu ArrayObject, szczegółowe mapowanie obiektów i walidacja danych z Symfony Serializer
• WordPress REST API: konwersja struktury JSON zwracanej przez niestandardowe endpointy na klasy PHP w stylu stdClass, bezpośrednie wyjście przez wp_send_json(), dostosowanie do domyślnego zachowania wp_json_encode()
• readonly DTO PHP 8.1+: konwersja JSON na final readonly class jako obiekt transferu danych (DTO), niezmienny po konstrukcji, zapobiega błędnej modyfikacji danych odpowiedzi przez logikę biznesową
• Rozwój pakietów Composer: konwersja JSON Schema na klasy PHP a następnie opublikowanie w Packagist jako warstwa modelu SDK, może być wymagana przez require i ponownie wykorzystywana przez inne projekty Composer
• Fixture testów jednostkowych: konwersja fixture JSON na klasy PHP, napędzanie danych testowych przez json_decode + deserializacja, asercja na strukturalnych polach
• Skrypty migracji danych: konwersja plików konfiguracyjnych JSON na klasy PHP do dostępu silnie typowanego w logice biznesowej, łatwiejsze autouzupełnianie IDE i sprawdzanie typów niż dostęp tablicowy
• Współpraca z mockami frontendowymi: backend najpierw konwertuje model JSON na klasy PHP, frontend jednocześnie otrzymuje odpowiedni TypeScript interface / klasy PHP dla spójności typów po obu stronach
• Przegląd kodu: bezpośrednia konwersja JSON odpowiedzi API na czytelne klasy PHP, ułatwia dyskusję o nazewnictwie pól, widoczności właściwości podczas Code Review
• Refaktoryzacja projektów legacy: refaktoryzacja kodu z dynamicznym dostępem opartym na tablicach asocjacyjnych na silnie typowany dostęp oparty na klasach PHP, przeprowadzanie analizy statycznej z PHPStan / Psalm
• PHPUnit DataProvider: konwersja danych testowych JSON na klasy PHP i wstrzykiwanie do przypadków testowych przez DataProvider, IDE automatycznie sugeruje pola właściwości
• Połączenie z API backendu snake_case: gdy API backendu zwraca pola snake_case, włącz 'Konwertuj na camelCase' + styl ArrayObject w systemie PHP frontendowym dla bezproblemowego połączenia
• Analiza statyczna PHPStan: wygenerowane klasy naturalnie mają deklaracje typów, wychwytywanie błędów typów przez phpstan analyse --level=8 w CI
• Edukacja i szkolenia: konwersja przykładowego JSON na klasy PHP w scenariuszach edukacyjnych PHP, demonstracja modelowania obiektowego, systemu typów, implementacji interfejsów
• Warstwa API Gateway: konwersja JSON zwracanego przez mikrousługi górne na klasy PHP do agregacji w warstwie gateway, usługi PHP dolne konsumują silnie typowane dane przez właściwości klasy
• Konsumpcja wiadomości z kolejki: konwersja treści wiadomości JSON konsumowanych z RabbitMQ / Kafka na klasy PHP do magazynowania lub przekazywania, ścisłe parsowanie z JSON_THROW_ON_ERROR
• Modelowanie SKU/SPU e-commerce: konwersja struktury JSON produktu (multi-spec/multi-obraz/multi-atrybut) na klasy PHP, optymalizacja zapytań N+1 w Laravel ze stylem ArrayObject
• Weryfikacja podpisu callbacku WebHook: konwersja struktury weryfikacji podpisu JSON z bramki płatności, callbacków logistycznych na klasy PHP, sprawdzanie podpisu z hash_hmac()
• Toolchain OpenAPI: konwersja JSON schematu OpenAPI 3.x na klasy PHP, podłączenie do przepływu generowania klienta PHP Swagger Codegen / Apifox
• Potok ETL danych: konwersja JSON ze źródeł danych górnych (pole JSON MySQL / MongoDB / Elasticsearch) na klasy PHP do czyszczenia danych i magazynowania

Jak Używać

1. Wklej obiekt JSON (zalecane) lub tablicę do edytora po lewej stronie, lub kliknij 'Sample' aby załadować przykład polski (w tym zagnieżdżone address / company / tags)
2. Kliknij przycisk 'Settings' na pasku narzędzi, wybierz w okienku: ① Ustaw nazwę klasy głównej (np. User) i namespace (np. App\Models); ② Wybierz styl kodu (ArrayObject / stdClass / readonly class); ③ Wybierz funkcje kodu (typed properties / integracja Laravel / Symfony Serializer); ④ Wybierz strategię nazewnictwa pól (zachowaj oryginalne / camelCase / wszystkie małe / UPPER_SNAKE)
3. Narzędzie automatycznie przekonwertuje w ciągu 400ms, wyświetli wszystkie wygenerowane klasy PHP po prawej stronie (każda klasa to niezależna karta, pasek tytułu pokazuje aktualny badge stylu w czasie rzeczywistym); jeśli wystąpi błąd formatu JSON, wyświetli przycisk 'Napraw JSON'
4. Sprawdź, czy wygenerowana nazwa klasy, nazwa właściwości, interfejs są zgodne z oczekiwaniami; jeśli potrzeba dostosowania, zmień nazwę klucza JSON źródłowego lub ponownie otwórz Settings aby zmienić opcje
5. Po zadowoleniu kliknij przycisk 'Kopiuj' na pojedynczej klasie aby wkleić do IDE, lub kliknij 'Download ZIP' na pasku narzędzi aby pobrać wszystkie klasy naraz (zorganizowane według struktury katalogów zgodnej ze ścieżką namespace)

Funkcje

• Dwa style kodu, swobodne przełączanie: ArrayObject (dziedziczy \ArrayObject, obsługuje dostęp tablicowy $obj['key']) / stdClass (dziedziczy \stdClass, obsługuje dostęp obiektowy $obj->key), kompatybilne z serializacją Laravel, WordPress REST, Symfony Serializer i innymi scenariuszami
• Kompletny szablon PHP: automatycznie generuje deklarację namespace + instrukcje use + komentarz nagłówka klasy (Copyright + znacznik czasu generacji) + definicję klasy + typowane właściwości public (PHP 7.4+), można bezpośrednio require do projektu Composer bez ręcznego uzupełniania kodu szablonowego
• Automatyczna implementacja interfejsu JsonSerializable: każda klasa automatycznie generuje public function jsonSerialize(): mixed { return [...] }, współpracuje z json_encode() do bezpośredniej serializacji JSON, zero dodatkowego kodu szablonowego
• Opcja readonly class PHP 8.1+: po włączeniu generowana klasa otrzymuje final readonly class, wszystkie właściwości są readonly i niezmienne po konstrukcji, idealne dla scenariuszy niezmiennych DTO odpowiedzi API
• Inteligentne wnioskowanie typów: string → string, integer → int, float → float, bool → bool, array → array, zagnieżdżone obiekty → niezależna klasa, null → ?type (właściwość nullable), nie trzeba ręcznie określać typów pól
• Automatyczne rozdzielanie zagnieżdżonych klas: zagnieżdżone obiekty używają wielkiej litery nazwy pola jako nazwy niezależnej klasy PHP (np. address → Address), obiekty w tablicach stosują regułę 'usuń s na końcu' (np. users → User), wszystkie zagnieżdżone klasy również implementują JsonSerializable
• 4 strategie nazewnictwa pól: zachowaj oryginalne / snake_case na camelCase (user_name → userName) / wszystkie małe litery / styl stałych UPPER_SNAKE, spełnia konwencje kodowania PSR-1 / Laravel / Symfony
• Integracja Laravel jednym kliknięciem: po zaznaczeniu automatycznie implementuje interfejsy Jsonable, Arrayable, dodaje metody toArray() / toJson(), można bezpośrednio używać jako Eloquent API Resource z autoload Composer
• Kopiowanie pojedynczej klasy + pobieranie ZIP wielu plików: każda klasa PHP ma niezależny przycisk 'Kopiuj', pakiet ZIP zorganizowany według struktury katalogów namespace można pobrać jednym kliknięciem (np. App/Models/User.php), gotowe do użycia po rozpakowaniu
• Lokalne działanie w przeglądarce + historia: parsowanie JSON, generowanie klas PHP, pakowanie ZIP wszystkie zakończone w przeglądarce przez JavaScript (quicktype-core + JSZip), dane nie są wysyłane na serwer; ostatnie 200 wejść zapisane jako historia w localStorage

Przykłady kodu

<?php

require_once 'vendor/autoload.php';

use App\Models\User;

// 模拟从 API 接收到的 JSON 字符串
$jsonString = '{"id":1,"name":"Alice","email":"a****@***********","isActive":true}';

// 1) 反序列化为本工具生成的类
$userData = json_decode($jsonString, true);
$user = new User(
    $userData['id'],
    $userData['name'],
    $userData['email'],
    $userData['isActive']
);

// 2) 强类型访问字段（IDE 自动补全 + PHPStan 静态检查）
echo $user->name;          // Alice
echo $user->email;         // a****@***********
echo $user->isActive ? '活跃' : '禁用'; // 活跃

// 3) json_encode() 自动调用 jsonSerialize()，无需任何额外代码
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

Często Zadawane Pytania

Rozwiązywanie problemów

Słownik

namespace

Mechanizm przestrzeni nazw wprowadzony w PHP 5.3+ do unikania kolizji nazw klas. To narzędzie automatycznie generuje na podstawie namespace ustawionego przez użytkownika, organizuje w katalogu App/Models/ w ZIP.

class

Szablon do definiowania obiektów w PHP. To, co generuje to narzędzie, to standardowa klasa PHP, można bezpośrednio tworzyć instancje przez new User(...).

ArrayObject

Klasa biblioteki standardowej SPL PHP, implementuje interfejsy takie jak ArrayAccess. Klasy generowane w stylu ArrayObject tego narzędzia dziedziczą \ArrayObject, obsługują zarówno dostęp w stylu tablicowym jak i obiektowym.

stdClass

Wbudowana generyczna klasa obiektów PHP, json_decode($json, false) domyślnie zwraca ten typ. Klasy generowane w stylu stdClass tego narzędzia dziedziczą \stdClass, obsługują tylko dostęp w stylu obiektowym.

typed properties

Deklaracje typów właściwości wprowadzone w PHP 7.4+ (takie jak public int $id). Właściwości generowane przez to narzędzie domyślnie mają deklaracje typów, IDE i narzędzia analizy statycznej mogą bezpośrednio przeprowadzać sprawdzanie typów.

readonly class

Klasa readonly wprowadzona w PHP 8.1+, wszystkie właściwości w klasie automatycznie stają się readonly i nie mogą być zmieniane po konstrukcji. Styl readonly tego narzędzia generuje final readonly class, odpowiedni dla scenariuszy DTO niezmiennych.

JsonSerializable

Interfejs wprowadzony w PHP 5.4+. Obiekty implementujące ten interfejs automatycznie wywołają metodę jsonSerialize() podczas json_encode(). Wszystkie klasy tego narzędzia automatycznie implementują ten interfejs.

Jsonable (Laravel)

Interfejs kontraktu frameworka Laravel. Po zaimplementowaniu obiekt może wywołać toJson() aby wypisać JSON. Styl integracji Laravel tego narzędzia automatycznie implementuje ten interfejs.

Arrayable (Laravel)

Interfejs kontraktu frameworka Laravel. Po zaimplementowaniu obiekt może wywołać toArray() aby wypisać tablicę. Styl integracji Laravel tego narzędzia automatycznie implementuje ten interfejs.

Composer

Oficjalne narzędzie zarządzania zależnościami PHP. Aby użyć kodu wygenerowanego przez to narzędzie, musisz skonfigurować autoload PSR-4 w composer.json (np. App\\: src/).

PSR-4

Standard autoload ustanowiony przez PHP-FIG, mapuje namespace na katalogi do ładowania plików klas. Pakiet ZIP generowany przez to narzędzie jest zorganizowany według ścieżki namespace, zgodny ze standardem PSR-4.

Symfony Serializer

Framework serializacji komponentu Symfony. Klasy generowane w stylu ArrayObject tego narzędzia mogą być używane z PropertyNormalizer Symfony Serializer do szczegółowej serializacji i deserializacji.

Eloquent API Resource

Klasa API Resource Laravel Eloquent, używana do formatowania odpowiedzi API. Klasy generowane w stylu integracji Laravel tego narzędzia mogą być bezpośrednio używane jako klasa bazowa API Resource.

composer.json

Plik konfiguracyjny projektu Composer. Po umieszczeniu kodu wygenerowanego przez to narzędzie w katalogu src, trzeba skonfigurować sekcję autoload w composer.json i uruchomić composer dump-autoload.

json_encode / json_decode

Wbudowane funkcje serializacji i deserializacji JSON w PHP. Gdy klasa generowana przez to narzędzie implementuje JsonSerializable, json_encode() automatycznie wywoła metodę jsonSerialize().

PHPUnit DataProvider

Mechanizm dostawcy danych frameworka testowego PHPUnit. Klasy PHP generowane przez to narzędzie mogą być wstrzykiwane do przypadków testowych jako DataProvider, zwiększają efektywność pisania testów z autouzupełnianiem IDE.

PHPStan

Narzędzie analizy statycznej PHP, przeprowadza sprawdzanie typów i wykrywanie błędów w kodzie. Klasy generowane przez to narzędzie mają typed properties, mogą w pełni wnioskować typy właściwości w trybie --level=8 PHPStan.

Psalm

Inne narzędzie analizy statycznej PHP open-source przez Vimeo. Klasy generowane przez to narzędzie mogą przeprowadzać silną weryfikację typów z PropertyTypeProvider Psalm.

Doctrine

Zestaw narzędzi ORM i DBAL ekosystemu PHP. Klasy PHP generowane przez to narzędzie mogą być używane jako szkielet Doctrine Entity, następnie ręcznie dodawać adnotacje takie jak #[ORM\Column].

php -l

Polecenie sprawdzania składni z linii poleceń PHP. Klasy generowane przez to narzędzie mogą przejść weryfikację składni php -l User.php przed require do projektu.

Composer dump-autoload

Polecenie Composer do ponownego generowania indeksu autoload. Po umieszczeniu klas wygenerowanych przez to narzędzie w katalogu src, trzeba uruchomić composer dump-autoload aby zostały rozpoznane przez autoload PSR-4.

JSON_THROW_ON_ERROR

Flaga obsługi błędów json_decode() PHP 7.3+. Po włączeniu rzuca wyjątek JsonException przy niepowodzeniu parsowania JSON. Przykład Laravel tego narzędzia używa ścisłego parsowania.

Hash (PHP)

Wbudowana funkcja skrótu PHP, często używana do weryfikacji podpisu WebHook. Klasy callbacku WebHook generowane przez to narzędzie sprawdzają podpis razem z hash_hmac().

Tabela referencyjna mapowania typów JSON na typy PHP

Porównanie typów danych JSON automatycznie wnioskowanych przez narzędzie z odpowiadającymi typami PHP:

Tabela porównawcza 4 stylów kodu PHP

4 style kodu klas PHP obsługiwane przez narzędzie. Wybierz według potrzeb projektu:

Privacy & Security

Wszystkie operacje analizy JSON, generowania klas PHP, tworzenia pakietów ZIP tego narzędzia JSON do PHP są wykonywane całkowicie lokalnie w Twojej przeglądarce przez JavaScript (quicktype-core + JSZip); wprowadzone dane JSON i wygenerowany kod PHP nie są wysyłane na żaden serwer, nie są przechowywane, buforowane ani zapisywane w chmurze. Wrażliwe JSON zawierające pola interfejsu wewnętrznego, nieopublikowane struktury biznesowe, niepubliczne odpowiedzi API można bezpiecznie używać; wszystkie dane są usuwane po zamknięciu strony. To narzędzie nie używa żadnych plików Cookie do śledzenia użytkowników, nie zbiera adresów e-mail ani informacji o koncie, nie integruje skryptów statystycznych stron trzecich; wszystkie obliczenia odbywają się w procesie przeglądarki bieżącego urządzenia. Nawet w środowisku offline (np. rozłączenie lub izolowana intranet) działa normalnie, o ile zasoby strony zostały załadowane raz.

Authoritative References

• PHP.netOficjalna dokumentacja PHP - Klasy i obiekty
• PHP.netOficjalna dokumentacja PHP - Interfejs JsonSerializable
• PHP.netOficjalna dokumentacja PHP - Modyfikator Readonly (PHP 8.1+)
• PHP.netOficjalna dokumentacja PHP - Typed Properties (PHP 7.4+)
• PHP-FIGStandard Autoload PSR-4
• LaravelOficjalna dokumentacja Laravel - Eloquent: API Resources
• SymfonyDokumentacja komponentu Symfony Serializer
• ComposerOficjalna dokumentacja Composer - Autoload PSR-4