[PHP] #15 PHP로 JSON 응답처리, 파싱부터 API 응답까지 완벽 정리!
안녕하세요, 토스트 데브입니다!
웹 개발에서 빠질 수 없는 데이터 형식, 바로 JSON입니다.
PHP에서도 JSON 데이터를 쉽게 주고받을 수 있으며, API 연동이나 프론트-백엔드 통신에서 필수적으로 사용됩니다.
✅ JSON이란?
JSON (JavaScript Object Notation)은 데이터를 구조화된 텍스트 형태로 표현하는 형식입니다.
HTML보다 가볍고, XML보다 간결하며, 거의 모든 언어에서 쉽게 파싱할 수 있어 API 통신에 가장 널리 사용됩니다.
✅ PHP에서 JSON 파싱 (디코딩) – json_decode()
예: JSON 문자열 → PHP 객체
$json = '{"name": "토스트", "email": "toast@example.com"}';
$data = json_decode($json);
echo $data->name; // 출력: 토스트예: JSON 문자열 → 연관 배열
$data = json_decode($json, true); // true = 배열 반환
echo $data["email"]; // 출력: toast@example.com
✅ PHP에서 JSON 생성 (인코딩) – json_encode()
$user = [
"name" => "toastdev",
"email" => "toast@example.com"
];
echo json_encode($user);📌 예시 결과
{"name":"toastdev","email":"toast@example.com"}
✅ JSON 인코딩 옵션
json_encode() 함수에는 다양한 옵션 플래그를 사용할 수 있습니다.
| 옵션 | 설명 |
| JSON_PRETTY_PRINT | 보기 좋게 들여쓰기된 출력 |
| JSON_UNESCAPED_UNICODE | 한글을 유니코드로 이스케이프하지 않음 |
| JSON_UNESCAPED_SLASHES | 슬래시(/)를 이스케이프하지 않음 |
| JSON_NUMERIC_CHECK | 문자열 숫자를 자동으로 숫자로 변환 |
예제
$data = ["이름" => "토스트", "사이트" => "https://toast.dev"];
echo json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
✅ JSON 응답을 활용한 간단한 PHP API 구현
1. API 응답용 PHP 파일 (예: user-api.php)
<?php
header('Content-Type: application/json; charset=utf-8');
$user = [
"name" => "토스트",
"email" => "toast@example.com",
"joined" => date("Y-m-d")
];
echo json_encode($user, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
?>📌 header('Content-Type: application/json')를 꼭 설정해야 브라우저와 클라이언트가 JSON임을 인식합니다.
✅ JSON 데이터 검증 (Validation)
입력으로 받은 JSON이 올바른지 확인할 수 있습니다.
$json = file_get_contents("php://input");
$data = json_decode($json, true);
if (json_last_error() !== JSON_ERROR_NONE) {
echo json_encode(["error" => "잘못된 JSON 형식입니다."]);
exit;
}📌 json_last_error()와 json_last_error_msg()를 사용하면 디버깅이 쉬워집니다.
✅ 보안 고려사항
1. ❗ XSS(크로스사이트 스크립팅)
JSON 출력 시 HTML과 결합하면 스크립트 삽입 공격에 노출될 수 있습니다.
htmlspecialchars() 또는 JSON 전용 Escape 처리를 적용하세요.
$safe = htmlspecialchars($data["comment"], ENT_QUOTES, "UTF-8");
2. ❗ CSRF 공격
JSON API에서도 CSRF 토큰을 검증하는 습관을 들이세요.
예: POST 요청 시 헤더 또는 본문에 토큰 포함 후 서버에서 검증.
3. ❗ 민감한 데이터 포함 금지
API 응답 시 비밀번호, 토큰, 내부 정보 등 민감한 데이터가 포함되지 않도록 주의하세요.
unset($user["password"]); // 반드시 제거
4. ❗ JSONP (callback) 사용 금지
옛날 방식인 JSONP는 CORS 보완이 아닌 보안 구멍이 될 수 있습니다.
JSONP는 반드시 피하고, CORS 정책을 설정하는 방식을 사용하세요.
✨ 마무리 요약
- ✅ json_decode()는 문자열 → PHP 객체/배열
- ✅ json_encode()는 PHP 배열/객체 → JSON 문자열
- ✅ JSON 응답 시 Content-Type 헤더는 필수
- ✅ json_last_error()로 에러를 확인하고 방어 코드를 작성
- ✅ 보안상 XSS, CSRF, 민감 정보 노출에 특히 주의!
REST API등 다양한 API 환경이 XML과 JSON 형식으로 이루어 지기 때문에 웹 배우시는 여러분들 께서는 XML과 JSON에 대해 꼭 자세히 이해하고 넘어가는 것이 좋습니다.
#PHPJSON #json_decode #json_encode #PHPAPI #JSON응답 #PHP보안 #XSS방지 #CSRF방지 #웹개발기초 #프로그래밍입문 #PHP기초 #toastdev #API보안 #JSON검증