폼 요청(Form Request) 클래스란 무엇인가요?

Question

Accepted Answer

**폼 요청(Form Request)** 클래스는 특정 요청에 대한 **검증(및 권한 부여) 로직을 캡슐화하는** 커스텀 요청 클래스입니다. 검증 규칙을 컨트롤러에서 전용 재사용 가능 클래스로 옮겨 — 컨트롤러를 가볍게 유지하고 검증을 체계화합니다.

## 폼 요청 생성과 사용

```php
<?php
// php artisan make:request StoreUserRequest
class StoreUserRequest extends FormRequest {
    public function authorize(): bool {
        return $this->user()->can('create', User::class);   // 권한 부여 확인
    }

public function rules(): array {
        return [                                              // 검증 규칙
            'name' => 'required|string|max:100',
            'email' => 'required|email|unique:users',
            'password' => 'required|min:8|confirmed',
        ];
    }

public function messages(): array {
        return ['email.unique' => 'That email is already taken.'];   // 커스텀 메시지
    }
}
```

```php
// 컨트롤러에서 폼 요청을 타입 힌트 — 검증이 자동으로 실행됨
public function store(StoreUserRequest $request) {
    // 여기에 도달했다면 검증과 권한 부여가 이미 통과한 것
    User::create($request->validated());   // 검증된 데이터 가져오기
}
```

컨트롤러 메서드에서 폼 요청을 타입 힌트하면, Laravel은 **메서드 실행 전에 자동으로 권한 부여와 검증을 실행**합니다 — 둘 중 하나라도 실패하면 요청이 거부되고(권한 부여는 403, 검증은 422/리다이렉트) 메서드는 실행되지 않습니다. 따라서 메서드 내부에서는 데이터가 유효하고 동작이 권한이 부여된 것임을 알 수 있습니다.

## 이점

```text
✓ 가벼운 컨트롤러 — 검증/권한 부여 로직이 컨트롤러가 아닌 폼 요청에 존재
✓ 재사용 가능 — 여러 엔드포인트에서 동일한 요청 클래스 사용
✓ 체계적 — 요청에 대한 규칙, 메시지, 권한 부여가 한 곳에
✓ 검증과 권한 부여 결합 — 컨트롤러 전에 둘 다 자동으로 확인됨
✓ $request->validated()로 준비된/검증된 데이터에 깔끔하게 접근
```

## 왜 중요한가

폼 요청 클래스는 검증과 권한 부여를 깔끔하게 정리하는 중요한 Laravel 모범 사례입니다 — 사소한 검증을 넘어선 모든 것에 권장되는 접근법이므로, 이를 이해하는 것은 유지보수 가능한 Laravel 애플리케이션을 작성하는 데 가치가 있습니다.

그 핵심 이점은 **컨트롤러를 가볍게** 유지하는 것입니다: 검증 규칙과 권한 부여 로직을 (Laravel이 컨트롤러 메서드 전에 자동으로 실행하는) 전용 클래스로 옮김으로써, 컨트롤러는 핵심 로직에 집중하며 실행 시 데이터가 이미 검증되고 동작이 권한이 부여되었다는 보장을 받습니다.

이 분리는 코드를 더 **체계적**(요청에 대한 모든 규칙, 커스텀 메시지, 권한 부여가 응집력 있는 한 곳에)이고 **재사용 가능**(동일한 폼 요청을 여러 엔드포인트에서 사용 가능)하며 깔끔하게 만듭니다.

**검증과 권한 부여**를 한 클래스에서 자동으로 결합하는 것 — 컨트롤러 실행 전에 둘 다 확인되어 유효하지 않거나 권한이 없는 요청을 자동으로 거부 — 은 우아하며 보일러플레이트를 줄입니다.

폼 요청, 그것이 어떻게 자동으로 실행되는지, 그리고 검증/권한 부여를 컨트롤러에서 추출하는 이점을 이해하는 것은 성숙한 Laravel 관행을 반영하며 잘 구조화된 애플리케이션을 구축하는 데 중요합니다. 검증과 권한 부여는 어디에나 있는 관심사이고 폼 요청은 사소하지 않은 경우에 이를 처리하는 Laravel의 깔끔하고 관용적인 방법이기 때문입니다 — 전문적이고 유지보수 가능한 Laravel 코드의 특징입니다.