Python 웹 개발 분야에서 Django 프레임워크는 빛나는 별과 같으며 포괄적이고 효율적이며 안전한 기능으로 전 세계적으로 인기를 얻고 있습니다. 이 기사에서는 Django 프레임워크의 기본 파일을 종합적으로 분석하고 각 파일의 의미와 용도 및 구성에 대해 심도 있게 논의하고 이 강력한 프레임워크의 파일 구조와 설계 원칙을 철저히 설명합니다.

먼저 새 Django 프로젝트를 만든 후 디렉터리 구조를 살펴보겠습니다.

myproject/
    manage.py
    myproject/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

manage.py: 서버 실행, 테스트 실행, 데이터베이스 스키마 생성 등과 같은 프로젝트 관리 및 개발과 관련된 많은 작업을 수행하는 데 사용할 수 있는 Django 프로젝트용 명령줄 도구입니다.
myproject/__init__.py: 이것은 Python 인터프리터에게 디렉토리가 Python 패키지임을 알려주는 데 사용되는 빈 파일입니다.
myproject/settings.py: 이 파일에는 모든 프로젝트 구성이 포함되어 있습니다. 각 Django 프로젝트에는 데이터베이스, 애플리케이션, 미들웨어, 템플릿, 캐싱 등을 구성할 수 있는 자체 설정이 있습니다.
myproject/urls.py: 이 파일은 프로젝트의 URL 경로를 정의합니다. URL 패턴과 해당 뷰 기능을 작성함으로써 Django는 HTTP 요청을 적절한 뷰로 라우팅할 수 있습니다.
myproject/asgi.py그리고 myproject/wsgi.py: 이 두 파일은 서버를 구성하는데 사용되며, WSGI는 Python의 웹 서버 게이트웨이 인터페이스이고, ASGI는 비동기 요청을 처리하기 위한 비동기 서버 게이트웨이 인터페이스입니다.

관리.py

Django의 프로젝트 구조에서 manage.py매우 중요한 역할을 합니다. 다양한 방식으로 Django 프로젝트와 상호 작용할 수 있는 명령줄 도구입니다. 이 파일과 주요 용도에 대해 자세히 살펴보겠습니다.

먼저 Django는 새 Django 프로젝트를 생성할 때 자동으로 파일을 생성합니다 manage.py. django-admin.py이것은 프로젝트의 루트 디렉토리에 있으며 주요 목적 은 프로젝트의 기능을 캡슐화하고 프로젝트에 특정한 몇 가지 추가 명령을 포함하는 명령줄 유틸리티가 되는 것입니다 .

일반적인 파일 내용을 살펴보겠습니다 manage.py.

#!/usr/bin/env python
"""Django's command-line utility for administrative tasks."""
import os
import sys

def main():
    """Run administrative tasks."""
    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')
    try:
        from django.core.management import execute_from_command_line
    except ImportError as exc:
        raise ImportError(
            "Couldn't import Django. Are you sure it's installed and "
            "available on your PYTHONPATH environment variable? Did you "
            "forget to activate a virtual environment?"
        ) from exc
    execute_from_command_line(sys.argv)

if __name__ == '__main__':
    main()

manage.py파일에서 Django의 설정 모듈이 DJANGO_SETTINGS_MODULE'myproject.settings'의 기본값을 가진 환경 변수로 정의된 것을 볼 수 있습니다 . 그런 다음 명령줄 관리 작업을 수행하는 데 사용되는 django.core.management가져 오기를 시도합니다 .execute_from_command_line

manage.py몇 가지 일반적인 사용법을 살펴보겠습니다 .

개발 서버 실행 : 로컬에서 개발할 때 Django와 함께 제공되는 개발 서버를 실행해야 하는 경우가 많습니다. runserver다음 명령으로 이 작업을 수행 할 수 있습니다 .

python manage.py runserver

이렇게 하면 기본적으로 켜져 있는 개발 서버가 시작됩니다 127.0.0.1:8000. 브라우저에서 이 주소를 방문하여 웹사이트를 볼 수 있습니다.

