django-core setting(6)

hwisaac·2023년 8월 31일

djnago-setting

목록 보기

6/8

`STORAGES`¶

Django 4.2에서 새로 추가되었습니다.

기본값:

{
    "default": {
        "BACKEND": "django.core.files.storage.FileSystemStorage",
    },
    "staticfiles": {
        "BACKEND": "django.contrib.staticfiles.storage.StaticFilesStorage",
    },
}

Django에서 사용될 모든 스토리지 설정을 포함하는 딕셔너리입니다. 이는 스토리지 별칭을 개별 스토리지 옵션을 포함하는 딕셔너리로 매핑하는 내용을 포함하는 중첩된 딕셔너리입니다.

스토리지에는 선택한 임의의 별칭을 사용할 수 있습니다. 그러나 두 가지 특별한 의미를 가진 별칭이 있습니다:

파일 관리에 대한 default 별칭입니다. 'django.core.files.storage.FileSystemStorage'는 기본 스토리지 엔진입니다.
정적 파일 관리에 대한 staticfiles 별칭입니다. 'django.contrib.staticfiles.storage.StaticFilesStorage'는 기본 스토리지 엔진입니다.

다음은 settings.py에서 example라는 사용자 정의 파일 스토리지를 정의하는 예제 코드입니다:

STORAGES = {
    # ...
    "example": {
        "BACKEND": "django.core.files.storage.FileSystemStorage",
        "OPTIONS": {
            "location": "/example",
            "base_url": "/example/",
        },
    },
}

OPTIONS는 **kwargs로 BACKEND에 대한 초기화 시에 전달됩니다.

스토리지 백엔드의 사용 준비가 된 인스턴스는 django.core.files.storage.storages에서 획득할 수 있습니다. STORAGES에서 백엔드 정의에 해당하는 키를 사용하세요.

값이 기본값과 병합되나요?

이 설정을 정의하면 기본값이 덮어쓰기되며, 병합되지 않습니다.

`TEMPLATES`¶

기본값: [] (빈 리스트)

Django에서 사용될 모든 템플릿 엔진의 설정을 포함하는 목록입니다. 목록의 각 항목은 개별 엔진의 옵션을 포함하는 딕셔너리입니다.

다음은 Django 템플릿 엔진에게 각 설치된 애플리케이션 내부의 templates 하위 디렉토리에서 템플릿을 로드하도록 하는 설정 예제입니다:

TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "APP_DIRS": True,
    },
]

모든 백엔드에 대해 사용 가능한 다음 옵션이 있습니다.

BACKEND¶

기본값: 정의되지 않음

사용할 템플릿 백엔드입니다. 내장된 템플릿 백엔드는 다음과 같습니다:

'django.template.backends.django.DjangoTemplates'
'django.template.backends.jinja2.Jinja2'

Django와 함께 제공되지 않는 템플릿 백엔드를 사용하려면 BACKEND를 완전한 경로로 설정할 수 있습니다(예: 'mypackage.whatever.Backend').

NAME¶

기본값: 아래 참조

이 특정 템플릿 엔진에 대한 별칭입니다. 이것은 렌더링을 위해 엔진을 선택하는 데 사용되는 식별자입니다. 별칭은 모든 구성된 템플릿 엔진에서 고유해야 합니다.

제공되지 않으면 엔진 클래스를 정의하는 모듈의 이름을 기본값으로 사용합니다. 예를 들어, 백엔드가 'mypackage.whatever.Backend'인 경우 기본 이름은 'whatever'입니다.

DIRS¶

기본값: [] (빈 리스트)

엔진이 템플릿 소스 파일을 찾을 디렉토리입니다. 검색 순서대로 지정합니다.

APP_DIRS¶

기본값: False

엔진이 설치된 애플리케이션 내부에서 템플릿 소스 파일을 찾아야 하는지 여부입니다.

참고

django-admin startproject로 생성된 기본 settings.py 파일은 'APP_DIRS': True로 설정됩니다.

OPTIONS¶

기본값: {} (빈 딕셔너리)

템플릿 백엔드에 전달할 추가 매개변수입니다. 사용 가능한 매개변수는 템플

릿 백엔드에 따라 다릅니다. 내장된 백엔드의 옵션은 DjangoTemplates와 Jinja2를 참조하세요.

`TEST_RUNNER`¶

