Django form은 어떻게 동작하나요?

Question

Accepted Answer

Django **form**은 사용자 입력의 전체 수명주기를 처리합니다: HTML form 필드 렌더링, 제출된 데이터 **검증**, 깔끔한 Python 값으로 변환. form은 수동 입력 처리와 검증의 지루하고 오류 잦은 작업을 추상화합니다. 주요 생산성 및 보안 기능입니다. ## 기본 form ```python from django import forms class ContactForm(forms.Form): name = forms.CharField(max_length=100) email = forms.EmailField() # 이메일 형식 검증 age = forms.IntegerField(min_value=0, required=False) message = forms.CharField(widget=forms.Textarea) ``` 각 form 필드는 타입과 검증 규칙을 선언합니다. form은 자신을 HTML로 렌더링하고 그 규칙에 따라 입력을 검증할 수 있습니다. ## view에서 form 처리하기(표준 패턴) ```python def contact(request): if request.method == "POST": form = ContactForm(request.POST) # 제출된 데이터 바인딩 if form.is_valid(): # 검증 실행 # cleaned_data = 검증되고 타입 변환된 Python 값 name = form.cleaned_data["name"] send_email(form.cleaned_data) return redirect("success") else: form = ContactForm() # GET에는 빈 form return render(request, "contact.html", {"form": form}) ``` 핵심 메서드: `is_valid()`는 검증을 실행하고, 성공 시 `cleaned_data`는 안전하고 검증되고 타입 변환된 값을 제공합니다. 실패 시 form은 입력을 유지하고 오류 메시지를 수집합니다. ## ModelForm — model로부터의 form(DRY) ```python from django.forms import ModelForm class ArticleForm(ModelForm): class Meta: model = Article # model에서 form 구축 fields = ["title", "body", "published"] # 포함할 필드 # ModelForm은 데이터베이스에 직접 저장 가능 def create(request): form = ArticleForm(request.POST) if form.is_valid(): form.save() # model 인스턴스를 생성/업데이트! ``` **ModelForm**은 model의 필드에서 form을 자동 생성하며 데이터베이스에 직접 저장할 수 있습니다. DRY를 구현(model이 form을 구동)하여 CRUD form의 보일러플레이트를 제거합니다. ## 커스텀 검증 ```python class SignupForm(forms.Form): password = forms.CharField() confirm = forms.CharField() def clean_password(self): # 필드 수준 검증 pw = self.cleaned_data["password"] if len(pw) < 8: raise forms.ValidationError("Too short") return pw def clean(self): # form 수준(필드 간) 검증 data = super().clean() if data.get("password") != data.get("confirm"): raise forms.ValidationError("Passwords don't match") ``` ## 렌더링과 보안 ```html ``` form은 Django의 **CSRF 방어**(`{% csrf_token %}`)와 통합되며 검증 오류와 함께 필드를 자동 렌더링합니다. ## 왜 중요한가 Django form은 사용자 입력을 안전하고 생산적으로 처리하기 위한 핵심 기능입니다. 입력을 올바르게 처리하는 것은 어디에나 있고(거의 모든 앱에 form이 있음) 보안에 중요합니다. form을 이해하는 것이 필수적인 이유는 form이 입력 처리의 지루하고 오류 잦은 작업을 추상화하기 때문입니다: HTML 필드 렌더링, 규칙에 따른 데이터 **검증**, 깔끔한 타입 지정 Python 값으로의 변환(`cleaned_data`), 실패 시 입력 보존과 오류 표시, 공격으로부터의 보호. 검증 측면은 **보안과 견고성**에 특히 중요합니다. form은 원시 사용자 입력을 절대 신뢰하지 않도록 보장하여, 잘못되거나 악의적인 데이터가 비즈니스 로직에 도달하기 전에 잡아냅니다. **ModelForm**은 model에서 직접 form을 생성하고 최소한의 코드로 데이터베이스에 저장하여 DRY를 구현하는 주요 생산성 이점입니다. 매우 흔한 CRUD form 경우의 보일러플레이트를 제거합니다. 표준 view 패턴(`is_valid()` + `cleaned_data`), 커스텀 필드 수준 및 필드 간 검증을 추가하는 방법, model 기반 form을 위한 ModelForm, 그리고 **CSRF 방어**와의 통합을 아는 것은 사용자 입력을 받는 모든 Django 애플리케이션을 구축하는 데 기초적입니다. form은 입력 처리, 검증, 보안, model 계층을 함께 묶으므로, 프레임워크의 중요하고 자주 사용되는 부분이자 Django가 데이터 입력 중심 애플리케이션에 그토록 생산적인 핵심 이유입니다.