Начинаем работу с Django

Django — один из самых эффективных современных фреймворков для разработки веб-проектов. Сложно придумать что-то, позволяющее так же быстро реализовать портал или контентный проект, чем использовать Django. Причина подобной эффективности — четкий механизм работы с проектом, удобная ORM — система моделей для упрощения использования базы данных, встроенный функциональный движок шаблонов. Приведенная в статье информация актуальна для версии Django 1.5. Приступим.

Создание виртуального окружения

При работе над новым сайтом очень удобным инструментом являются виртуальные окружения. Виртуальное окружение — это независимый от установленных в системе набор библиотек, модулей и самого интерпретатора Python, которые используются при работе с текущим проектом. Создаем виртуальное окружение командой

mkvirtualenv mysite

Эта команда создаст и активирует виртуальное окружение с названием mysite. В дальнейшем активируйте его командой

workon mysite

Установка Django

Установка Django очень проста. Чтобы установить последнюю версию Django, выполните команду

pip install django

Создание проекта

Создание проекта выполняется командой

django-admin.py startproject mysite

В результате выполнения команды в текущем каталоге будет создан каталог mysite, в котором будет размещены manage.py — скрипт для управления Django-проектом и каталог mysite, содержащий файлы

__init__.py
settings.py
urls.py
wsgi.py

Структура проекта Django

Верхний каталог mysite/ созданный командой startproject, никак не используется Django и не прописан в файлах конфигурации. Вы можете свободно переименовать его и сайт будет работать как и раньше.

manage.py - Это скрипт для запуска различных команд Django. Например, с его помощью можно запустить тестовый веб-сервер или создать нужные для работы проекта таблицы в базе данных.

Внутренний каталог mysite/ — это пакет Python, созданный Django для вашего проекта. Его имя нужно указывать для импорта находящихся в нем файлов. Напрмер, для импорта настроек проекта нужно указать import mysite.settings.

mysite/__init__.py: — пустой файл, указывающий на то, что каталог является пакетом Python.

mysite/settings.py

mysite/urls.py: —

mysite/wsgi.py: — начальная точка для запуска сайта веб-сервером.

При создании в дальнейшем с помощью startapp приложений, работающих в рамках сайта, для каждого из них будет создан отдельный каталог в верхнем mysite.

Запуск веб-сервера для разработки

Django предоставляет удобный механизм, позволяющий при разработке веб-сайта не заниматься настройкой веб-сервера. В состав Django уже включен веб-сервер, который вызывается командой

python manage.py runserver

После запуска этой команды в консоли из каталога проекта и перехода по адресу http://127.0.0.1:8000/ вы увидите следующий вывод:

Это означает, что все работает правильно и можно продолжать работу над проектом.

Настройка базы данных

Запустить сайт на базе Django можно и без базы данных. Но в реальном проекте без нее не обойтись.

Для настройки базы данных в начале разработки проще всего использовать SQLite3. Сама база при этом хранится в одном файле на диске. SqLite не стоит использовать в рабочих сайтах с реальной нагрузкой, но вполне можно для тестирования и разработки функционала.

Для подключения базы данных к Django проекту отредактируйте в файле mysite/settings.py блок DATABASES

Чтобы использовать sqlite, достаточно указать django.db.backends.sqlite3 в качестве ENGINE и прописать имя файла, в котором будет хранится база, в параметре NAME.

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3', 
        'NAME': 'mysite.db',                      
        'USER': '',                      # Not used with sqlite3.
        'PASSWORD': '',                  # Not used with sqlite3.
        'HOST': '',                      # Set to empty string for localhost. Not used with sqlite3.
        'PORT': '',                      # Set to empty string for default. Not used with sqlite3.
    }
}

Настройка временной зоны

Для указания в Django правильной временной зоны нужно отредактировать параметр TIME_ZONE.

Открываем в браузере http://en.wikipedia.org/wiki/List_of_tz_zones_by_name, выбираем ту зону, в которой будет находится ваш сервер и копируем в settings.py

Для Украины я использовал Europe/Kiev

Приложения Django

Мы уже создали наш проект, зачем нам еще нужны приложения?

Приложение создается для выполения определенной специфической задачи.

В свою очередь, проект — набор приложений, полностью реализующих работу сайта.

Например, реализуя сайт крупной туристической компании, мы можем добавить в наш проект отдельное приложение, отдельное — для блога, и дополнительное приложение для каталога стран или туров.

Для начала работы с Django мы создадим сайт, позволяющий создавать опросы.

Создадим приложение, которое будет отвечать работе опросов с названием polls:

python manage.py startapp polls

В появившемся каталоге pools мы увидим

__init__.py
    models.py
    tests.py
    views.py

Модели Django

Модель полностью определяет данные, с которыми нам нужно работать, и предоставляет методы по работе с ними в приложении. Django ORM позволяет в простых случаях полностью абстрагироваться от структуры базы данных, предоставив самой Django создать нужные нам таблицы, записывать в них информацию, которую мы сохраняем и находить то, что мы ищем.

В нашем простом приложении мы добавим две модели.

Poll — будет хранить в себе вопрос и дату публикации опроса.

Choice будет содержать вариант для голосования и счетчик голосов, отданных данному варианту. Каждый вариант будет привязан к какому-то вопросу.

Чтобы создать нужные нам структуры для хранения данных, нам нужно отредактировать файл polls/models.py и добавить в него следующий текст:

from django.db import models

class Poll(models.Model):
    question = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')

class Choice(models.Model):
    poll = models.ForeignKey(Poll)
    choice_text = models.CharField(max_length=200)
    votes = models.IntegerField(default=0)

Чтобы Django создала нужные для работы приложения таблицы в базе данных, нужно включить наше приложение в список INSTALLED_APPS файла settings.py. Отредактируйте файл и добавьте в конец списка ‘polls’,

INSTALLED_APPS = (
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.sites',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # Uncomment the next line to enable the admin:
    # 'django.contrib.admin',
    # Uncomment the next line to enable admin documentation:
    # 'django.contrib.admindocs',
    'polls',
)

Теперь Django знает о созданном вами приложении. Чтобы создать таблицы, выполните команду

python manage.py syncdb

После первого запуска syncdb вы должны увидеть следующее:

Creating tables ...
Creating table auth_permission
Creating table auth_group_permissions
Creating table auth_group
Creating table auth_user_groups
Creating table auth_user_user_permissions
Creating table auth_user
Creating table django_content_type
Creating table django_session
Creating table django_site
Creating table polls_poll
Creating table polls_choice

You just installed Django's auth system, which means you don't have any superusers defined.
Would you like to create one now? (yes/no):

django успешно создала все нужные таблицы для приложений, указанных в INSTALLED_APPS, и интересуется, нужно ли создать супер-пользователя, который будет управлять работой сайта через админку Django.

Давайте сделаем это!

Username (leave blank to use 'sharm'): admin
Email address: i@admin.com     
Password: 
Password (again): 
Superuser created successfully.
Installing custom SQL ...
Installing indexes ...
Installed 0 object(s) from 0 fixture(s)

Теперь давайте попробуем запустить наш проект и добавить в него немного данных.
Шаг 2 — запускаем первый проект на Django