Django 헬로 월드 튜토리얼

Django를 실행하기 전에 시스템에 Python 3.8 이상과 pip(Python의 패키지 설치 프로그램)가 설치되어 있어야 합니다. 대부분의 최신 운영 체제에는 Python이 사전 설치되어 있지만, 항상 확인하는 것이 좋습니다.

터미널을 열고 현재 Python 버전을 확인하세요:

python3 --version

Python 3.8.x 이상이 표시되지 않거나 Python을 찾을 수 없다는 메시지가 나오면 python.org에서 최신 안정적인 3.x 버전을 다운로드하여 설치하세요. Django는 최신 버전을 선호합니다.

전역 Python 패키지를 건드리는 것은 마치 pristine 라이브러리에 있는 어린아이처럼, 상황을 복잡하게 만들 수 있습니다. 그렇기 때문에 가상 환경을 사용합니다. 가상 환경은 프로젝트의 종속성을 위한 깔끔하고 격리된 공간으로, 모든 것을 정리하고 충돌을 방지합니다.

먼저, Django 프로젝트를 어디에 저장할지 결정합니다. 터미널에서 해당 디렉토리로 이동한 후, 새로운 가상 환경을 생성합니다:

python3 -m venv .venv

이제 활성화해 보겠습니다. 운영 체제에 따라 명령어가 약간 다릅니다:

# macOS/Linux에서
source .venv/bin/activate

# Windows에서 (명령 프롬프트 사용)
.venv\Scripts\activate

터미널 프롬프트에 (.venv) 접두사가 붙으면 제대로 작동하는 것입니다. 이것은 여러분의 격리된 개발 왕국임을 나타내는 작은 훈장입니다.

가상 환경이 실행되는 동안, 이제 메인 이벤트입니다: Django를 통합하는 것입니다. 이것은 놀랍도록 쉽습니다—단 하나의 명령어로 가능합니다.

활성화된 가상 환경에서 다음을 실행합니다:

pip install django

Pip이 Django와 필요한 모든 동반자를 다운로드합니다. 완료되면 공식적으로 Django 지원 개발자가 됩니다. 프레임워크가 설치되었으며 작업에 투입할 준비가 되었습니다.

이제 Django 마법입니다! Django와 함께 제공되는 django-admin 명령을 사용하여 완전히 새로운 프로젝트를 구성합니다. Django가 웹 애플리케이션에 대한 기본 청사진을 제공하는 것이라고 생각하면 됩니다.

프로젝트의 루트 디렉토리 (.venv가 있는 곳)에서 이 명령을 실행합니다:

django-admin startproject mysite .

마지막의 .는 중요합니다. 이것은 Django가 프로젝트 파일을 다른 mysite 폴더 안에 중첩시키는 대신 현재 디렉토리에 생성하도록 지시합니다. 이제 기본적인 Django 프로젝트 구조, 즉 웹 꿈을 위한 일종의 골격이 생겼습니다.

startproject 명령을 실행한 후, 디렉토리에 몇 개의 파일과 하위 디렉토리가 추가되었을 것입니다. 무엇이 무엇인지 이해하기 위해 간단히 살펴보는 것이 좋습니다:

.
├── .venv/                  # 여러분의 가상 환경
├── manage.py               # Django의 명령줄 유틸리티
└── mysite/                 # 프로젝트의 실제 Python 패키지
    ├── __init__.py         # mysite를 Python 패키지로 만듦
    ├── asgi.py             # 비동기 서버를 위한 ASGI 진입점
    ├── settings.py         # 프로젝트 설정 및 구성
    ├── urls.py             # 프로젝트의 URL 선언
    └── wsgi.py             # 동기 서버를 위한 WSGI 진입점
                                

manage.py는 모든 Django 명령줄 관련 작업을 위한 충실한 동반자입니다. mysite/ 내부에서 settings.py는 구성을 조정하는 곳이며, urls.py는 프로젝트의 주요 트래픽 컨트롤러입니다.

웹 페이지를 보기 전에 Django는 기본 데이터베이스 테이블을 설정해야 합니다. 사용자 인증 및 관리자 인터페이스와 같은 일부 내장 기능이 있으며, 이 기능들은 데이터를 저장할 공간이 필요합니다.

이것이 마이그레이션의 역할입니다. 마이그레이션은 본질적으로 데이터베이스에 대한 지침입니다. 프로젝트 루트 (manage.py가 있는 곳)에서 다음을 실행합니다:

python manage.py migrate

Django가 기본 SQLite 데이터베이스에 인증, 세션 및 관리자 패널을 위한 테이블을 생성하면서 많은 활동이 표시될 것입니다. 벽을 세우기 전에 기초를 준비하는 것과 같습니다.

