JSON sang PHP

Đề xuất Liên quan

Về JSON to PHP class và mô hình hóa lớp thực thể PHP

Trường hợp sử dụng

• Phát triển backend Laravel: Chuyển đổi nhanh JSON mẫu từ tài liệu giao diện API thành lớp Eloquent Model / API Resource, tuần tự hóa phản hồi với giao diện Jsonable / Arrayable tích hợp sẵn của Laravel
• Tích hợp Symfony Serializer: Chuyển đổi JSON trả về từ API bên thứ ba thành lớp PHP kiểu ArrayObject, sử dụng Symfony Serializer để ánh xạ đối tượng sâu và xác thực dữ liệu
• WordPress REST API: Chuyển đổi cấu trúc JSON trả về từ endpoint tùy chỉnh thành lớp PHP kiểu stdClass, xuất trực tiếp với wp_send_json(), phù hợp với hành vi mặc định của wp_json_encode()
• readonly DTO PHP 8.1+: Chuyển đổi JSON thành final readonly class, sử dụng làm đối tượng truyền dữ liệu (DTO), làm cho nó bất biến sau khi khởi tạo, ngăn chặn logic kinh doanh vô tình sửa đổi dữ liệu phản hồi
• Phát triển gói Composer: Chuyển đổi JSON Schema thành lớp PHP, sau đó xuất bản lên Packagist để sử dụng làm lớp mô hình SDK, các dự án Composer khác có thể require để tái sử dụng
• Đối tượng cố định cho kiểm thử đơn vị: Chuyển đổi đối tượng cố định JSON thành lớp PHP, sau đó thực hiện kiểm thử dựa trên dữ liệu kiểm thử thông qua json_decode + giải tuần tự hóa, khẳng định các trường có cấu trúc
• Tập lệnh di chuyển dữ liệu: Chuyển đổi tệp cấu hình JSON thành lớp PHP, sử dụng truy cập kiểu mạnh trong logic kinh doanh, dễ dàng tự động hoàn thành IDE và kiểm tra kiểu hơn so với truy cập mảng
• Liên kết Mock phía trước: Backend trước tiên chuyển đổi mô hình JSON thành lớp PHP, phía trước đồng thời nhận giao diện TypeScript / lớp PHP tương ứng, duy trì tính nhất quán kiểu ở cả hai phía
• Đánh giá mã: Chuyển đổi JSON trả về từ API thành lớp PHP dễ đọc, thuận tiện cho việc thảo luận về đặt tên trường, khả năng hiển thị thuộc tính trong Code Review
• Tái cấu trúc dự án kế thừa: Tái cấu trúc mã dựa trên truy cập động mảng liên kết array thành truy cập kiểu mạnh dựa trên lớp PHP, thực hiện phân tích tĩnh với PHPStan / Psalm
• PHPUnit DataProvider: Chuyển đổi dữ liệu kiểm thử JSON thành lớp PHP, sau đó đưa vào trường hợp kiểm thử thông qua DataProvider, IDE tự động đề xuất trường thuộc tính
• Liên kết API backend snake_case: Khi API backend trả về trường snake_case, bật 'Chuyển thành camelCase' + kiểu ArrayObject trong hệ thống PHP phía trước để liên kết mượt mà
• Phân tích tĩnh PHPStan: Lớp được tạo mặc định bao gồm khai báo kiểu, có thể sử dụng phpstan analyse ./src --level=8 trong CI để chặn lỗi kiểu
• Giáo dục và đào tạo: Trong kịch bản giảng dạy PHP, chuyển đổi JSON mẫu thành lớp PHP để trình diễn mô hình hóa hướng đối tượng, hệ thống kiểu, triển khai giao diện
• Lớp cổng API Gateway: Chuyển đổi JSON trả về từ microservice thượng nguồn thành lớp PHP để tập hợp ở lớp cổng, các dịch vụ PHP hạ nguồn tiêu thụ kiểu mạnh thông qua thuộc tính lớp
• Tiêu thụ hàng đợi tin nhắn: Chuyển đổi nội dung tin nhắn JSON tiêu thụ từ RabbitMQ / Kafka thành lớp PHP, sau đó lưu trữ hoặc chuyển tiếp, thực hiện phân tích cú pháp nghiêm ngặt với JSON_THROW_ON_ERROR
• Mô hình hóa SKU / SPU thương mại điện tử: Chuyển đổi cấu trúc JSON sản phẩm (nhiều thông số kỹ thuật / nhiều hình ảnh / nhiều thuộc tính) thành lớp PHP, tối ưu hóa truy vấn N+1 trong Laravel cùng với kiểu ArrayObject
• Xác thực callback WebHook: Chuyển đổi cấu trúc JSON xác thực của cổng thanh toán, callback hậu cần thành lớp PHP, xác thực chữ ký với hash_hmac()
• Chuỗi công cụ OpenAPI: Chuyển đổi schema JSON của OpenAPI 3.x thành lớp PHP, kết nối với luồng tạo ứng dụng khách PHP của Swagger Codegen / Apifox
• Đường ống ETL dữ liệu: Chuyển đổi JSON từ nguồn dữ liệu thượng nguồn (trường JSON MySQL / MongoDB / Elasticsearch) thành lớp PHP, sau đó làm sạch và tải dữ liệu

