첫 번째 장고 앱 작성하기, part 1Link to this heading#

프로젝트 만들기Link to this heading#

Django를 처음 사용한다면, 초기 설정에서 주의를 기울여야 합니다. 즉, Django project 를 구성하는 코드를 자동 생성해야 하는데, 이 과정에서 데이터베이스 설정, Django 위한 옵션들, 어플리케이션을 위한 설정들과 같은 Django 인스턴스를 구성하는 수많은 설정들이 생성되기 때문입니다.

커맨드라인에서 cd 명령으로 코드를 저장할 디렉토리로 이동 한 후, 다음의 명령을 수행합니다.

$ django-admin startproject mysite

이 명령은 현재 디렉토리에서 mysite 라는 디렉토리를 생성할 것입니다. 만약 이 명령이 동작하지 않는다면, Problems running django-admin 를 확인하세요

startproject 에서 무엇이 생성되는지 확인해 봅시다.

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        wsgi.py

이 파일들은,

• mysite/ 디렉토리 바깥의 디렉토리는 단순히 프로젝트를 담는 공간입니다. 이 이름은 Django 와 아무 상관이 없으니, 원하는 이름으로 변경하셔도 됩니다.

• manage.py: Django 프로젝트와 다양한 방법으로 상호작용 하는 커맨드라인의 유틸리티 입니다. manage.py 에 대한 자세한 정보는 django-admin and manage.py 에서 확인할 수 있습니다.

• mysite/ 디렉토리 내부에는 project 를 위한 실제 Python 패키지들이 저장됩니다. 이 디렉토리 내의 이름을 이용하여, (mysite.urls 와 같은 식으로) project 어디서나 Python 패키지들을 import 할 수 있습니다.

• mysite/__init__.py: Python 으로 하여금 이 디렉토리를 패키지 처럼 다루라고 알려주는 용도의 단순한 빈 파일입니다. Python 초심자라면, Python 공식 홈페이지의 more about packages 를 읽어보십시요.

• mysite/settings.py: 현재 Django project 의 환경/구성을 저장합니다. Django settings 에서 환경 설정이 어떻게 동작하는지 확인할 수 있습니다.

• mysite/urls.py: 현재 Django project 의 URL 선언을 저장합니다. Django 로 작성된 사이트의 “목차” 라고 할 수 있습니다. URL dispatcher 에서 URL 에 대한 자세한 내용을 읽어보세요.

• mysite/wsgi.py: 현재 project 를 서비스 하기 위한 WSGI 호환 웹 서버의 진입점 입니다. How to deploy with WSGI 를 읽어보세요.

개발 서버Link to this heading#

당신의 Django project 가 제대로 동작하는지 확인해 봅시다. mysite 디렉토리로 이동하고, 다음 명령어를 입력하십시요.

$ python manage.py runserver

커맨드라인에서 다음과 같은 출력을 볼 수 있습니다.

Performing system checks...

System check identified no issues (0 silenced).

You have unapplied migrations; your app may not work properly until they are applied.
Run 'python manage.py migrate' to apply them.

2026년 08월 09일 - 15:50:53
Django version 1.11, using settings 'mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Django 개발 서버를 시작했습니다. 개발 서버는 순수 Python 으로 작성된 경량 웹 서버입니다. Django 에 포함되어 있기 때문에 아무 설정없이 바로 개발에 사용할 수 있습니다.

이쯤에서 하나 기억할 것이 있습니다. 절대로 개발 서버를 운영 환경에서 사용하지 마십시요. 개발 서버는 오직 개발 목적으로만 사용하여야 합니다. (우리는 웹 프레임워크를 만들지 웹 서버를 만들지는 않거든요)

이제 서버가 동작하기 시작했으니, 웹 브라우져에서 http://127.0.0.1:8000/ 를 통해 접속할 수있습니다. 파스텔톤의 밝은 파란색의 따뜻한 “Welcome to Django” 환영 페이지를 볼 수 있을 것입니다. 잘 동작 하네요!

설문조사 앱 만들기Link to this heading#

