Forms

Django Form

1. 폼(Form)이란?

사용자 입력 데이터를 수집하고 검증하는 도구

•

Django의 forms 모듈을 사용

•

HTML <form> 태그를 쉽게 처리할 수 있도록 도와줌

Django Form의 주요 기능

다음은 Django Form의 주요 기능을 표로 정리한 것입니다:

기능	설명
데이터 검증	사용자가 입력한 데이터의 유효성을 자동으로 검사
HTML 생성	폼 필드에 대한 HTML 코드를 자동으로 생성
데이터 변환	POST 데이터를 파이썬 데이터 타입으로 변환
보안 기능	CSRF 보호와 같은 보안 기능 제공
에러 처리	폼 검증 실패 시 에러 메시지 관리
초기값 설정	폼 필드의 초기값을 쉽게 설정 가능

2. 폼의 종류

종류	설명	클래스
일반 폼	사용자 정의 입력 필드	forms.Form
모델 폼	모델 기반 자동 생성	forms.ModelForm

3. 일반 Form 예제

# forms.py
from django import forms

class ContactForm(forms.Form):
    name = forms.CharField(max_length=100)
    email = forms.EmailField()
    message = forms.CharField(widget=forms.Textarea)
Python
복사

# views.py
from .forms import ContactForm

def contact_view(request):
    if request.method == 'POST':
        form = ContactForm(request.POST)
        if form.is_valid():
            # 처리 로직
            return redirect('success')
    else:
        form = ContactForm()
    return render(request, 'contact.html', {'form': form})
Python
복사

4. ModelForm 예제