Cách Sử dụng

1. Dán đối tượng JSON (khuyến nghị) hoặc mảng vào trình soạn thảo bên trái, hoặc nhấp vào 'Sample' để tải mẫu tiếng Trung chứa address / company / tags lồng nhau
2. Nhấp vào nút 'Settings' trên thanh công cụ, chọn trong cửa sổ bật lên: ① Đặt tên lớp gốc (ví dụ: User) và namespace (ví dụ: App\Models); ② Chọn kiểu mã (ArrayObject / stdClass / readonly class); ③ Chọn kiểu mã (typed properties / Tích hợp Laravel / Symfony Serializer); ④ Chọn chiến lược đặt tên trường (Giữ nguyên / camelCase / tất cả chữ thường / UPPER_SNAKE)
3. Công cụ sẽ tự động chuyển đổi trong vòng 400ms, bên phải sẽ hiển thị tất cả các lớp PHP được tạo (mỗi lớp là thẻ độc lập, thanh tiêu đề hiển thị huy hiệu kiểu hiện tại theo thời gian thực); nếu có lỗi định dạng JSON, nút 'Sửa lỗi JSON' sẽ hiển thị
4. Xác nhận xem tên lớp, tên thuộc tính, giao diện được tạo có khớp với mong đợi không; nếu cần điều chỉnh, sửa đổi tên khóa trong JSON gốc hoặc mở lại Settings để sửa đổi các tùy chọn
5. Nếu hài lòng, nhấp vào nút 'Sao chép' của lớp riêng lẻ để dán vào IDE, hoặc nhấp vào 'Download ZIP' trên thanh công cụ để tải xuống tất cả các lớp cùng một lúc (cấu trúc thư mục theo đường dẫn namespace)

Tính năng

• Hai kiểu mã chuyển đổi tự do: ArrayObject (kế thừa \ArrayObject, hỗ trợ truy cập kiểu mảng $obj['key']) / stdClass (kế thừa \stdClass, hỗ trợ truy cập kiểu đối tượng $obj->key), tương thích với nhiều kịch bản như tuần tự hóa Laravel, WordPress REST, Symfony Serializer
• Mẫu PHP hoàn chỉnh: Tự động tạo khai báo namespace + câu lệnh use + chú thích đầu lớp (Copyright + dấu thời gian tạo) + định nghĩa lớp + thuộc tính public có kiểu (PHP 7.4+), có thể require trực tiếp vào dự án Composer mà không cần viết mã soạn sẵn thủ công
• Tự động triển khai giao diện JsonSerializable: Mỗi lớp tự động tạo public function jsonSerialize(): mixed { return [...] }, có thể tuần tự hóa JSON trực tiếp với json_encode() mà không cần mã soạn sẵn bổ sung
• Tùy chọn readonly class PHP 8.1+: Sau khi bật, các lớp được tạo sẽ thêm final readonly class, tất cả thuộc tính trở thành readonly, không thể thay đổi sau khi khởi tạo, phù hợp cho kịch bản API response DTO bất biến
• Suy luận kiểu thông minh: string → string, integer → int, float → float, bool → bool, array → array, đối tượng lồng nhau → lớp độc lập, null → ?type (thuộc tính nullable), không cần chỉ định kiểu trường thủ công
• Tự động tách lớp lồng nhau: Các đối tượng lồng nhau sử dụng tên trường viết hoa làm đầu để tạo lớp PHP độc lập (ví dụ: address → Address), đối tượng trong mảng được đặt tên theo quy tắc 'bỏ s ở cuối' (ví dụ: users → User), tất cả lớp lồng nhau cũng triển khai JsonSerializable
• 4 chiến lược đặt tên trường: Giữ nguyên / chuyển snake_case thành camelCase (user_name → userName) / tất cả chữ thường / kiểu hằng UPPER_SNAKE, phù hợp với chuẩn mã PSR-1 / Laravel / Symfony
• Tích hợp Laravel một cú nhấp: Sau khi chọn, tự động triển khai giao diện Jsonable, Arrayable, thêm phương thức toArray() / toJson(), có thể sử dụng trực tiếp làm Eloquent API Resource với autoload Composer
• Sao chép lớp đơn + Tải xuống ZIP nhiều tệp: Mỗi lớp PHP có nút 'Sao chép' độc lập, bạn cũng có thể nhấp vào 'Tải xuống ZIP' trên thanh công cụ để tải xuống gói ZIP (ví dụ: App/Models/User.php) được cấu trúc theo thư mục namespace, giải nén là sử dụng ngay
• Chạy cục bộ trên trình duyệt + lịch sử: Phân tích cú pháp JSON, tạo lớp PHP, đóng gói ZIP đều hoàn thành bằng JavaScript (quicktype-core + JSZip) trong trình duyệt, dữ liệu không được tải lên bất kỳ máy chủ nào; tích hợp lịch sử localStorage cho 200 đầu vào gần đây