이제, 작업을 시작하기 위해 당신의 환경(project) 이 설치되었습니다.

Django 에서 당신이 작성하는 각 어플리케이션들은 다음과 같은 관례로 Python 패키지가 구성됩니다. Django 는 앱(app) 의 기본 디렉토리 구조를 자동으로 생성할 수 있는 도구를 제공하기 때문에, 코드에만 더욱 집중할 수 있습니다.

당신의 app 은 Python 경로 어디라도 있을 수 있습니다. 그러나 이 예제에서는, mysite 같은 submodule 말고, top-level 에서 곧바로 import 할 수 있게 끔 manage.py 바로 옆에 생성해 보도록 하겠습니다.

app 을 생성하기 위해 manage.py 가 존재하는 디렉토리에서 다음의 명령을 입력해 봅시다.

$ python manage.py startapp polls

polls 라는 디렉토리가 생겼습니다. 이걸 펼쳐놓으면 아래와 같습니다.

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py

이 디렉토리 구조는 poll 어플리케이션의 집이 되어줄 것입니다.

첫 번째 뷰 작성하기Link to this heading#

첫 번째 뷰를 작성해봅시다. “polls/view.py”를 열어 다음과 같은 파이썬 코드를 입력합니다

from django.http import HttpResponse


def index(request):
    return HttpResponse("Hello, world. You're at the polls index.")

Django 에서 가장 간단한 형태의 view 입니다. view 를 호출하려면 이와 연결된 URL 이 있어야 하는데, 이를 위해 URLconf 가 사용됩니다.

polls 디렉토리에서 URLconf 를 생성하려면, urls.py 라는 파일을 생성해야 합니다. 정확히 생성했다면, app 디렉토리는 다음과 같이 보일겁니다.:

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    urls.py
    views.py

“polls/urls.py” 파일에는 다음과 같은 코드가 포함되어 있습니다.

from django.conf.urls import url

from . import views

urlpatterns = [
    url(r'^$', views.index, name='index'),
]

다음 단계는, project 최상단의 URLconf 에서 polls.urls 모듈을 바라보게 설정합니다. mysite/urls.py 파일을 열고, django.conf.urls.include 를 import 하십시요. 그리고 urlpatterns 리스트에 include() 함수를 다음과 같이 추가합니다.

from django.conf.urls import include, url
from django.contrib import admin

urlpatterns = [
    url(r'^polls/', include('polls.urls')),
    url(r'^admin/', admin.site.urls),
]

include() 함수는 다른 URLconf 를 참조할 수 있도록 도와줍니다. include() 함수를 위한 정규 표현식에서 끝을 의미하는 기호로 $ 대신 슬래시(/) 가 붙는다는 점을 기억하십시요. Django 가 include() 를 만나게 되면, 그 시점까지 일치하는 URL 의 부분을 잘라내고, 남은 부분을 후속 처리를 위해 include 된 URLconf 로 전달합니다. 즉, /polls/some/method 를 요청받으면, some/method 가 polls/urls.py 의 URLconf 로 넘어갑니다.

include() 에 숨은 아이디어 덕분에, URL 을 쉽게 연결할 수 있습니다(plug-and-ply). polls 앱에 자체적인 URLconf(polls/urls.py) 가 존재하는 한, “/polls/”, 혹은 “/fun_polls/”, 혹은 “/content/polls/” 같은 그 어떤 경로에 붙이더라도 app 은 여전히 잘 동작할 것입니다.

이제 index view 가 URLconf 에서 연결되었습니다. 잘 작동하는지 확인하기 위해 다음을 입력해 보세요.

$ python manage.py runserver

브라우저에서 http://localhost:8000/polls/ 를 입력하면 index view 로 정의한 “Hello, world. You’re at the polls index.” 가 보일 것입니다.

url() 함수에는 4 개의 인수가 전달되었습니다. 두개의 필수 인수로 regex 와 view 가 있고, 두개의 옵션 인수로 kwargs 와 name 이 있습니다. 이 시점에서, 이 인수가 무엇인지 살펴보는것은 의미가 있습니다.