Django에서 "프로젝트"는 구성 및 "앱"의 모음입니다. "앱"은 특정 작업을 수행하는 웹 애플리케이션입니다. 블로그, 설문 조사, 간단한 "Hello World" 등입니다. 이러한 모듈성은 Django의 강력한 기능 중 하나이며, 앱을 다른 프로젝트에서 재사용할 수 있게 합니다.

첫 번째 앱을 만들어 보겠습니다. hello_world_app이라고 부르겠습니다. 이 명령을 실행합니다:

python manage.py startapp hello_world_app

이제 프로젝트 내에 중첩된 새 디렉토리 hello_world_app/가 표시됩니다. 이곳에서 "Hello World"의 마법이 실제로 일어날 것입니다.

Django는 새로 생성된 앱을 자동으로 알지 못합니다. 프로젝트 설정에 이 새 앱이 존재하며 포함되어야 함을 명시적으로 알려야 합니다. 마치 클럽에 새로운 멤버를 추가하는 것과 같습니다. 명단을 업데이트해야 합니다.

mysite/settings.py를 열고 INSTALLED_APPS 목록을 찾습니다. 여기에 새 hello_world_app을 추가합니다:

# mysite/settings.py

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'hello_world_app',  # <-- 이 줄을 추가하세요
]
                                

이것 없이는 Django가 새 앱 내부에서 뷰, 모델 또는 기타 내용을 찾지 않을 것입니다. 이는 프로젝트와 새로운 구성 요소 간의 중요한 핸드셰이크입니다.

Django에서 "뷰"는 웹 요청을 받아 웹 응답을 반환하는 Python 함수 또는 클래스입니다. 본질적으로 특정 URL을 방문할 때 어떤 콘텐츠를 표시할지 결정하는 핵심 로직입니다.

hello_world_app/views.py를 열고 내용을 이 간단한 함수로 바꿉니다:

# hello_world_app/views.py

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, Django World!")
                                

index 함수는 매우 간단합니다. 호출되면 "Hello, Django World!"라는 텍스트를 출력합니다. 첫 단계치고는 꽤 괜찮죠?

새로운 뷰에 웹 주소를 통해 접근하려면 URL 패턴이 필요합니다. hello_world_app 내부에 전용 urls.py 파일을 생성하여 특정 경로를 관리합니다. 이렇게 하면 Django가 좋아하는 대로 모듈화됩니다.

새 파일 hello_world_app/urls.py를 생성하고 다음 내용을 입력합니다:

# hello_world_app/urls.py

from django.urls import path
from . import views

urlpatterns = [
    path("", views.index, name="index"),
]
                                

여기서 path("", views.index, name="index")는 빈 경로 (즉, 앱 URL 공간의 루트)가 index 뷰를 트리거한다는 것을 의미합니다. 간단하죠?

앱에 자체 URL을 알려주었지만, 프로젝트의 메인 URL 디스패처 (mysite/urls.py)는 hello_world_app에 관련 경로가 있음을 알려야 합니다. 마치 지점 사무실이 있지만, 본사는 우편물을 전달하기 위해 그것이 존재한다는 것을 알아야 하는 것과 같습니다.

mysite/urls.py를 열고 앱의 URL을 연결하기 위해 include를 추가합니다:

# mysite/urls.py

from django.contrib import admin
from django.urls import path, include # <-- 'include' 추가

urlpatterns = [
    path("admin/", admin.site.urls),
    path("", include("hello_world_app.urls")), # <-- 이 줄을 추가하세요
]
                                

이제 누군가 프로젝트의 루트 URL (/)을 방문하면 Django는 hello_world_app/urls.py에서 URL 패턴을 "포함"하여 "Hello World" 뷰를 찾습니다. 모든 조각이 맞춰지고 있습니다!

모든 준비 작업을 마쳤고, 코드를 연결했으며, 경로를 정의했습니다. 이제 진실의 순간입니다! Django에는 로컬에서 테스트하기에 완벽한 경량 개발 서버가 내장되어 있습니다.

프로젝트의 루트 디렉토리 (manage.py가 있는 곳)에서 다음을 실행합니다:

python manage.py runserver

터미널에 여러 메시지가 표시되며, Starting development server at http://127.0.0.1:8000/와 같은 메시지로 끝날 것입니다. 이는 Django 서버가 시작되었고 요청을 기다리고 있다는 의미입니다.

그 순간이 왔습니다! 웹 브라우저를 열고 Django가 제공한 주소, 일반적으로 http://127.0.0.1:8000/로 이동합니다.

모든 연결이 올바르게 이루어졌다면, 다음과 같은 간단한 웹 페이지가 표시될 것입니다:

바로 이것입니다. 여러분의 첫 번째 Django "Hello World" 애플리케이션이 라이브로 콘텐츠를 제공합니다! 작은 단계이지만, Python부터 Django의 URL 라우팅까지 모든 것이 올바르게 구성되었음을 확인시켜 줍니다. 공식적으로 Django 개발 여정을 시작했습니다.