Django 모델에서 전화번호를 저장하는 가장 좋은 방법

2024-07-27

Django 모델에서 전화번호를 저장하는 가장 좋은 방법

문자열 필드 사용:

가장 간단한 방법은 전화번호를 문자열 필드로 저장하는 것입니다. 다음과 같이 모델을 정의할 수 있습니다.

from django.db import models

class Person(models.Model):
    name = models.CharField(max_length=255)
    phone_number = models.CharField(max_length=20)

이 방법은 간단하지만 국제 전화번호 형식 처리와 같은 고급 기능을 제공하지 않습니다.

phonenumber 라이브러리 사용:

phonenumber 라이브러리를 사용하면 국제 전화번호를 처리하고 유효성을 검사하는 데 도움이 되는 추가 기능을 얻을 수 있습니다. 다음과 같이 모델을 정의할 수 있습니다.

from django.db import models
import phonenumbers

class Person(models.Model):
    name = models.CharField(max_length=255)
    phone_number = phonenumbers.PhoneNumberField()

이 방법을 사용하면 다음과 같은 작업을 수행할 수 있습니다.

유효한 전화번호인지 확인합니다.
국가 코드를 포함하여 전화번호를 정규화합니다.
전화번호를 다양한 형식으로 표시합니다.

어떤 방법을 사용해야 할까요?

사용해야 할 방법은 특정 요구 사항에 따라 다릅니다. 간단한 방법으로 국제 전화번호 처리 기능이 필요하지 않은 경우 문자열 필드를 사용하는 것이 좋습니다. 국제 전화번호를 처리하고 유효성을 검사해야 하는 경우 phonenumber 라이브러리를 사용하는 것이 좋습니다.

참고:

추가 정보

예제 코드

예제 1: 문자열 필드 사용

from django.db import models

class Person(models.Model):
    name = models.CharField(max_length=255)
    phone_number = models.CharField(max_length=20)

이 코드는 다음과 같은 테이블을 생성합니다.

CREATE TABLE myapp_person (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name VARCHAR(255) NOT NULL,
    phone_number VARCHAR(20) NOT NULL
);

다음 코드를 사용하여 데이터를 추가할 수 있습니다.

person = Person(name="John Doe", phone_number="123-456-7890")
person.save()

person = Person.objects.get(id=1)
print(person.name, person.phone_number)

from django.db import models
import phonenumbers

class Person(models.Model):
    name = models.CharField(max_length=255)
    phone_number = phonenumbers.PhoneNumberField()

CREATE TABLE myapp_person (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name VARCHAR(255) NOT NULL,
    phone_number VARCHAR(255) NOT NULL
);

from phonenumbers import parse

phone_number = parse("+1234567890")
person = Person(name="John Doe", phone_number=phone_number)
person.save()

person = Person.objects.get(id=1)
print(person.name)
print(person.phone_number.country_code)
print(person.phone_number.national_number)

Django 모델에서 전화번호를 저장하는 대체 방법

phonenumber 라이브러리가 제공하는 기능보다 더 많은 기능이 필요한 경우 커스텀 필드를 만들 수 있습니다. 다음은 phonenumber 라이브러리의 기능을 확장하는 간단한 예제입니다.

from django.db import models
from phonenumbers import PhoneNumber, NumberFormat

class MyPhoneNumberField(models.CharField):
    max_length = 255

    def to_python(self, value):
        if isinstance(value, PhoneNumber):
            return value.number
        return super().to_python(value)

    def get_db_prep_value(self, value, connection):
        if isinstance(value, PhoneNumber):
            return value.as_E164()
        return super().get_db_prep_value(value, connection)

class Person(models.Model):
    name = models.CharField(max_length=255)
    phone_number = MyPhoneNumberField()

CREATE TABLE myapp_person (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name VARCHAR(255) NOT NULL,
    phone_number VARCHAR(255) NOT NULL
);

from phonenumbers import parse

phone_number = parse("+1234567890")
person = Person(name="John Doe", phone_number=phone_number)
person.save()

person = Person.objects.get(id=1)
print(person.name)
print(person.phone_number)  # +1234567890

이 코드는 phonenumber 라이브러리의 기능을 사용하여 전화번호를 국제 표준 형식으로 변환합니다. 또한 데이터베이스에 저장되기 전에 전화번호를 E.164 형식으로 변환하고 검색 후 다시 원래 형식으로 변환합니다.

별도의 테이블 사용:

전화번호를 별도의 테이블에 저장하는 것이 필요한 경우 이 방법을 사용할 수 있습니다. 다음은 간단한 예제입니다.

from django.db import models

class PhoneNumber(models.Model):
    number = phonenumbers.PhoneNumberField()

class Person(models.Model):
    name = models.CharField(max_length=255)
    phone_number = models.ForeignKey(PhoneNumber, on_delete=models.CASCADE)

CREATE TABLE auth_user (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    username VARCHAR(150) UNIQUE NOT NULL,
    first_name VARCHAR(30) NOT NULL,
    last_name VARCHAR(30) NOT NULL,
    email VARCHAR(254) NOT NULL,
    password VARCHAR(128) NOT NULL,
    is_superuser BOOLEAN NOT NULL DEFAULT FALSE,
    is_staff BOOLEAN NOT NULL DEFAULT FALSE,
    is_active BOOLEAN NOT NULL DEFAULT TRUE,
    date_joined TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    last_login TIMESTAMP NULL,
);

CREATE TABLE myapp_phonenumber (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    number VARCHAR(255) NOT NULL
);

CREATE TABLE myapp_person (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name VARCHAR(255) NOT NULL,
    phone_number_id INTEGER NOT NULL,
    FOREIGN KEY (phone_number_id) REFERENCES myapp_phonenumber(id)
);

from phonenumbers import parse

phone_number = parse("+1234567890")
phone_number_obj = PhoneNumber(number=phone_number)
phone_number_obj.save()

person = Person(name="John Doe", phone_number=phone_number_obj)
person.save()