기본값: 'django.test.runner.DiscoverRunner'

테스트 스위트를 시작하는 데 사용할 클래스 이름입니다. 다른 테스트 프레임워크 사용에 대해서는 다른 테스팅 프레임워크 사용을 참조하세요.

`TEST_NON_SERIALIZED_APPS`¶

기본값: [] (빈 리스트)

TransactionTestCase와 트랜잭션 없는 데이터베이스 백엔드에 대한 테스트 간에 데이터베이스 상태를 복원하기 위해 Django는 테스트 실행을 시작할 때 모든 앱의 내용을 직렬화하여 해당 복사본을 로드한 다음 필요한 테스트를 실행하기 전에 이를 다시 로드합니다.

이로 인해 테스트 러너의 시작 시간이 느려집니다. 이 기능이 필요하지 않은 앱이 있는 경우 해당 앱의 전체 이름(예: 'django.contrib.contenttypes')을 여기에 추가하여 이 직렬화 과정에서 제외할 수 있습니다.

`THOUSAND_SEPARATOR`¶

기본값: ',' (쉼표)

숫자를 서식화할 때 사용되는 기본 천 단위 구분 기호입니다. 이 설정은 USE_THOUSAND_SEPARATOR가 True이고 NUMBER_GROUPING이 0보다 클 때만 사용됩니다.

참고로 USE_L10N가 True로 설정되어 있다면, 로캘에 따라 결정되는 형식이 우선적으로 적용되므로 해당 값이 대신 사용됩니다.

또한 NUMBER_GROUPING, DECIMAL_SEPARATOR 및 USE_THOUSAND_SEPARATOR도 참조하세요.

`TIME_FORMAT`¶

기본값: 'P' (예: 4 p.m.)

시스템의 모든 부분에서 시간 필드를 표시할 때 사용할 기본 서식입니다. USE_L10N이 True로 설정되어 있다면, 로캘에 따라 결정되는 형식이 우선적으로 적용되므로 해당 값이 대신 사용됩니다. allowed date format strings도 참조하세요.

또한 DATE_FORMAT 및 DATETIME_FORMAT도 참조하세요.

`TIME_INPUT_FORMATS`¶

기본값:

[
    "%H:%M:%S",  # '14:30:59'
    "%H:%M:%S.%f",  # '14:30:59.000200'
    "%H:%M",  # '14:30'
]

시간 필드에 데이터를 입력할 때 허용되는 형식의 목록입니다. 형식은 순서대로 시도되며, 첫 번째 유효한 형식이 사용됩니다. 이 형식 문자열은 date 템플릿 필터의 형식 문자열이 아닌 Python의 datetime 모듈 문법을 사용합니다.

USE_L10N이 True인 경우, 로캘에 따라 결정되는 형식이 우선적으로 적용되므로 해당 값이 대신 사용됩니다.

또한 DATE_INPUT_FORMATS 및 DATETIME_INPUT_FORMATS도 참조하세요.

Sure, here's the translation:

`TIME_ZONE`¶

기본값: 'America/Chicago'

이 설치의 시간대를 나타내는 문자열입니다. 시간대 목록을 참조하세요.

참고

Django가 처음 릴리스될 때 TIME_ZONE이 'America/Chicago'로 설정되었으므로, 프로젝트의 settings.py에 정의된 내용이 없는 경우 전역 설정('America/Chicago')은 호환성을 위해 그대로 유지됩니다. 새로운 프로젝트 템플릿은 기본적으로 'UTC'로 설정됩니다.

이것은 반드시 서버의 시간대를 의미하지는 않습니다. 예를 들어, 하나의 서버가 별도의 시간대 설정을 갖는 여러 Django 웹사이트를 호스팅할 수 있습니다.

USE_TZ가 False인 경우, 이것은 Django가 모든 날짜 및 시간을 저장하는 시간대입니다. USE_TZ가 True인 경우, 이것은 템플릿에서 날짜 및 시간을 표시하고 양식에 입력된 날짜 및 시간을 해석하는 데 사용하는 기본 시간대입니다.

