JSON을 PHP로

관련 추천

JSON to PHP 클래스 및 PHP 엔티티 클래스 모델링에 대해

사용 사례

• Laravel 백엔드 개발: API 인터페이스 문서의 예시 JSON을 Eloquent Model / API Resource 클래스로 빠르게 변환하여 Laravel 내장 Jsonable / Arrayable 인터페이스와 함께 응답 직렬화
• Symfony Serializer 통합: 타사 API가 반환하는 JSON을 ArrayObject 스타일 PHP 클래스로 변환하여 Symfony Serializer로 심층 객체 매핑 및 데이터 검증
• WordPress REST API: 사용자 정의 endpoint가 반환하는 JSON 구조를 stdClass 스타일 PHP 클래스로 변환하여 wp_send_json()으로 직접 출력, wp_json_encode() 기본 동작과 일치
• PHP 8.1+ readonly DTO: JSON을 final readonly class로 변환하여 데이터 전송 객체(DTO)로 사용, 생성 후 불변으로 만들어 비즈니스 로직이 응답 데이터를 실수로 수정하는 것을 방지
• Composer 패키지 개발: JSON Schema를 PHP 클래스로 변환한 후 Packagist에 게시하여 SDK 모델 계층으로 사용, 다른 Composer 프로젝트에서 require하여 재사용
• 단위 테스트 픽스처: JSON 픽스처를 PHP 클래스로 변환한 후 json_decode + 역직렬화로 테스트 데이터 기반 테스트를 수행하고 구조화된 필드를 어설션
• 데이터 마이그레이션 스크립트: JSON 구성 파일을 PHP 클래스로 변환하여 비즈니스 로직에서 강한 타입 접근에 사용, 배열 접근보다 IDE 자동 완성과 타입 검사가 용이
• 프론트엔드 Mock 연동: 백엔드가 먼저 JSON 모델을 PHP 클래스로 변환하고 프론트엔드는 동시에 해당 TypeScript 인터페이스 / PHP 클래스를 받아 양쪽 타입 일관성 유지
• 코드 리뷰: API가 반환하는 JSON을 직접 읽기 쉬운 PHP 클래스로 변환하여 Code Review 시 필드 명명, 속성 가시성 논의 용이
• 레거시 프로젝트 리팩토링: array 연관 배열 동적 접근 기반 코드를 PHP 클래스 기반 강한 타입 접근으로 리팩토링하고 PHPStan / Psalm으로 정적 분석
• PHPUnit 데이터 제공자: JSON 테스트 데이터를 PHP 클래스로 변환한 후 DataProvider를 통해 테스트 케이스에 주입, IDE가 자동으로 속성 필드 제안
• snake_case 백엔드 API 연동: 백엔드 API가 snake_case 필드를 반환하면 프론트엔드 PHP 시스템에서 'camelCase로 변환' + ArrayObject 스타일을 활성화하여 원활하게 연동
• PHPStan 정적 분석: 생성된 클래스는 타입 선언이 기본으로 포함되어 있어 CI에서 phpstan analyse ./src --level=8로 타입 오류를 차단 가능
• 교육 및 훈련: PHP 교육 시나리오에서 예시 JSON을 PHP 클래스로 변환하여 객체 지향 모델링, 타입 시스템, 인터페이스 구현 시연
• API Gateway 게이트웨이 계층: 업스트림 마이크로서비스가 반환하는 JSON을 PHP 클래스로 변환하여 게이트웨이 계층에서 집계하고 다운스트림 PHP 서비스가 클래스 속성으로 강한 타입 소비
• 메시지 큐 소비: RabbitMQ / Kafka에서 소비한 JSON 메시지 본문을 PHP 클래스로 변환한 후 저장하거나 전달하고 JSON_THROW_ON_ERROR로 엄격한 파싱 수행
• 전자상거래 SKU / SPU 모델링: 상품 JSON 구조(다중 사양 / 다중 이미지 / 다중 속성)를 PHP 클래스로 변환하고 ArrayObject 스타일과 함께 Laravel에서 N+1 쿼리 최적화
• WebHook 콜백 검증: 결제 게이트웨이, 물류 콜백의 JSON 검증 구조를 PHP 클래스로 변환하고 hash_hmac()으로 서명 검증
• OpenAPI 도구 체인: OpenAPI 3.x의 schema JSON을 PHP 클래스로 변환하여 Swagger Codegen / Apifox의 PHP 클라이언트 생성 흐름에 연결
• 데이터 ETL 파이프라인: 업스트림 데이터 소스(MySQL JSON 필드 / MongoDB / Elasticsearch)의 JSON을 PHP 클래스로 변환한 후 데이터 정제 및 적재