데이터베이스 마이그레이션 : Django에는 많은 데이터베이스 관련 작업을 처리할 수 있는 매우 강력한 데이터베이스 추상화 API가 있습니다. 예를 들어 모델(모델)을 변경할 때 이러한 변경 사항을 데이터베이스에 적용해야 하므로 데이터베이스 마이그레이션이 필요합니다. 방법은 다음과 같습니다 manage.py.

python manage.py makemigrations  # 创建迁移文件
python manage.py migrate  # 应用迁移至数据库

수퍼유저 만들기 : Django의 관리자 배경에 액세스해야 할 때 수퍼유저를 만들어야 합니다. 다음 명령으로 이를 수행할 수 있습니다.

python manage.py createsuperuser

Django Shell : manage.py대화형 Python Shell도 제공되지만 이 Shell은 Django 환경에서 실행됩니다. 즉, 테스트 및 디버깅에 매우 유용한 이 셸에서 모델, 보기, 설정 등을 가져올 수 있습니다.

python manage.py shell

Django의 일상적인 사용에서 manage.py매우 중요한 도구입니다. Django 프로젝트와의 상호 작용을 매우 쉽게 만들고 많은 일반적인 작업을 캡슐화합니다. 사용 방법을 배우 manage.py면 Django 개발이 더 쉬워집니다.

초기화 .py

파이썬에서 __init__.py파일은 중요한 위치를 가지며, 그 존재는 파이썬이 폴더를 패키지(패키지)로 인식할 수 있도록 합니다. 이 개념은 Python의 모듈식 프로그래밍에서 특히 중요하며, 이를 통해 코드를 보다 체계적으로 구성하고 더 나은 네임스페이스 관리를 제공할 수 있습니다. __init__.py이제 이 기능과 사용 방법에 대해 자세히 살펴보겠습니다 .

__init__.py먼저 가장 간단한 파일인 빈 파일을 살펴보겠습니다 . Python 프로젝트에서 이러한 파일을 많이 볼 수 있습니다. 패키지 디렉토리 아래에 있으며 이름은 __init__.py.

# mypackage/__init__.py

이 빈 파일의 존재는 파이썬 인터프리터가 패키지(패키지)로 디렉토리를 취급하고 이 패키지가 다른 모듈(모듈) 또는 하위 패키지(하위 패키지)를 포함할 수 있음을 의미합니다. 예를 들어 다음 프로젝트 구조가 있는 경우:

mypackage/
    __init__.py
    module1.py
    module2.py

이 경우 다음과 같이 모듈을 가져올 수 있습니다.

from mypackage import module1, module2

폴더를 패키지로 표시하는 것 외에도 __init__.py다른 중요한 용도가 있습니다. 일반적으로 __init__.py패키지 수준의 초기화 코드를 저장하거나 쉽게 가져올 수 있도록 별칭을 정의하는 데 사용됩니다. 예를 들어 에서 모듈을 가져올 수 있으므로 __init__.py패키지를 가져올 때 직접 사용할 수 있습니다.

# mypackage/__init__.py

from . import module1, module2

그런 다음 모듈을 별도로 가져오지 않고 패키지를 직접 가져올 수 있습니다.

import mypackage

# 我们可以直接使用mypackage.module1，而不需要单独导入module1
mypackage.module1.some_function()

또한 변수를 __init__.py정의하는 데 사용할 수 있습니다 __all__. __all__변수는 패키지에서 *를 가져올 때 가져올 모듈을 정의하는 문자열 목록입니다.

# mypackage/__init__.py

__all__ = ['module1', 'module2']

이제 다음과 같이 가져올 때:

from mypackage import *

module1및 만 module2가져오고 다른 모듈은 가져오지 않습니다.

일반적으로 __init__.pyPython 패키지 구조의 핵심 부분으로 코드를 더 잘 구성하고 관리할 수 있습니다. 작동 방식과 사용 방법을 이해하면 더 모듈화되고 유지 관리 가능한 코드를 작성하는 데 도움이 될 수 있습니다.