Ví dụ mã

<?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;         // a****@***********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

Câu hỏi Thường gặp

Xử lý sự cố

Thuật ngữ

namespace

Cơ chế không gian tên được giới thiệu trong PHP 5.3+ để ngăn chặn xung đột tên lớp. Công cụ này tự động tạo theo namespace do người dùng đặt và cấu trúc thư mục App/Models/ trong ZIP.

class

Mẫu định nghĩa đối tượng trong PHP. Những gì công cụ này tạo là lớp PHP tiêu chuẩn, có thể khởi tạo trực tiếp bằng new User(...).

ArrayObject

Lớp trong thư viện chuẩn PHP SPL, triển khai các giao diện như ArrayAccess. Lớp được tạo theo kiểu ArrayObject của công cụ này kế thừa \ArrayObject, hỗ trợ truy cập kép kiểu mảng và kiểu đối tượng.

stdClass

Lớp đối tượng chung tích hợp sẵn của PHP, json_decode($json, false) mặc định trả về kiểu này. Lớp được tạo theo kiểu stdClass của công cụ này kế thừa \stdClass, chỉ hỗ trợ truy cập kiểu đối tượng.

typed properties

Khai báo kiểu thuộc tính được giới thiệu trong PHP 7.4+ (ví dụ: public int $id). Các thuộc tính do công cụ này tạo mặc định bao gồm khai báo kiểu, cho phép IDE và công cụ phân tích tĩnh kiểm tra kiểu trực tiếp.

readonly class

Lớp chỉ đọc được giới thiệu trong PHP 8.1+, tất cả các thuộc tính trong lớp tự động trở thành readonly và không thể sửa đổi sau khi khởi tạo. Kiểu readonly của công cụ này tạo final readonly class, phù hợp cho kịch bản DTO bất biến.

JsonSerializable

Giao diện được giới thiệu trong PHP 5.4+, các đối tượng triển khai giao diện này sẽ tự động gọi phương thức jsonSerialize() khi được xử lý bởi json_encode(). Tất cả các lớp của công cụ này tự động triển khai giao diện này.

Jsonable (Laravel)

Giao diện hợp đồng của khung Laravel, sau khi triển khai đối tượng có thể gọi toJson() để xuất JSON. Kiểu tích hợp Laravel của công cụ này tự động triển khai giao diện này.

Arrayable (Laravel)

Giao diện hợp đồng của khung Laravel, sau khi triển khai đối tượng có thể gọi toArray() để xuất mảng. Kiểu tích hợp Laravel của công cụ này tự động triển khai giao diện này.

Composer

Công cụ quản lý phụ thuộc chính thức của PHP. Khi sử dụng mã được tạo bởi công cụ này, bạn cần cấu hình autoload PSR-4 trong composer.json (ví dụ: App\\: src/).

PSR-4

Chuẩn autoload do PHP-FIG ban hành, tải tệp lớp thông qua ánh xạ không gian tên-thư mục. Gói ZIP do công cụ này tạo được cấu trúc theo đường dẫn không gian tên, tuân thủ chuẩn PSR-4.

Symfony Serializer

Khung tuần tự hóa của thành phần Symfony. Các lớp được tạo theo kiểu ArrayObject của công cụ này có thể được sử dụng với PropertyNormalizer của Symfony Serializer để tuần tự hóa và giải tuần tự hóa sâu.

Eloquent API Resource

Lớp tài nguyên API của Laravel Eloquent, được sử dụng để định dạng phản hồi API. Lớp được tạo theo kiểu tích hợp Laravel của công cụ này có thể được sử dụng trực tiếp làm lớp cơ sở API Resource.

composer.json

Tệp cấu hình của dự án Composer. Sau khi đưa mã được tạo bởi công cụ này vào thư mục src, bạn cần cấu hình phần autoload trong composer.json và thực thi composer dump-autoload.

json_encode / json_decode

