Core Files (핵심 파일)

각 파일은 Django 프로젝트의 기본 구조를 형성하며, 아래에서 자세히 설명합니다.

핵심 파일 목록

파일	설명
manage.py	프로젝트 관리 및 명령어 실행
settings.py	프로젝트 설정
urls.py	URL 라우팅
wsgi.py	WSGI 웹 서버 연동
asgi.py	ASGI 서버 연동

graph TD;
    M["manage.py<br/>(프로젝트 관리)"] --> S["settings.py<br/>(전역 설정)"];
    M --> U["urls.py<br/>(URL 라우팅)"];
    M --> W["wsgi.py<br/>(동기 웹서버 연동)"];
    M --> A["asgi.py<br/>(비동기 서버 연동)"];
    
    S --> |설정 제공| W;
    S --> |설정 제공| A;
    S --> |앱/미들웨어 설정| U;
    
    U --> |요청 처리| W;
    U --> |요청 처리| A;
    
%% 각 컴포넌트의 주요 역할
%% manage.py: 프로젝트 명령어 실행 및 관리
%% settings.py: 프로젝트 환경 설정 관리
%% urls.py: URL 패턴과 뷰 매핑
%% wsgi.py: 전통적인 웹 서버 연동
%% asgi.py: 비동기/WebSocket 지원
Mermaid
복사

manage.py – Django 프로젝트 실행 도우미

•

Django 프로젝트의 명령어 인터페이스 역할을 합니다.

•

예: runserver, migrate, startapp 등 관리 명령을 실행할 때 사용.

•

내부적으로는 settings.py를 불러와 Django 환경을 초기화함.

settings.py – 프로젝트 전역 설정 파일

•

프로젝트의 모든 환경 설정을 정의하는 곳.

•

주요 설정 항목:

◦

데이터베이스 정보 (DATABASES)

◦

앱 등록 (INSTALLED_APPS)

◦

미들웨어 (MIDDLEWARE)

◦

정적/미디어 파일 경로

◦

보안 설정 (SECRET_KEY, DEBUG, ALLOWED_HOSTS)

•

개발/운영 환경에 따라 분리 관리 가능 (예: settings_dev.py, settings_prod.py)

미들웨어란?

요청과 응답을 처리하는 과정에서 작동하는 프레임워크 컴포넌트입니다. 미들웨어는 다음과 같은 기능을 수행합니다:

•

보안 관련 처리 (인증, CSRF 보호 등)

•

세션 관리

•

요청/응답 데이터 처리

•

캐싱

미들웨어는 순서대로 실행되며, settings.py의 MIDDLEWARE 리스트에 정의된 순서를 따릅니다. 요청이 들어올 때는 위에서 아래로, 응답이 나갈 때는 아래에서 위로 실행됩니다.

urls.py – URL 라우팅 설정 파일

•

클라이언트의 요청 URL을 어떤 view로 보낼지 연결하는 역할.

•

path(), re_path() 또는 include() 등을 사용해 URL 패턴 정의.

•

project/urls.py는 전체 프로젝트 라우팅의 시작점.

•

각 앱에도 urls.py를 따로 두고, include()로 연결 가능.

wsgi.py – 웹 서버 게이트웨이 인터페이스

•

WSGI (Web Server Gateway Interface) 표준을 구현한 파일.

•

Apache, Nginx 등의 웹 서버와 Django 앱을 연결하는 역할.

•

운영 환경에서 Django 앱을 배포할 때 주로 사용.

asgi.py – 비동기 서버 게이트웨이 인터페이스

•

ASGI (Asynchronous Server Gateway Interface)를 구현한 파일.

•

WebSocket 등 비동기 프로토콜을 지원하는 현대적인 인터페이스.

•

Daphne, Uvicorn 등의 ASGI 서버와 함께 사용.

•

실시간 기능이 필요한 앱에서 주로 활용.