settings.py

Django 프레임워크는 모듈성과 유연성으로 유명한 웹 프레임워크로 많은 측면을 구성할 수 있으며 이러한 구성은 settings.py파일에 집중되어 있습니다. Django 프로젝트에서 settings.py파일은 매우 중요하며 프로젝트를 실행하는 데 필요한 모든 구성 정보가 포함되어 있습니다. 이제 이 파일과 주요 용도에 대해 자세히 살펴보겠습니다.

새 Django 프로젝트의 파일 settings.py에는 대부분의 상황에 적합한 많은 기본 구성이 포함되어 있지만 필요에 따라 이러한 구성을 수정할 수 있습니다. 가장 중요한 설정은 다음과 같습니다.

DEBUG : 이 설정은 Django가 디버그 모드에서 실행할지 여부를 알려줍니다. 개발 환경에서는 일반적으로 이것을 True로 설정하여 무언가 잘못되었을 때 Django가 자세한 오류 메시지를 표시하도록 합니다. 그러나 프로덕션 환경에서는 False로 설정해야 합니다.

DEBUG = True

INSTALLED_APPS : 이 설정은 프로젝트의 모든 앱을 정의합니다. 각 애플리케이션은 일부 보기, 모델, 템플릿 등을 포함하는 Python 패키지입니다. 새 응용 프로그램을 만들거나 타사 응용 프로그램을 설치할 때 해당 응용 프로그램을 이 목록에 추가해야 합니다.

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # Add your apps here
    'myapp',
]

MIDDLEWARE : 이 설정은 요청 및 응답을 처리하는 데 중요한 역할을 하는 미들웨어 클래스 집합을 정의합니다. 자신의 미들웨어를 추가하거나 이 목록의 순서를 수정하여 미들웨어의 실행 순서를 변경할 수 있습니다.

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

DATABASES : 이 설정은 데이터베이스 구성을 정의합니다. Django는 ORM(Object Relational Mapping)을 사용하여 데이터베이스 작업을 처리하며 SQLite, PostgreSQL, MySQL 등 Django에서 지원하는 모든 데이터베이스 백엔드를 사용할 수 있습니다.

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

템플릿 : 이 설정은 템플릿 위치, 템플릿 엔진 등을 포함하여 Django의 템플릿 구성을 정의합니다.

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

STATIC_URL 및 STATIC_ROOT : 이 두 설정은 정적 파일을 처리하는 방법을 구성하는 데 사용됩니다. STATIC_URL정적 파일의 URL 접두사를 정의하고 STATIC_ROOT정적 파일의 저장 위치를 정의합니다.

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static')

위는 settings.py파일의 일부 기본 설정일 뿐이며 실제로 이 파일에는 더 많은 구성 항목이 있으며 필요에 따라 이러한 구성을 조정할 수 있습니다. settings.py파일이 작동하는 방식과 파일을 사용하는 방법을 이해하는 것은 Django를 마스터하는 데 있어 핵심 단계입니다.

urls.py

Django의 웹 프레임워크에서 urls.py파일은 매우 중요한 부분으로 사용자가 요청한 URL이 해당 뷰 함수 또는 클래스에 올바르게 매핑될 수 있도록 URL 라우팅 구성을 담당합니다. urls.py이 게시물에서는 파일의 구조와 사용법에 대해 자세히 살펴보겠습니다 .

새로 생성된 Django 프로젝트에서 urls.py파일은 프로젝트 루트 디렉토리에 있습니다. 이 파일에는 urlpatterns라는 목록이 포함되어 있으며 목록의 각 항목은 path()또는 re_path()함수 호출이며 이 함수 호출은 URL 패턴과 보기 간의 매핑 관계를 정의합니다.

다음은 간단한 urls.py파일입니다.

from django.urls import path
from . import views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('hello/', views.hello_world),
]