이용 방법

1. 왼쪽 편집기에 JSON 객체(권장) 또는 배열을 붙여넣거나 'Sample'을 클릭하여 중첩된 address / company / tags가 포함된 중국어 예시를 로드
2. 도구 모음에서 'Settings' 버튼을 클릭하고 팝업에서 선택: ① 루트 클래스명(예: User)과 네임스페이스(예: App\Models) 설정; ② 코드 스타일 선택(ArrayObject / stdClass / readonly class); ③ 코드 스타일 선택(typed properties / Laravel 통합 / Symfony Serializer); ④ 필드 명명 전략 선택(원본 유지 / camelCase / 모두 소문자 / UPPER_SNAKE)
3. 도구가 400ms 이내에 자동으로 변환하며 오른쪽에 생성된 모든 PHP 클래스가 표시됨(각 클래스는 독립 카드이며 제목 표시줄에 현재 스타일 배지가 실시간으로 표시됨); JSON 형식 오류가 있으면 'JSON 복구' 버튼이 표시됨
4. 생성된 클래스명, 속성명, 인터페이스가 예상과 일치하는지 확인; 조정이 필요하면 원본 JSON의 키 이름을 수정하거나 Settings를 다시 열어 옵션 수정
5. 만족하면 개별 클래스의 '복사' 버튼을 클릭하여 IDE에 붙여넣거나 도구 모음에서 'Download ZIP'을 클릭하여 모든 클래스를 한 번에 다운로드(네임스페이스 경로별 디렉터리 구조로 구성)

주요 기능

• 두 가지 코드 스타일 자유롭게 전환: ArrayObject(\ArrayObject 상속, $obj['key'] 배열식 접근 지원) / stdClass(\stdClass 상속, $obj->key 객체식 접근 지원), Laravel 직렬화, WordPress REST, Symfony Serializer 등 다양한 시나리오에 호환
• 완전한 PHP 템플릿: 네임스페이스 선언 + use 구문 + 클래스 헤더 주석(Copyright + 생성 타임스탬프) + 클래스 정의 + typed public 속성(PHP 7.4+)을 자동 생성하여 수동으로 보일러플레이트를 작성할 필요 없이 Composer 프로젝트에 직접 require 가능
• JsonSerializable 인터페이스 자동 구현: 각 클래스는 public function jsonSerialize(): mixed { return [...] }를 자동 생성하여 json_encode()로 직접 JSON을 직렬화하며 추가 보일러플레이트 코드가 필요 없음
• PHP 8.1+ readonly class 선택 사항: 활성화하면 생성된 클래스에 final readonly class가 추가되고 모든 속성이 readonly가 되어 생성 후 불변이 되며 불변 API 응답 DTO 시나리오에 적합
• 스마트 타입 추론: string → string, integer → int, float → float, bool → bool, array → array, 중첩 객체 → 독립 클래스, null → ?type(널러블 속성), 수동 필드 타입 지정이 필요 없음
• 중첩 클래스 자동 분할: 중첩 객체는 필드명을 대문자로 시작하여 독립 PHP 클래스를 생성(예: address → Address), 배열 내 객체는 '끝 s 제거' 규칙으로 명명(예: users → User), 모든 중첩 클래스도 JsonSerializable을 구현
• 4가지 필드 명명 전략: 원본 유지 / snake_case를 camelCase로(user_name → userName) / 모두 소문자 / UPPER_SNAKE 상수 스타일, PSR-1 / Laravel / Symfony 코드 규범에 맞춤
• Laravel 원클릭 통합: 체크하면 Jsonable, Arrayable 인터페이스를 자동 구현하고 toArray() / toJson() 메서드를 추가하여 Composer 자동 로드와 함께 Eloquent API Resource로 직접 사용 가능
• 단일 클래스 복사 + ZIP 다중 파일 다운로드: 각 PHP 클래스마다 독립적인 '복사' 버튼이 있으며 네임스페이스 디렉터리 구조로 구성된 ZIP 패키지(예: App/Models/User.php)를 한 번의 클릭으로 다운로드하여 압축 해제 후 즉시 사용
• 브라우저 로컬 실행 + 기록: JSON 파싱, PHP 클래스 생성, ZIP 패키징 모두 브라우저 내에서 JavaScript(quicktype-core + JSZip)로 완료되며 데이터가 어떤 서버에도 업로드되지 않음; 최근 200개 입력에 대한 내장 localStorage 기록