# models.py
class Post(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
Python
복사

# forms.py
from .models import Post
from django import forms

class PostForm(forms.ModelForm):
    class Meta:
        model = Post
        fields = ['title', 'content']
Python
복사

# views.py
def create_post(request):
    if request.method == 'POST':
        form = PostForm(request.POST)
        if form.is_valid():
            form.save()
            return redirect('post_list')
    else:
        form = PostForm()
    return render(request, 'post_form.html', {'form': form})
Python
복사

5. 템플릿에서 폼 렌더링

<!-- post_form.html -->
<form method="post">
  {% csrf_token %}
  {{ form.as_p }}
  <button type="submit">등록</button>
</form>
HTML
복사

폼 렌더링 방식

메소드	설명	출력 형태
as_p()	각 필드를 <p> 태그로 감싸서 출력	단락 형태로 구분되어 표시
as_table()	각 필드를 <tr> 태그로 감싸서 출력	테이블 행 형태로 표시
as_ul()	각 필드를 <li> 태그로 감싸서 출력	목록 아이템 형태로 표시

Tip: 가장 일반적으로 사용되는 방식은 as_p()입니다.

6. 유효성 검사 & 커스텀 유효성

기본 유효성 검사

Django Form은 기본적으로 필드 타입에 따른 유효성 검사를 수행합니다.

# forms.py
from django import forms
from django.core.validators import RegexValidator

class UserForm(forms.Form):
    username = forms.CharField(
        validators=[
            RegexValidator(
                regex='^[a-zA-Z]{6,}$',
                message='아이디는 영문 6자리 이상이어야 합니다.',
                code='invalid_username'
            )
        ]
    )
    password = forms.CharField(
        widget=forms.PasswordInput,
        validators=[
            RegexValidator(
                regex='^(?=.*[!@#$%^&*])[A-Za-z\d!@#$%^&*]{8,}$',
                message='비밀번호는 8자리 이상이며, 특수문자를 1개 이상 포함해야 합니다.',
                code='invalid_password'
            )
        ]
    )
Python
복사

커스텀 유효성 검사

clean_ 메소드를 오버라이드하여 사용자 정의 유효성 검사를 추가할 수 있습니다:

from django import forms
from django.contrib.auth.models import User
from django.core.exceptions import ValidationError
import re

class UserForm(forms.Form):
    username = forms.CharField()
    password = forms.CharField(widget=forms.PasswordInput)

    def clean_username(self):
        username = self.cleaned_data['username']
        if not re.match(r'^[a-zA-Z]{6,}$', username):
            raise ValidationError('아이디는 영문 6자리 이상이어야 합니다.', code='invalid_username')
        if User.objects.filter(username=username).exists():
            raise ValidationError('이미 존재하는 아이디입니다.')
        return username

    def clean_password(self):
        password = self.cleaned_data['password']
        if not re.match(r'^(?=.*[!@#$%^&*])[A-Za-z\d!@#$%^&*]{8,}$', password):
            raise ValidationError('비밀번호는 8자리 이상이며, 특수문자를 1개 이상 포함해야 합니다.', code='invalid_password')
        return password
Python
복사

Tip: clean_() 메소드는 해당 필드의 유효성 검사가 완료된 후 호출됩니다.

유효성 검사 결과는 form.errors를 통해 확인할 수 있습니다.

7. 실습 과제 예시

실습 주제	설명
연락처 폼 만들기	이름, 이메일, 메시지 입력 후 DB 저장 또는 콘솔 출력
게시글 작성 폼	Post 모델 기반의 ModelForm 만들기
로그인 폼	사용자 입력 유효성 검사 포함

보너스: 위젯 & 스타일 적용

class StyledForm(forms.Form):
    name = forms.CharField(widget=forms.TextInput(attrs={'class': 'form-control'}))
Python
복사

 Bootstrap과 함께 쓰면 훌륭한 디자인 구현 가능

요약

기능	설명
forms.Form	일반 폼 클래스, 수동으로 필드를 정의할 때 사용
forms.ModelForm	모델과 연동된 폼 클래스, 모델 필드 기반 자동 생성
form.is_valid()	폼 데이터의 유효성 검사 수행
form.cleaned_data	유효성 검사 후 정제된 데이터에 접근
form.save()	ModelForm에서 검증된 데이터를 DB에 저장

Django 회원가입 기능 구현 예제

1. 기본 개요

•

Django의 기본 User 모델 (django.contrib.auth.models.User) 사용

•

forms.ModelForm으로 회원가입 폼 생성

•

비밀번호는 해시처리 되어 저장됨 (set_password() 사용)

2. 폼 만들기 (forms.py)

# accounts/forms.py
from django import forms
from django.contrib.auth.models import User
from django.contrib.auth.forms import UserCreationForm

class SignupForm(UserCreationForm):  # UserCreationForm은 기본 유효성 검사 포함
    email = forms.EmailField(required=True)

    class Meta:
        model = User
        fields = ('username', 'email', 'password1', 'password2')
Python
복사

password1, password2: 자동 비밀번호 확인 처리 포함

UserCreationForm을 상속하면 비밀번호 해싱과 유효성 검사 자동 처리됨

3. 뷰 함수 만들기 (views.py)

# accounts/views.py
from django.shortcuts import render, redirect
from .forms import SignupForm
from django.contrib import messages

def signup_view(request):
    if request.method == 'POST':
        form = SignupForm(request.POST)
        if form.is_valid():
            form.save()
            messages.success(request, '회원가입이 완료되었습니다!')
            return redirect('login')  # 로그인 페이지로 이동
    else:
        form = SignupForm()
    return render(request, 'accounts/signup.html', {'form': form})
Python
복사

4. URL 설정 (urls.py)

# accounts/urls.py
from django.urls import path
from .views import signup_view

urlpatterns = [
    path('signup/', signup_view, name='signup'),
]
Python
복사

# 프로젝트 urls.py에 앱 URL 연결
# mysite/urls.py
from django.urls import path, include

urlpatterns = [
    path('accounts/', include('accounts.urls')),  # http://localhost:8000/accounts/signup/
]
Python
복사

5. 템플릿 작성 (signup.html)

<!-- templates/accounts/signup.html -->
<h2>회원가입</h2>
<form method="post">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">가입하기</button>
</form>
HTML
복사

6. 작동 흐름 요약

사용자가 /accounts/signup/ 페이지로 이동

가입 폼에 입력 후 제출

Django가 유효성 검사 후 User 객체 생성 (form.save())

성공 시 로그인 페이지로 리디렉션

확장 팁

기능	방법
로그인 후 자동 로그인	login(request, user) 사용
중복 이메일 검증	clean_email() 메서드 오버라이드
추가 필드 (예: 생년월일)	Custom User 모델 사용 또는 UserProfile 연결

실습 아이디어

•

이메일 중복 체크 추가

•

가입 후 환영 이메일 발송

•

가입 성공 시 자동 로그인

•

가입 시 약관 동의 체크박스 추가