JSON'dan PHP'ye

İlgili Öneriler

JSON'dan PHP'ye ve PHP varlık modelleme hakkında

Kullanım senaryoları

• Laravel backend geliştirme: API belgesi örnek JSON'ını hızla Eloquent Model / API Resource sınıflarına dönüştürme, Laravel yerleşik Jsonable / Arrayable arayüzleriyle doğrudan yanıt serileştirme
• Symfony Serializer entegrasyonu: üçüncü taraf API'den dönen JSON'ı ArrayObject stili PHP sınıflarına dönüştürme, Symfony Serializer ile derin nesne eşleştirme ve veri doğrulama
• WordPress REST API: özel endpoint'ten dönen JSON yapısını stdClass stili PHP sınıflarına dönüştürme, wp_send_json() ile doğrudan çıktı, wp_json_encode() varsayılan davranışıyla eşleşme
• PHP 8.1+ readonly DTO: JSON'ı Veri Aktarım Nesneleri (DTO) için final readonly class'a dönüştürme, kurulumdan sonra değiştirilemez, iş mantığının yanıt verilerini yanlışlıkla değiştirmesini önleme
• Composer paketi geliştirme: JSON Şeması'nı PHP sınıflarına dönüştürdükten sonra SDK model katmanı olarak Packagist'te yayınlama, require ile diğer Composer projeleri tarafından yeniden kullanılma
• Birim test fixture'ı: JSON fixture'ı PHP sınıflarına dönüştürme, ardından test verisi sürmek için json_decode + seri durumdan çıkarma, yapısal alanlar üzerinde doğrulama
• Veri taşıma betikleri: JSON yapılandırma dosyalarını güçlü türlü iş mantığı erişimi için PHP sınıflarına dönüştürme, dizi erişiminden daha iyi IDE otomatik tamamlama ve tür denetimi
• Frontend Mock entegrasyonu: backend önce JSON modellerini PHP sınıflarına dönüştürür; frontend aynı anda karşılık gelen TypeScript arayüzü / PHP sınıfını alır, iki uçta türleri tutarlı tutar
• Kod incelemesi: API'den dönen JSON'ı doğrudan okunabilir PHP sınıflarına dönüştürme, Kod İncelemesi sırasında alan adlandırma, özellik görünürlüğü tartışmasını kolaylaştırma
• Eski proje yeniden düzenleme: ilişkisel diziler üzerinden dinamik olarak erişilen kodu güçlü türlü PHP sınıf erişimine yeniden düzenleme, PHPStan / Psalm ile statik analiz
• PHPUnit DataProvider: JSON test verilerini PHP sınıflarına dönüştürme ve DataProvider aracılığıyla test durumlarına enjekte etme, IDE özellik alanlarını otomatik önerir
• snake_case backend API entegrasyonu: backend API snake_case alanları döndürür; frontend PHP sistemi sorunsuz entegrasyon için 'camelCase'e dönüştür' + ArrayObject stili etkinleştirir
• PHPStan statik analizi: üretilen sınıflar doğal olarak tür bildirimleriyle gelir; CI'da phpstan analyse --level=8 ile tür hatalarını yakalama
• Öğretim ve eğitim: PHP öğretim senaryolarında örnek JSON'ı PHP sınıflarına dönüştürerek OOP modelleme, tür sistemi, arayüz uygulamasını gösterme
• API Gateway katmanı: yukarı akış mikro hizmetlerinden dönen JSON'ı ağ geçidi katmanı toplama için PHP sınıflarına dönüştürme; aşağı akış PHP hizmetleri sınıf özellikleri üzerinden güçlü türlü tüketir
• Mesaj kuyruğu tüketimi: RabbitMQ / Kafka'dan tüketilen JSON mesaj gövdelerini PHP sınıflarına dönüştürüp depolama veya iletme; JSON_THROW_ON_ERROR ile sıkı ayrıştırma
• E-ticaret SKU / SPU modelleme: ürün JSON yapılarını (çoklu özellik/çoklu görüntü/çoklu nitelik) PHP sınıflarına dönüştürme, Laravel'de N+1 sorgu optimizasyonu için ArrayObject stili ile
• WebHook geri çağırma imza doğrulaması: ödeme ağ geçitlerinden, lojistik geri çağırmalardan gelen JSON imza doğrulama yapılarını PHP sınıflarına dönüştürme, hash_hmac() ile imza doğrulama
• OpenAPI araç zinciri: OpenAPI 3.x şema JSON'ını PHP sınıflarına dönüştürme, Swagger Codegen / Apifox PHP istemci üretim akışıyla entegrasyon
• Veri ETL boru hattı: yukarı akış veri kaynaklarından (MySQL JSON alanları / MongoDB / Elasticsearch) gelen JSON'ı PHP sınıflarına dönüştürüp veri temizleme ve depolama