이 파일에서는 먼저 모듈에서 함수를 django.urls가져온 다음 목록을 정의합니다. 이 목록에는 두 가지 URL 패턴이 포함되어 있습니다. 첫 번째 패턴은 Django의 기본 제공 관리 뷰에 매핑되는 패턴이고 두 번째 패턴은 자체적으로 정의된 뷰에 매핑되는 패턴입니다.path()urlpatterns'admin/''hello/'hello_world

path()함수는 두 개의 필수 매개변수를 허용합니다. 첫 번째는 URL 패턴 문자열이고 두 번째는 뷰 함수 또는 클래스입니다. 또한 보기에 대한 추가 매개변수를 전달하는 데 사용할 수 있는 사전인 선택적 세 번째 매개변수를 허용할 수 있습니다.

path()함수 외에도 django.urls모듈은 re_path()정규식을 사용하여 URL 패턴을 정의할 수 있는 함수도 제공합니다. 예를 들어 다음 코드는 모든 숫자와 일치하는 URL 패턴을 정의합니다.

from django.urls import re_path
from . import views

urlpatterns = [
    re_path(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),
]

(?P<year>[0-9]{4})이 예에서 URL 패턴 문자열은 4자리 숫자와 일치하고 이름을 지정하는 정규식입니다 year. 뷰 함수에서 매개변수를 통해 이 값을 얻을 year_archive수 있습니다 year.

urls.py이 파일은 Django 프로젝트의 중요한 부분으로 사용자가 요청한 URL을 해당 뷰에 매핑하여 사용자의 요청을 처리합니다. 작동 원리와 사용법을 이해하면 Django 프레임워크를 사용하여 웹 애플리케이션을 더 잘 구축할 수 있습니다.

asgi.py

Asynchronous Server Gateway Interface의 전체 이름인 ASGI는 비동기 웹 애플리케이션을 구축하기 위한 Python 표준 인터페이스입니다. Django 3.0부터 Django는 ASGI를 지원하기 시작했습니다. 이를 통해 Django에서 비동기 프로그래밍을 사용하여 웹 애플리케이션의 성능을 향상시킬 수 있습니다. Django 프로젝트에서 asgi.py파일은 ASGI 애플리케이션을 정의하고 미들웨어 및 라우팅을 구성하는 ASGI 구성 파일입니다. asgi.py이제 파일과 주요 사용법을 자세히 살펴보겠습니다 .

먼저 새로 생성된 Django 프로젝트의 파일을 살펴보겠습니다 asgi.py.

"""
ASGI config for myproject project.

It exposes the ASGI callable as a module-level variable named ``application``.

For more information on this file, see
https://docs.djangoproject.com/en/3.1/howto/deployment/asgi/
"""

import os

from django.core.asgi import get_asgi_application

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')

application = get_asgi_application()

이 파일에서 먼저 환경 변수를 설정하여 DJANGO_SETTINGS_MODULEDjango에 사용해야 하는 설정 파일을 알려줍니다. get_asgi_application()그런 다음 함수를 호출하여 ASGI 애플리케이션을 가져오고 application변수에 할당합니다. 이 application변수는 ASGI 서버 인터페이스의 진입점이며 ASGI 서버는 이 변수를 사용하여 Django 애플리케이션을 시작합니다.

이 기본 asgi.py파일은 Django 애플리케이션이 Daphne 또는 Uvicorn과 같은 ASGI 서버에서 실행되기에 충분합니다. 그러나 ASGI의 진정한 힘은 비동기 특성에 있습니다. 비동기 미들웨어 및 라우팅을 추가하여 이 기능을 활용할 수 있습니다.

예를 들어 Websocket 연결을 처리하기 위해 비동기 미들웨어를 추가할 수 있습니다.

from channels.routing import ProtocolTypeRouter, URLRouter
from channels.auth import AuthMiddlewareStack
import myapp.routing

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')

application = ProtocolTypeRouter({
    "http": get_asgi_application(),
    "websocket": AuthMiddlewareStack(
        URLRouter(
            myapp.routing.websocket_urlpatterns
        )
    ),
})