Unix 환경에서는 (where time.tzset()가 구현된 곳), Django는 TIME_ZONE 설정에서 지정한 시간대로 os.environ['TZ'] 변수를 설정합니다. 따라서 모든 뷰와 모델이 자동으로 이 시간대에서 작동합니다. 그러나 수동 설정 옵션을 사용하는 경우에는 Django가 TZ 환경 변수를 설정하지 않습니다. 만약 Django가 TZ 환경 변수를 설정하지 않는 경우, 프로세스가 올바른 환경에서 실행되도록 보장해야 합니다.

참고

Django는 Windows 환경에서 대체 시간대를 안정적으로 사용할 수 없습니다. Windows에서 Django를 실행하는 경우, TIME_ZONE을 시스템 시간대와 일치하도록 설정해야 합니다.

`USE_DEPRECATED_PYTZ`¶

기본값: False

기본 시간대 구현으로 pytz 대신 zoneinfo를 사용할지를 지정하는 부울 값입니다.

4.0 버전부터는 더 이상 지원되지 않음: 이 전환 설정은 더 이상 지원되지 않습니다. Django 5.0에서 pytz 사용 지원이 제거될 예정입니다.

`USE_I18N`¶

기본값: True

Django의 번역 시스템을 활성화할지를 지정하는 부울 값입니다. 성능을 위해 이를 비활성화하는 방법을 제공합니다. 이 값을 False로 설정하면 Django는 번역 메커니즘을 로드하지 않도록 최적화합니다.

참고

LANGUAGE_CODE, USE_L10N, USE_TZ도 참조하세요.

`USE_L10N`¶

기본값: True

기본적으로 데이터의 지역화된 서식을 활성화할지를 지정하는 부울 값입니다. 이 값을 True로 설정하면 Django는 현재 로캘의 형식을 사용하여 숫자와 날짜를 표시합니다.

참고

LANGUAGE_CODE, USE_I18N, USE_TZ도 참조하세요.

4.0 버전부터는 더 이상 지원되지 않음: 이 설정은 더 이상 지원되지 않습니다. Django 5.0부터는 데이터의 지역화된 서식이 항상 활성화됩니다. 예를 들어 Django는 현재 로캘의 형식을 사용하여 숫자와 날짜를 표시합니다.

`USE_THOUSAND_SEPARATOR`¶

기본값: False

천 단위 구분자를 사용하여 숫자를 표시할지를 지정하는 부울 값입니다. 이 값을 True로 설정하고 USE_L10N도 True로 설정한 경우, Django는 NUMBER_GROUPING 및 THOUSAND_SEPARATOR 설정을 사용하여 숫자를 서식화합니다. 마지막 두

설정도 로캘에 의해 결정될 수 있으며, 로캘이 우선합니다.

참고

DECIMAL_SEPARATOR, NUMBER_GROUPING, THOUSAND_SEPARATOR도 참조하세요.

`USE_TZ`¶

기본값: False

참고

Django 5.0에서 기본값은 False에서 True로 변경됩니다.

날짜와 시간이 기본적으로 시간대 정보를 포함하는 것으로 지정할지를 지정하는 부울 값입니다. 이 값을 True로 설정하면 Django는 내부적으로 시간대 정보를 포함하는 날짜와 시간을 사용합니다.

USE_TZ가 False인 경우, Django는 로컬 시간에서 날짜와 시간을 처리합니다. 다만 ISO 8601 형식의 문자열을 구문 분석할 때는 시간대 정보가 포함되어 있으면 항상 유지됩니다.

참고

TIME_ZONE, USE_I18N, USE_L10N

참고

django-admin startproject로 생성된 기본 settings.py 파일은 편의를 위해 USE_TZ = True로 설정됩니다.

`USE_X_FORWARDED_HOST`¶

기본값: False

프록시가 이 헤더를 설정하는 경우 Host 헤더 대신 X-Forwarded-Host 헤더를 사용할지를 지정하는 부울 값입니다.

이 설정은 USE_X_FORWARDED_PORT 설정보다 우선합니다. RFC 7239#section-5.3에 따르면 X-Forwarded-Host 헤더에 포트 번호를 포함할 수 있으며, 이 경우에는 USE_X_FORWARDED_PORT을 사용하지 않아야 합니다.

`USE_X_FORWARDED_PORT`¶

기본값: False

프록시가 이 헤더를 설정하는 경우 SERVER_PORT META 변수 대신 X-Forwarded-Port 헤더를 사용할지를 지정하는 부울 값입니다.