Nasıl Kullanılır

1. Sol düzenleyiciye JSON nesnesi (önerilen) veya dizisi yapıştırın, veya Çince örneği yüklemek için 'Sample'a tıklayın (iç içe address / company / tags ile)
2. Araç çubuğundaki 'Ayarlar' düğmesine tıklayın; açılır pencerede şunları seçin: ① kök sınıf adını (örn. User) ve namespace'i (örn. App\Models) ayarlayın; ② kod stilini seçin (ArrayObject / stdClass / readonly class); ③ kod özelliklerini seçin (typed properties / Laravel entegrasyonu / Symfony Serializer); ④ alan adlandırma stratejisini seçin (orijinali koru / camelCase / tümü küçük / UPPER_SNAKE)
3. Araç 400ms içinde otomatik olarak dönüştürür; sağda tüm üretilen PHP sınıfları görüntülenir (her sınıf bağımsız bir kart, başlık çubuğu gerçek zamanlı olarak mevcut stil rozetini gösterir); JSON'da biçim hatası varsa 'JSON'ı Onar' düğmesi görünür
4. Üretilen sınıf adları, özellik adları ve arayüzlerin beklentilerle eşleştiğini kontrol edin; ayarlama gerekiyorsa, kaynak JSON anahtar adlarını değiştirin veya seçenekleri değiştirmek için Ayarlar'ı yeniden açın
5. Memnun kaldığınızda, IDE'ye yapıştırmak için tek sınıf 'Kopyala' düğmesine tıklayın veya tüm sınıfları tek tıkla indirmek için araç çubuğundaki 'Download ZIP'e tıklayın (namespace yoluna göre düzenlenmiş dizin yapısı)

Özellikler

• İki kod stili özgürce değiştirilebilir: ArrayObject (\ArrayObject'ten miras alır, $obj['key'] dizi tarzı erişimi destekler) / stdClass (\stdClass'ten miras alır, $obj->key nesne tarzı erişimi destekler), Laravel serileştirme, WordPress REST, Symfony Serializer ve diğer senaryolarla uyumlu
• Tam PHP şablonu: otomatik olarak namespace bildirimi + use ifadeleri + sınıf başlık yorumu (Copyright + üretim zaman damgası) + sınıf tanımı + typed public özellikler (PHP 7.4+) üretir, manuel şablon kodu eklemeden doğrudan Composer projesine require edilebilir
• JsonSerializable arayüzü otomatik uygulanır: her sınıf otomatik olarak public function jsonSerialize(): mixed { return [...] } üretir, json_encode() ile doğrudan JSON serileştirir, sıfır ekstra şablon kodu
• PHP 8.1+ readonly class isteğe bağlı: etkinleştirildiğinde üretilen sınıfa final readonly class eklenir, tüm özellikler readonly olur, kurulumdan sonra değiştirilemez, API yanıtı DTO'ların değişmez senaryoları için uygundur
• Akıllı tür çıkarımı: string → string, integer → int, float → float, bool → bool, array → array, iç içe nesneler → bağımsız class, null → ?type (nullable özellik), alan türlerini manuel belirtmeye gerek yok
• İç içe sınıflar otomatik ayrılır: iç içe nesneler, alan adının büyük harfi kullanılarak bağımsız PHP sınıfları üretir (örn. address → Address), dizilerdeki nesneler 'sondaki s'yi kaldır' kuralıyla adlandırılır (örn. users → User), tüm iç içe sınıflar da JsonSerializable arayüzünü uygular
• 4 alan adlandırma stratejisi: orijinali koru / snake_case camelCase'e (user_name → userName) / tümü küçük harf / UPPER_SNAKE sabit stili, PSR-1 / Laravel / Symfony kod sözleşmelerine uyar
• Laravel tek tıkla entegrasyon: işaretlendiğinde Jsonable, Arrayable arayüzlerini otomatik uygular, toArray() / toJson() metodları ekler, Composer autoload ile doğrudan Eloquent API Resource olarak kullanılabilir
• Tek sınıf kopyalama + ZIP çoklu dosya indirme: her PHP sınıfının bağımsız 'Kopyala' düğmesi vardır, namespace dizin yapısına göre düzenlenmiş ZIP paketi tek tıkla indirilebilir (örn. App/Models/User.php), açıp kullanın
• Tarayıcıda yerel çalışma + geçmiş: JSON ayrıştırma, PHP sınıf üretme, ZIP paketleme tümü JavaScript (quicktype-core + JSZip) ile tarayıcıda tamamlanır, veriler hiçbir sunucuya yüklenmez; son 200 giriş için yerleşik localStorage geçmişi