ProtocolTypeRouter이 예에서는 프로토콜 유형에 따라 요청을 라우팅할 수 있는 인스턴스를 생성합니다 . HTTP 요청에는 원본 Django 애플리케이션을 사용했고 Websocket 요청에는 미들웨어 스택과 URL 라우터를 사용했습니다. AuthMiddlewareStack인증 기능을 제공하는 미들웨어이며 URLRouterWebsocket 요청을 라우팅하는 데 사용됩니다.

일반적으로 asgi.py파일은 미들웨어 및 라우팅 추가를 포함하여 ASGI 애플리케이션을 구성하는 방법을 제공하는 Django 비동기 프로그래밍의 진입점입니다. 작동 원리와 사용법을 이해하면 Django에서 비동기 프로그래밍을 더 잘 사용하고 웹 애플리케이션의 성능을 향상하는 데 도움이 될 수 있습니다.

wsgi.py

WSGI(Web Server Gateway Interface)는 Python 응용 프로그램과 웹 서버 간의 공통 인터페이스입니다. Django에서 wsgi.py파일은 웹 서버가 Django 애플리케이션과 상호 작용할 수 있도록 하는 WSGI 인터페이스의 구성 파일입니다. wsgi.py이 게시물에서는 파일의 구조와 사용법에 대해 자세히 살펴보겠습니다 .

새로 생성된 Django 프로젝트에서 wsgi.py파일은 프로젝트 루트 디렉터리에 있습니다. 주로 환경 변수 설정 DJANGO_SETTINGS_MODULE과 WSGI 애플리케이션 정의의 두 부분으로 구성됩니다. wsgi.py다음은 파일의 일반적인 예 입니다 .

"""
WSGI config for mysite project.

It exposes the WSGI callable as a module-level variable named ``application``.

For more information on this file, see
https://docs.djangoproject.com/en/3.1/howto/deployment/wsgi/
"""

import os

from django.core.wsgi import get_wsgi_application

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'mysite.settings')

application = get_wsgi_application()

이 파일에서 os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'mysite.settings')이 코드 줄은 DJANGO_SETTINGS_MODULEDjango가 사용해야 하는 settings.py 파일을 알려주는 환경 변수를 설정합니다.

그리고 application = get_wsgi_application()이 코드 라인은 WSGI 애플리케이션을 정의합니다. get_wsgi_application()이 함수는 HTTP 요청을 처리하고 HTTP 응답을 생성할 수 있는 WSGI 애플리케이션을 반환합니다. 여기서 는 applicationWSGI 서버 인터페이스의 진입점인 전역 변수입니다.

그런 다음 WSGI 서버를 사용하여 Django 애플리케이션을 실행할 수 있습니다. 예를 들어 Gunicorn을 사용하면 명령줄에 다음 명령을 입력할 수 있습니다.

gunicorn mysite.wsgi

이 명령은 Gunicorn 서버를 시작하고 mysite.wsgi모듈의 변수를 applicationWSGI 애플리케이션으로 로드합니다.

전체적으로 wsgi.py이 파일은 Django 애플리케이션과 WSGI 서버의 인터페이스를 정의하는 중요한 Django 구성 파일입니다. 이 파일이 작동하는 방식을 이해하면 Django 애플리케이션이 실행되는 방식과 Django 애플리케이션을 배포하는 방법을 더 잘 이해할 수 있습니다.

도움이 된다면 개인 WeChat 공개 계정에 더 많은 관심을 기울이십시오: [Python 전체 관점] TeahLead_KrisChang, 인터넷 및 인공 지능 산업에서 10년 이상의 경험, 기술 및 비즈니스 팀 관리에서 10년 이상의 경험, Tongji Software 엔지니어링 학사, Fudan 엔지니어링 관리 마스터, Aliyun 인증 클라우드 서비스 수석 설계자, 수억 매출의 AI 제품 비즈니스 책임자.

Django의 쉽게 잊혀지지만 매우 중요한 프레임워크 기본 파일 소개 및 사용