코드 예제

<?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****@***********
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

자주 묻는 질문

문제 해결

용어집

namespace

PHP 5.3+에 도입된 네임스페이스 메커니즘으로 클래스명 충돌을 방지합니다. 이 도구는 사용자가 설정한 namespace에 따라 자동으로 생성하며 ZIP에서 App/Models/ 디렉터리로 구성합니다.

class

PHP에서 객체를 정의하는 템플릿입니다. 이 도구가 생성하는 것은 표준 PHP class이며 new User(...)로 직접 인스턴스화할 수 있습니다.

ArrayObject

PHP SPL 표준 라이브러리의 클래스로 ArrayAccess 등의 인터페이스를 구현합니다. 이 도구의 ArrayObject 스타일로 생성된 클래스는 \ArrayObject를 상속하여 배열식과 객체식 이중 접근을 지원합니다.

stdClass

PHP 내장 일반 객체 클래스로 json_decode($json, false)가 기본적으로 이 타입을 반환합니다. 이 도구의 stdClass 스타일로 생성된 클래스는 \stdClass를 상속하여 객체식 접근만 지원합니다.

typed properties

PHP 7.4+에 도입된 속성 타입 선언(예: public int $id)입니다. 이 도구가 생성하는 속성은 기본적으로 타입 선언이 포함되어 있어 IDE와 정적 분석 도구가 직접 타입 검사를 할 수 있습니다.

readonly class

PHP 8.1+에 도입된 읽기 전용 클래스로 클래스 내 모든 속성이 자동으로 readonly가 되어 생성 후 수정할 수 없습니다. 이 도구의 readonly 스타일은 final readonly class를 생성하여 불변 DTO 시나리오에 적합합니다.

JsonSerializable

PHP 5.4+에 도입된 인터페이스로 이 인터페이스를 구현한 객체는 json_encode()로 처리될 때 자동으로 jsonSerialize() 메서드를 호출합니다. 이 도구의 모든 클래스는 이 인터페이스를 자동으로 구현합니다.

Jsonable (Laravel)

Laravel 프레임워크의 계약 인터페이스로 구현 후 객체가 toJson()을 호출하여 JSON을 출력할 수 있습니다. 이 도구의 Laravel 통합 스타일은 이 인터페이스를 자동으로 구현합니다.

Arrayable (Laravel)

Laravel 프레임워크의 계약 인터페이스로 구현 후 객체가 toArray()를 호출하여 배열을 출력할 수 있습니다. 이 도구의 Laravel 통합 스타일은 이 인터페이스를 자동으로 구현합니다.

Composer

PHP 공식 의존성 관리 도구입니다. 이 도구로 생성된 코드를 사용할 때 composer.json에서 PSR-4 자동 로드를 구성해야 합니다(예: App\\: src/).

PSR-4

PHP-FIG에서 제정한 자동 로드 규범으로 네임스페이스-디렉터리 매핑으로 클래스 파일을 로드합니다. 이 도구가 생성한 ZIP 패키지는 네임스페이스 경로별로 구성되어 PSR-4 규범을 준수합니다.

Symfony Serializer

Symfony 구성요소의 직렬화 프레임워크입니다. 이 도구의 ArrayObject 스타일로 생성된 클래스는 Symfony Serializer의 PropertyNormalizer와 함께 심층 직렬화 및 역직렬화에 사용할 수 있습니다.

Eloquent API Resource

Laravel Eloquent의 API 리소스 클래스로 API 응답을 형식화하는 데 사용됩니다. 이 도구의 Laravel 통합 스타일로 생성된 클래스는 API Resource 기본 클래스로 직접 사용할 수 있습니다.

composer.json

Composer 프로젝트의 구성 파일입니다. 이 도구로 생성된 코드를 src 디렉터리에 넣은 후 composer.json의 autoload 섹션을 구성하고 composer dump-autoload를 실행해야 합니다.

json_encode / json_decode

PHP 내장 JSON 직렬화 및 역직렬화 함수입니다. 이 도구로 생성된 클래스가 JsonSerializable을 구현한 후 json_encode()는 자동으로 jsonSerialize() 메서드를 호출합니다.