Kod Örnekleri

<?php

require_once 'vendor/autoload.php';

use App\Models\User;

// 模拟从 API 接收到的 JSON 字符串
$jsonString = '{"id":1,"name":"Alice","email":"alice@example.com","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;         // alice@example.com
echo $user->isActive ? '活跃' : '禁用'; // 活跃

// 3) json_encode() 自动调用 jsonSerialize()，无需任何额外代码
echo json_encode($user, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
/*
{
    "id": 1,
    "name": "Alice",
    "email": "alice@example.com",
    "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

Sık Sorulan Sorular

Sorun Giderme

Sözlük

namespace

Sınıf adı çakışmalarını önlemek için PHP 5.3+'da tanıtılan ad alanı mekanizması. Bu araç kullanıcı tarafından ayarlanan namespace'e göre otomatik olarak üretir ve ZIP'te App/Models/ dizinine göre düzenler.

class

PHP'de nesneleri tanımlayan şablon. Bu aracın ürettiği standart PHP sınıflarıdır, new User(...) ile doğrudan örneklenebilir.

ArrayObject

ArrayAccess gibi arayüzleri uygulayan PHP SPL standart kitaplık sınıfı. Bu araç tarafından ArrayObject stilinde üretilen sınıflar \ArrayObject'ten miras alır, hem dizi stili hem de nesne stili çift erişimi destekler.

stdClass

PHP'nin yerleşik genel nesne sınıfı; json_decode($json, false) varsayılan olarak bu türü döndürür. Bu araç tarafından stdClass stilinde üretilen sınıflar \stdClass'ten miras alır, yalnızca nesne stili erişimi destekler.

typed properties

PHP 7.4+'da tanıtılan özellik tür bildirimleri (örn. public int $id). Bu araç tarafından üretilen özellikler varsayılan olarak tür bildirimlerine sahiptir; IDE ve statik analiz araçları doğrudan tür denetimi yapabilir.

readonly class

PHP 8.1+'da tanıtılan readonly sınıf; sınıftaki tüm özellikler otomatik olarak readonly olur, kurulumdan sonra değiştirilemez. Bu araç readonly stilinde final readonly class üretir, DTO değişmez senaryoları için uygundur.

JsonSerializable

PHP 5.4+'da tanıtılan arayüz; bu arayüzü uygulayan nesneler json_encode() çağrıldığında otomatik olarak jsonSerialize() metodunu çağırır. Bu araçtaki tüm sınıflar otomatik olarak bu arayüzü uygular.

Jsonable (Laravel)

Laravel çerçevesinin sözleşme arayüzü; uygulandıktan sonra nesne JSON çıkarmak için toJson() çağırabilir. Bu aracın Laravel entegrasyon stili otomatik olarak bu arayüzü uygular.

Arrayable (Laravel)

Laravel çerçevesinin sözleşme arayüzü; uygulandıktan sonra nesne dizi çıkarmak için toArray() çağırabilir. Bu aracın Laravel entegrasyon stili otomatik olarak bu arayüzü uygular.

Composer

PHP resmi bağımlılık yönetim aracı. Bu araç tarafından üretilen kodu kullanırken, composer.json'da PSR-4 autoload yapılandırılması gerekir (örn. App\\: src/).

PSR-4

PHP-FIG tarafından belirlenen, sınıf dosyalarını ad alanından dizine eşleme yoluyla yükleyen otomatik yükleme standardı. Bu araç tarafından üretilen ZIP paketi namespace yoluna göre düzenlenir, PSR-4 standardına uygundur.

Symfony Serializer

Symfony bileşeninin serileştirme çerçevesi. Bu araç tarafından ArrayObject stilinde üretilen sınıflar, derin serileştirme ve seri durumdan çıkarma için Symfony Serializer'ın PropertyNormalizer'ı ile çalışabilir.

Eloquent API Resource

API yanıtlarını biçimlendirmek için Laravel Eloquent API kaynak sınıfı. Bu araç tarafından Laravel entegrasyon stilinde üretilen sınıflar doğrudan API Resource temel sınıfları olarak kullanılabilir.

composer.json

Composer projesinin yapılandırma dosyası. Bu araç tarafından üretilen kodu src dizinine yerleştirdikten sonra, composer.json'da autoload bölümünü yapılandırmak ve composer dump-autoload yürütmek gerekir.

json_encode / json_decode

PHP'nin yerleşik JSON serileştirme ve seri durumdan çıkarma işlevleri. Bu araç tarafından üretilen sınıflar JsonSerializable'ı uyguladıktan sonra, json_encode() otomatik olarak jsonSerialize() metodunu çağırır.

PHPUnit DataProvider

PHPUnit test çerçevesinin veri sağlayıcı mekanizması. Bu araç tarafından üretilen PHP sınıfları DataProvider olarak test durumlarına enjekte edilebilir, IDE otomatik tamamlama ile test yazma verimliliğini artırır.

PHPStan

PHP statik analiz aracı, kod üzerinde tür denetimi ve hata tespiti yapabilir. Bu araç tarafından üretilen sınıflar, typed properties sahip oldukları için PHPStan'ın --level=8 modunda özellik türlerini tam olarak çıkarabilir.

Psalm

Vimeo tarafından açık kaynaklı başka bir PHP statik analiz aracı. Bu araç tarafından üretilen sınıflar, Psalm'in PropertyTypeProvider'ı ile güçlü tür doğrulaması yapabilir.

Doctrine

PHP ekosistemindeki ORM ve DBAL araç seti. Bu araç tarafından üretilen PHP sınıfları Doctrine Entity için iskelet görevi görebilir, ardından #[ORM\Column] gibi ek açıklamalar manuel olarak eklenir.

php -l

PHP komut satırı sözdizimi denetimi yönergesi. Bu araç tarafından üretilen sınıflar projeye require etmeden önce sözdizimi doğrulaması için önce php -l User.php çalıştırılabilir.

Composer dump-autoload

Composer'ın otomatik yükleme dizinini yeniden oluşturma komutu. Bu araç tarafından üretilen sınıfları src dizinine yerleştirdikten sonra, PSR-4 autoload tarafından tanınması için composer dump-autoload yürütülmesi zorunludur.

JSON_THROW_ON_ERROR

PHP 7.3+'daki json_decode() hata işleme bayrağı; etkinleştirildiğinde JSON ayrıştırma hatası JsonException istisnası fırlatır. Bu aracın Laravel örneği sıkı ayrıştırma kullanır.

Hash (PHP)

PHP'nin yerleşik karma işlevi, genellikle WebHook imza doğrulaması için kullanılır. Bu araç tarafından üretilen WebHook geri çağırma sınıfları imza doğrulaması için hash_hmac() ile çalışır.

JSON Türünden PHP Türüne Eşleme Hile Sayfası

Araç tarafından otomatik olarak çıkarılan JSON veri türleri ve karşılık gelen PHP tür referansı:

PHP 4 Kod Stili Karşılaştırma Tablosu

Araç tarafından desteklenen 4 PHP sınıf kod stili; proje ihtiyaçlarına göre seçin:

Privacy & Security

Bu JSON'dan PHP'ye aracının tüm JSON ayrıştırma, PHP sınıf üretme, ZIP paketleme işlemleri JavaScript (quicktype-core + JSZip) ile tamamen tarayıcınızda yerel olarak tamamlanır; girilen JSON verileri ve üretilen PHP kodu hiçbir sunucuya yüklenmez, kaydedilmez, önbelleğe alınmaz veya bulutta depolanmaz. Dahili arayüz alanları, yayınlanmamış iş yapıları, yayınlanmamış API yanıtları içeren hassas JSON'lar güvenle kullanılabilir; tüm veriler sayfa kapatıldığında temizlenir. Bu araç kullanıcı izleme için hiçbir Çerez kullanmaz, e-posta veya hesap bilgisi toplamaz, hiçbir üçüncü taraf analiz betiği yerleştirmez; tüm hesaplamalar mevcut cihazın tarayıcı işleminde tamamlanır. Çevrimdışı ortamda bile (örn. bağlantı kesik veya intranet izole ortam), sayfa kaynakları bir kez yüklendikten sonra normal şekilde çalışır.

Authoritative References

• PHP.netPHP Resmi Belgeleri - Sınıflar ve Nesneler
• PHP.netPHP Resmi Belgeleri - JsonSerializable Arayüzü
• PHP.netPHP Resmi Belgeleri - Readonly Değiştirici (PHP 8.1+)
• PHP.netPHP Resmi Belgeleri - Typed Properties (PHP 7.4+)
• PHP-FIGPSR-4 Otomatik Yükleme Standardı
• LaravelLaravel Resmi Belgeleri - Eloquent: API Resources
• SymfonySymfony Serializer Bileşeni Belgeleri
• ComposerComposer Resmi Belgeleri - PSR-4 Autoload