Hàm tuần tự hóa và giải tuần tự hóa JSON tích hợp sẵn của PHP. Sau khi lớp được tạo bởi công cụ này triển khai JsonSerializable, json_encode() sẽ tự động gọi phương thức jsonSerialize().

PHPUnit DataProvider

Cơ chế nhà cung cấp dữ liệu của khung kiểm thử PHPUnit. Lớp PHP được tạo bởi công cụ này có thể được đưa vào trường hợp kiểm thử thông qua DataProvider, nâng cao hiệu quả viết kiểm thử với tự động hoàn thành IDE.

PHPStan

Công cụ phân tích tĩnh PHP, có thể kiểm tra kiểu mã, phát hiện lỗi. Các lớp được tạo bởi công cụ này có typed properties, do đó có thể suy luận đầy đủ kiểu thuộc tính trong chế độ PHPStan --level=8.

Psalm

Một công cụ phân tích tĩnh PHP khác do Vimeo mở nguồn. Các lớp được tạo bởi công cụ này có thể thực hiện xác thực kiểu mạnh với PropertyTypeProvider của Psalm.

Doctrine

Bộ công cụ ORM và DBAL trong hệ sinh thái PHP. Lớp PHP được tạo bởi công cụ này có thể được sử dụng làm khung cho Doctrine Entity, sau đó thêm chú thích như #[ORM\Column] thủ công.

php -l

Lệnh kiểm tra cú pháp dòng lệnh PHP. Các lớp được tạo bởi công cụ này có thể trước tiên thực thi xác thực cú pháp với php -l User.php, sau đó yêu cầu vào dự án.

Composer dump-autoload

Lệnh Composer tạo lại chỉ mục autoload. Sau khi đưa lớp được tạo bởi công cụ này vào thư mục src, bạn cần thực thi composer dump-autoload để PSR-4 autoload nhận dạng.

JSON_THROW_ON_ERROR

Cờ xử lý lỗi json_decode() của PHP 7.3+, sau khi bật nó sẽ ném ngoại lệ JsonException khi phân tích cú pháp JSON thất bại. Ví dụ Laravel của công cụ này sử dụng phân tích cú pháp nghiêm ngặt.

Hash (PHP)

Hàm băm tích hợp sẵn của PHP, chủ yếu được sử dụng để xác thực WebHook. Lớp callback WebHook được tạo bởi công cụ này được sử dụng để xác thực chữ ký cùng với hash_hmac().

Bảng tham chiếu nhanh ánh xạ kiểu JSON sang kiểu PHP

Công cụ này tự động suy luận kiểu PHP tương ứng theo kiểu giá trị JSON; mối quan hệ ánh xạ phổ biến như sau:

Bảng so sánh 4 kiểu mã PHP

4 kiểu mã lớp PHP được công cụ hỗ trợ, lựa chọn theo yêu cầu dự án:

Privacy & Security

Tất cả các hoạt động phân tích cú pháp JSON, tạo lớp PHP, đóng gói ZIP của công cụ JSON to PHP này được hoàn thành cục bộ hoàn toàn trong trình duyệt của bạn bằng JavaScript (quicktype-core + JSZip); dữ liệu JSON đã nhập và mã PHP được tạo không được tải lên bất kỳ máy chủ nào, không được ghi lại, lưu vào bộ nhớ đệm hoặc lưu trữ trên đám mây. Bạn có thể yên tâm sử dụng ngay cả với JSON nhạy cảm chứa trường giao diện nội bộ, cấu trúc kinh doanh chưa phát hành, phản hồi API chưa công khai, tất cả dữ liệu sẽ bị xóa khi đóng trang. Công cụ này không sử dụng bất kỳ cookie nào để theo dõi người dùng, không thu thập email hoặc thông tin tài khoản, không chèn tập lệnh phân tích của bên thứ ba, tất cả các phép tính được hoàn thành trong quy trình trình duyệt của thiết bị hiện tại. Ngay cả trong môi trường ngoại tuyến (ví dụ: mạng bị ngắt kết nối hoặc môi trường cách ly mạng nội bộ), bạn vẫn có thể sử dụng bình thường sau khi tài nguyên trang được tải một lần.

Authoritative References

• PHP.netTài liệu chính thức PHP - Lớp và Đối tượng
• PHP.netTài liệu chính thức PHP - Giao diện JsonSerializable
• PHP.netTài liệu chính thức PHP - Bộ bổ nghĩa Readonly (PHP 8.1+)
• PHP.netTài liệu chính thức PHP - Typed Properties (PHP 7.4+)
• PHP-FIGChuẩn Autoload PSR-4
• LaravelTài liệu chính thức Laravel - Eloquent: API Resources
• SymfonyTài liệu thành phần Symfony Serializer
• ComposerTài liệu chính thức Composer - PSR-4 Autoload