PHPUnit DataProvider

PHPUnit 테스트 프레임워크의 데이터 제공자 메커니즘입니다. 이 도구로 생성된 PHP 클래스는 DataProvider로 테스트 케이스에 주입될 수 있어 IDE 자동 완성과 함께 테스트 작성 효율이 향상됩니다.

PHPStan

PHP 정적 분석 도구로 코드의 타입 검사, 오류 탐지를 할 수 있습니다. 이 도구로 생성된 클래스는 typed properties가 있으므로 PHPStan --level=8 모드에서 속성 타입을 완전히 추론할 수 있습니다.

Psalm

Vimeo에서 오픈소스한 또 다른 PHP 정적 분석 도구입니다. 이 도구로 생성된 클래스는 Psalm의 PropertyTypeProvider와 함께 강한 타입 검증을 할 수 있습니다.

Doctrine

PHP 생태계의 ORM 및 DBAL 도구 모음입니다. 이 도구로 생성된 PHP 클래스는 Doctrine Entity의 골격으로 사용한 후 #[ORM\Column] 등의 어노테이션을 수동으로 추가할 수 있습니다.

php -l

PHP 명령줄 구문 검사 명령입니다. 이 도구로 생성된 클래스는 먼저 php -l User.php로 구문 검증을 실행한 후 프로젝트에 require할 수 있습니다.

Composer dump-autoload

Composer가 자동 로드 인덱스를 재생성하는 명령입니다. 이 도구로 생성된 클래스를 src 디렉터리에 넣은 후 composer dump-autoload를 실행해야 PSR-4 자동 로드가 인식합니다.

JSON_THROW_ON_ERROR

PHP 7.3+의 json_decode() 오류 처리 플래그로 활성화하면 JSON 파싱 실패 시 JsonException 예외를 던집니다. 이 도구의 Laravel 예제에서는 엄격한 파싱을 사용합니다.

Hash (PHP)

PHP 내장 해시 함수로 주로 WebHook 검증에 사용됩니다. 이 도구로 생성된 WebHook 콜백 클래스는 hash_hmac()와 함께 서명 검증에 사용됩니다.

JSON 타입에서 PHP 타입으로 매핑 빠른 참조표

이 도구는 JSON 값의 타입에 따라 해당하는 PHP 타입을 자동으로 추론합니다; 일반적인 매핑 관계는 다음과 같습니다:

PHP 4가지 코드 스타일 비교표

도구가 지원하는 4가지 PHP 클래스 코드 스타일, 프로젝트 요구에 따라 선택:

Privacy & Security

이 JSON to PHP 도구의 모든 JSON 파싱, PHP 클래스 생성, ZIP 패키징 작업은 완전히 귀하의 브라우저에서 JavaScript(quicktype-core + JSZip)로 로컬에서 완료됩니다; 입력된 JSON 데이터와 생성된 PHP 코드는 어떤 서버에도 업로드되지 않으며 클라우드에 기록, 캐시 또는 저장되지 않습니다. 내부 인터페이스 필드, 출시되지 않은 비즈니스 구조, 공개되지 않은 API 응답이 포함된 민감한 JSON도 안심하고 사용할 수 있으며 페이지를 닫으면 모든 데이터가 삭제됩니다. 이 도구는 사용자 추적을 위해 어떤 쿠키도 사용하지 않고 이메일이나 계정 정보를 수집하지 않으며 제3자 분석 스크립트를 삽입하지 않고 모든 계산이 현재 기기의 브라우저 프로세스에서 완료됩니다. 오프라인 환경(예: 네트워크가 끊겨 있거나 인트라넷 격리 환경)에서도 페이지 리소스가 한 번 로드된 후에는 정상적으로 사용할 수 있습니다.

Authoritative References

• PHP.netPHP 공식 문서 - 클래스와 객체
• PHP.netPHP 공식 문서 - JsonSerializable 인터페이스
• PHP.netPHP 공식 문서 - Readonly 수식어(PHP 8.1+)
• PHP.netPHP 공식 문서 - Typed Properties(PHP 7.4+)
• PHP-FIGPSR-4 자동 로드 규범
• LaravelLaravel 공식 문서 - Eloquent: API Resources
• SymfonySymfony Serializer 구성요소 문서
• ComposerComposer 공식 문서 - PSR-4 자동 로드