예제로 배워봅시다.
\n이 튜토리얼을 통해, 간단한 설문조사(Polls) 어플리케이션을 만드는 과정을 따라해 보겠습니다.
\n두 파트로 구성되어 있습니다.
\n사람들이 설문 내용을 보고 직접 투표할 수 있는 개방된 사이트
관리자가 설문을 추가, 변경, 삭제할 수 있는 관리용 사이트
Django 설치가 되어 있다고 가정합니다. 쉘 프롬프트 ($ 접두사로 표시)에서 다음 명령을 실행하여 Django가 설치되어 있고 어떤 버전인지 알 수 있습니다.
\nLinux / macOS
$ python -m django --version\nWindows
...\\> py -m django --version\nDjango가 설치 되었다면, 설치된 Django의 버전을 확인할 수 있습니다. 만약 설치가 제대로 되지 않았다면, “No module named django”와 같은 에러가 발생합니다.
\nThis tutorial is written for Django 5.1, which supports Python 3.10 and\nlater. If the Django version doesn’t match, you can refer to the tutorial for\nyour version of Django by using the version switcher at the bottom right corner\nof this page, or update Django to the newest version. If you’re using an older\nversion of Python, check 장고와 어떤 파이썬 버전을 사용해야 하나요? to find a compatible\nversion of Django.
\n\nDjango를 처음 사용한다면, 초기 설정에 주의를 기울여야 합니다. Django project를 구성하는 코드를 자동 생성해야 하는데, 이 과정에서 데이터베이스 설정, Django 위한 옵션들, 어플리케이션을 위한 설정들과 같은 Django 인스턴스를 구성하는 수많은 설정들이 생성되기 때문입니다.
\nFrom the command line, cd into a directory where you’d like to store your\ncode and create a new directory named djangotutorial. (This directory name\ndoesn’t matter to Django; you can rename it to anything you like.)
Linux / macOS
$ mkdir djangotutorial\nWindows
...\\> mkdir djangotutorial\nThen, run the following command to bootstrap a new Django project:
\nLinux / macOS
$ django-admin startproject mysite djangotutorial\nWindows
...\\> django-admin startproject mysite djangotutorial\nThis will create a project called mysite inside the djangotutorial\ndirectory. If it didn’t work, see django-admin을 실행하는 데 문제가 있습니다..
:djadmin:`startproject`에서 무엇이 생성되는지 확인해 봅시다.
\ndjangotutorial/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n asgi.py\n wsgi.py\n이 파일들은,
\nmanage.py: Django 프로젝트와 다양한 방법으로 상호작용 하는 커맨드라인의 유틸리티 입니다. manage.py 에 대한 자세한 정보는 django-admin and manage.py 에서 확인할 수 있습니다.
mysite/: A directory that is the actual Python package for your\nproject. Its name is the Python package name you’ll need to use to import\nanything inside it (e.g. mysite.urls).
mysite/__init__.py: Python으로 하여금 이 디렉토리를 패키지처럼 다루라고 알려주는 용도의 단순한 빈 파일입니다. Python 초심자라면, Python 공식 홈페이지의 패키지를 읽어보세요.
mysite/settings.py: 현재 Django 프로젝트의 환경 및 구성을 저장합니다. Django settings에서 환경 설정이 어떻게 동작하는지 확인할 수 있습니다.
mysite/urls.py: 현재 Django project 의 URL 선언을 저장합니다. Django 로 작성된 사이트의 “목차” 라고 할 수 있습니다. URL dispatcher 에서 URL 에 대한 자세한 내용을 읽어보세요.
mysite/asgi.py: 현재 프로젝트를 서비스하기 위한 ASGI-호환 웹 서버의 진입점입니다. 자세한 내용은 ASGI를 사용하여 배포하는 방법 를 참조하십시오.
mysite/wsgi.py: 현재 프로젝트를 서비스하기 위한 WSGI 호환 웹 서버의 진입점입니다. WSGI를 사용하여 배포하는 방법를 읽어보세요.
Let’s verify your Django project works. Change into the djangotutorial\ndirectory, if you haven’t already, and run the following commands:
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\n커맨드라인에서 다음과 같은 출력을 볼 수 있습니다.
\nPerforming system checks...\n\nSystem check identified no issues (0 silenced).\n\nYou have unapplied migrations; your app may not work properly until they are applied.\nRun 'python manage.py migrate' to apply them.\n\n2026년 08월 09일 - 15:50:53\nDjango version 5.1, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.\n\n
이제 서버가 실행 중이니 웹 브라우저의 http://127.0.0.1:8000/ 를 통해 접속할 수 있습니다. 여러분은 로켓이 이륙하는 “Congratulations!” 페이지가 보일 것입니다. 잘 동작하네요!
\nDjango 개발 서버를 시작했습니다. 개발 서버는 순수 Python으로 작성된 경량 웹 서버입니다. 운영 준비가 될 때까지 Apache와 같은 운영 서버를 구성할 필요 없이 신속하게 개발할 수 있도록 Django에 포함했습니다.
\n이쯤에서 하나 기억할 것이 있습니다. 이 서버를 운영 환경과 유사한 환경에서 사용하지 마십시오. 개발 중에만 사용할 수 있도록 되어 있습니다. (우리는 웹 서버가 아닌 웹 프레임워크를 만드는 사업을 하고 있습니다.)
\n(To serve the site on a different port, see the runserver reference.)
이제, 작업을 시작하기 위해 당신의 환경(프로젝트)이 설치되었습니다.
\nDjango에서 당신이 작성하는 각 어플리케이션들은 다음과 같은 관례로 Python 패키지가 구성됩니다. Django 는 앱(app) 의 기본 디렉토리 구조를 자동으로 생성할 수 있는 도구를 제공하기 때문에, 코드에만 더욱 집중할 수 있습니다.
\n\nYour apps can live anywhere in your Python path. In\nthis tutorial, we’ll create our poll app inside the djangotutorial folder.
앱을 생성하기 위해 manage.py가 존재하는 디렉토리에서 다음의 명령을 입력해 봅시다.
Linux / macOS
$ python manage.py startapp polls\nWindows
...\\> py manage.py startapp polls\n그러면 디렉토리 :file:`polls`가 생성되며, 이 디렉토리는 다음과 같이 배치됩니다.
\npolls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n views.py\n이 디렉토리 구조는 투표 어플리케이션의 집이 되어줄 것입니다.
\n첫 번째 뷰를 작성해봅시다. “polls/view.py”를 열어 다음과 같은 파이썬 코드를 입력합니다
\npolls/views.pyfrom django.http import HttpResponse\n\n\ndef index(request):\n return HttpResponse("Hello, world. You're at the polls index.")\nThis is the most basic view possible in Django. To access it in a browser, we\nneed to map it to a URL - and for this we need to define a URL configuration,\nor “URLconf” for short. These URL configurations are defined inside each\nDjango app, and they are Python files named urls.py.
To define a URLconf for the polls app, create a file polls/urls.py\nwith the following content:
polls/urls.pyfrom django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n path("", views.index, name="index"),\n]\nYour app directory should now look like:
\npolls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n urls.py\n views.py\nThe next step is to configure the global URLconf in the mysite project to\ninclude the URLconf defined in polls.urls. To do this, add an import for\ndjango.urls.include in mysite/urls.py and insert an\ninclude() in the urlpatterns list, so you have:
mysite/urls.pyfrom django.contrib import admin\nfrom django.urls import include, path\n\nurlpatterns = [\n path("polls/", include("polls.urls")),\n path("admin/", admin.site.urls),\n]\nThe path() function expects at least two arguments:\nroute and view.\nThe include() function allows referencing other URLconfs.\nWhenever Django encounters include(), it chops off whatever\npart of the URL matched up to that point and sends the remaining string to the\nincluded URLconf for further processing.
include()에 숨은 아이디어 덕분에 URL을 쉽게 연결할 수 있습니다. polls 앱에 그 자체의 URLconf(polls/urls.py)가 존재하는 한, “/polls/”, 또는 “/fun_polls/”, “/content/polls/”와 같은 경로, 또는 그 어떤 다른 root 경로에 연결하더라도, 앱은 여전히 잘 동작할 것입니다.
이제 index 뷰가 URLconf에 연결되었습니다. 잘 작동하는지 확인하기 위해 다음 명령을 입력해 보세요.
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\n브라우저에서 http://localhost:8000/polls/를 입력하면 index 뷰에 정의한 “Hello, world. You’re at the polls index.” 가 보일 것입니다.
request 와 response 의 기본 흐름을 이해하셨다면, 튜토리얼 2장 에서 데이터베이스 작업을 시작해보세요.
\n