이 설정은 USE_X_FORWARDED_HOST 설정보다 우선합니다.

`WSGI_APPLICATION`¶

기본값: None

Django의 내장 서버(예: runserver)가 사용할 WSGI 애플리케이션 객체의 전체 Python 경로입니다. django-admin startproject 관리 명령은 wsgi.py 파일을 생성하고 그 안에 application 호출 가능 객체를 생성하며, 이 설정을 해당 application으로 지정합니다.

설정되지 않은 경우, django.core.wsgi.get_wsgi_application()의 반환 값이 사용됩니다. 이 경우 runserver의 동작은 이전 버전의 Django와 동일합니다.

`YEAR_MONTH_FORMAT`¶

기본값: 'F Y'

Django 관리자 변경 목록 페이지 등에서 날짜 필드에 사용할 기본 서식화입니다. 이 서식은 연도와 월만 표시되는 경우에 사용됩니다.

예를 들어, Django 관리자 변경 목록 페이지에서 날짜를 드릴다운으로 필터링할 때, 특정 월의 헤더에는 월과 연도가 표시됩니다. 서로 다른 로캘에 따라 서로 다른 형식이 사용됩니다. 예를 들어 미국 영어에서는 "January 2006"라고 표시되겠지만, 다른 로캘에서는 "2006/January" 등이 될 수 있습니다.

USE_L10N이 True로 설정된 경우, 해당 로캘에 의해 결정되는 서식이 우선하며 적용됩니다.

allowed date format strings도 참조하세요. DATE_FORMAT, DATETIME_FORMAT, TIME_FORMAT, MONTH_DAY_FORMAT도 참조하세요.

`X_FRAME_OPTIONS`¶

기본값: `'

DENY'`

XFrameOptionsMiddleware에서 사용하는 X-Frame-Options 헤더의 기본값입니다. 클릭재킹 보호 문서를 참조하세요.

hwisaac

이전 포스트

django-core setting(5)

다음 포스트

django-core setting(6)

djnago-setting

`STORAGES`¶

`TEMPLATES`¶

`TEST_RUNNER`¶

`TEST_NON_SERIALIZED_APPS`¶

`THOUSAND_SEPARATOR`¶

`TIME_FORMAT`¶

`TIME_INPUT_FORMATS`¶

`TIME_ZONE`¶

`USE_DEPRECATED_PYTZ`¶

`USE_I18N`¶

`USE_L10N`¶

`USE_THOUSAND_SEPARATOR`¶

`USE_TZ`¶

`USE_X_FORWARDED_HOST`¶

`USE_X_FORWARDED_PORT`¶

`WSGI_APPLICATION`¶

`YEAR_MONTH_FORMAT`¶

`X_FRAME_OPTIONS`¶

django-core setting(5)

django-settings(7): Auth, messages, sessions

0개의 댓글

django-core setting(6)

djnago-setting

STORAGES¶

TEMPLATES¶

TEST_RUNNER¶

TEST_NON_SERIALIZED_APPS¶

THOUSAND_SEPARATOR¶

TIME_FORMAT¶

TIME_INPUT_FORMATS¶

TIME_ZONE¶

USE_DEPRECATED_PYTZ¶

USE_I18N¶

USE_L10N¶

USE_THOUSAND_SEPARATOR¶

USE_TZ¶

USE_X_FORWARDED_HOST¶

USE_X_FORWARDED_PORT¶

WSGI_APPLICATION¶

YEAR_MONTH_FORMAT¶

X_FRAME_OPTIONS¶

django-core setting(5)

django-settings(7): Auth, messages, sessions

0개의 댓글

`STORAGES`¶

`TEMPLATES`¶

`TEST_RUNNER`¶

`TEST_NON_SERIALIZED_APPS`¶

`THOUSAND_SEPARATOR`¶

`TIME_FORMAT`¶

`TIME_INPUT_FORMATS`¶

`TIME_ZONE`¶

`USE_DEPRECATED_PYTZ`¶

`USE_I18N`¶

`USE_L10N`¶

`USE_THOUSAND_SEPARATOR`¶

`USE_TZ`¶

`USE_X_FORWARDED_HOST`¶

`USE_X_FORWARDED_PORT`¶

`WSGI_APPLICATION`¶

`YEAR_MONTH_FORMAT`¶

`X_FRAME_OPTIONS`¶