요청과 응답은 어떻게 다루나요?

Question

요청과 응답은 어떻게 다루나요?

Accepted Answer

Laravel은 HTTP를 편리한 **Request**와 **Response** 객체로 감쌉니다. `Request` 객체는 들어오는 데이터(입력, 파일, 헤더)에 안전하고 깔끔하게 접근하게 해주고, Laravel의 응답 헬퍼는 뷰, JSON, 리다이렉트 등을 반환하는 것을 간단하게 만듭니다.

## 요청 데이터 접근

```php
public function store(Request $request) {
    $request->input('name');             // 특정 입력 필드
    $request->name;                       // 단축 접근
    $request->only(['name', 'email']);    // 일부
    $request->all();                      // 모든 입력
    $request->query('sort');              // 쿼리 스트링 파라미터 (?sort=)
    $request->has('email');               // 존재 확인
    $request->input('page', 1);           // 기본값과 함께

$request->file('avatar');             // 업로드된 파일
    $request->header('Authorization');
    $request->user();                     // 인증된 사용자
    $request->ip(); $request->method();   // 요청 메타데이터
}
```

`Request` 객체(컨트롤러 메서드에 자동 주입됨)는 모든 들어오는 데이터에 깔끔하고 안전하게 접근하게 해줍니다 — 일반적인 요구를 위한 헬퍼 메서드와 함께, 원시 `$_GET`/`$_POST` 슈퍼글로벌보다 훨씬 낫습니다.

## 응답 반환

```php
return view('users.index', ['users' => $users]);   // Blade 뷰 렌더링
return response()->json($data, 200);                // JSON (배열/모델도 자동)
return $user;                                       // 모델 → JSON으로 자동 직렬화
return redirect('/home');                            // 리다이렉트
return redirect()->route('profile')->with('msg', 'Saved!');   // 리다이렉트 + 플래시 메시지
return back();                                       // 이전 페이지로 리다이렉트
return response()->download($path);                  // 파일 다운로드
```

Laravel의 응답 헬퍼는 일반적인 경우들을 우아하게 처리합니다: 뷰 렌더링, JSON 반환(배열과 Eloquent 모델은 JSON으로 자동 직렬화됨), 리다이렉트(플래시 메시지와 함께), 다운로드. 컨트롤러에서 모델이나 배열을 반환하면 자동으로 JSON 응답이 생성됩니다.

## 응답 커스터마이징

```php
return response()->json(['error' => 'Not found'], 404)
    ->header('X-Custom', 'value');                   // 커스텀 상태 + 헤더
return response('Hello', 200)->header('Content-Type', 'text/plain');
```

## 왜 중요한가

요청과 응답을 다루는 것은 모든 Laravel 애플리케이션의 근본입니다 — 들어오는 데이터를 처리하고 출력을 반환하는 것이 요청 처리의 핵심이므로, 이 객체들을 이해하는 것은 필수적인 일상 지식입니다.

**Request 객체**는 유용한 메서드를 통해 모든 들어오는 데이터(입력, 쿼리 파라미터, 파일, 헤더, 인증된 사용자)에 깔끔하고 안전하며 편리하게 접근하게 해줍니다 — 원시 PHP 슈퍼글로벌(`$_GET`/`$_POST`)보다 인체공학적으로나 안전한 처리를 장려하는 면에서나 크게 개선된 것입니다.

Laravel의 **응답 헬퍼**는 모든 일반적인 응답 유형을 반환하는 것을 우아하게 만듭니다: Blade 뷰 렌더링, JSON 반환(배열과 Eloquent 모델이 자동 직렬화됨 — API에 편리), 리다이렉트(사용자 피드백을 위한 플래시 메시지와 함께), 파일 다운로드, 그리고 특정 상태 코드와 헤더가 있는 커스텀 응답.

Request 객체의 메서드를 통해 요청 데이터에 접근하는 방법과 적절한 응답 유형(웹 페이지용 뷰, API용 JSON, 동작 후 리다이렉트)을 반환하는 방법을 이해하는 것은 모든 Laravel 엔드포인트를 구축하는 데 핵심적이고 반드시 알아야 할 지식입니다. 모든 컨트롤러 메서드는 요청을 받고 응답을 반환하기 때문입니다.

Laravel의 요청/응답 추상화의 편리함과 안전성은 프레임워크를 생산적으로 만드는 요소의 일부이며, 그것에 능숙해지는 것은 효과적인 Laravel 개발의 근본입니다.