JSON to PHP Class Converter

{
  "order_id": "A-1001",
  "total": 59.9,
  "paid": true,
  "customer": {
    "id": 7,
    "email": "ada@example.com",
    "phone": null
  },
  "items": [
    {
      "sku": "MUG-01",
      "qty": 2
    },
    {
      "sku": "TEE-04",
      "qty": 1
    }
  ]
}

<?php

declare(strict_types=1);

// $order = Order::fromArray(json_decode($json, true, flags: JSON_THROW_ON_ERROR));

final class Order
{
    public function __construct(
        public readonly string $orderId,
        public readonly float $total,
        public readonly bool $paid,
        public readonly Customer $customer,
        /** @var list<Item> */
        public readonly array $items,
    ) {
    }

    /** @param array<string, mixed> $data */
    public static function fromArray(array $data): self
    {
        return new self(
            orderId: $data['order_id'],
            total: $data['total'],
            paid: $data['paid'],
            customer: Customer::fromArray($data['customer']),
            items: array_map(fn ($item) => Item::fromArray($item), $data['items']),
        );
    }
}

final class Customer
{
    public function __construct(
        public readonly int $id,
        public readonly string $email,
        public readonly mixed $phone,
    ) {
    }

    /** @param array<string, mixed> $data */
    public static function fromArray(array $data): self
    {
        return new self(
            id: $data['id'],
            email: $data['email'],
            phone: $data['phone'] ?? null,
        );
    }
}

final class Item
{
    public function __construct(
        public readonly string $sku,
        public readonly int $qty,
    ) {
    }

    /** @param array<string, mixed> $data */
    public static function fromArray(array $data): self
    {
        return new self(
            sku: $data['sku'],
            qty: $data['qty'],
        );
    }
}

$order = Order::fromArray(json_decode($json, true, flags: JSON_THROW_ON_ERROR));

echo $order->customer->email;
foreach ($order->items as $item) {
    echo "{$item->sku} × {$item->qty}\n";
}

// Laravel: build the DTO from a validated request or an HTTP response
$order = Order::fromArray($request->validated());
$order = Order::fromArray(Http::get($url)->throw()->json());