Как установить Django¶
Этот документ призван проинструктировать вас о том, как получить и запустить Django.
Установка Python¶
Django — это веб-фреймворк Python. Подробности смотрите в Какие версии Python можно использовать с Django?.
Последнюю версию Python можно скачать на https://www.python.org/downloads/ или используя пакетный менеджер вашей операционной системы.
Python на Windows
Если вы только начали изучать Django и используете Windows, советуем почитать Как установить Django на Windows.
Установка Apache и mod_wsgi¶
Если вы просто хотите поэкспериментировать с Django, пропустите этот раздел и перейдите к следующему; Django включает в себя легковесный web-сервер, предназначенный для тестирования, поэтому вы вправе не устанавливать Apache до тех пор, пока ваш проект не будет готов для развёртывания на «боевом»-сервере.
Если вы хотите использовать Django на рабочем сайте, используйте Apache с mod_wsgi. mod_wsgi работает в одном из двух режимов: встроенном режиме или режиме демона. Во встроенном режиме mod_wsgi аналогичен mod_perl — он встраивает Python в Apache и загружает код Python в память при запуске сервера. Код остается в памяти на протяжении всего времени существования процесса Apache, что приводит к значительному увеличению производительности по сравнению с другими серверными конфигурациями. В режиме демона mod_wsgi запускает независимый процесс-демон, который обрабатывает запросы. Процесс-демон может запускаться от имени другого пользователя, чем веб-сервер, что может привести к повышению безопасности. Процесс демона можно перезапустить без перезапуска всего веб-сервера Apache, что, возможно, упростит обновление вашей кодовой базы. Обратитесь к документации mod_wsgi, чтобы определить, какой режим подходит для вашей установки. Убедитесь, что у вас установлен Apache с активированным модулем mod_wsgi. Django будет работать с любой версией Apache, поддерживающей mod_wsgi.
См. Использование Django и mod_wsgi для получения информации о настройке mod_wsgi сразу после того, как он будет установлен.
Если по какой-либо причине вы не можете использовать mod_wsgi, не волнуйтесь: Django поддерживает множество других вариантов развёртывания. Один из них – uWSGI; он отлично работает с nginx . Дополнительно Django следует WSGI спецификации (PEP 3333), которая позволяет ему работать на различных серверных платформах.
Создание рабочей базы данных¶
Если вы планируете использовать функционал API баз данных Django, вам нужно удостовериться, что сервер баз данных запущен. Django поддерживает много различных СУБД. В частности к ним относятся PostgreSQL, MySQL, Oracle и SQLite.
Если вы заняты разработкой простого проекта или чего-то, что вы не планируете развернуть в производственной среде, SQLite в целом является наипростейшим вариантом, поскольку он вообще не требует установки отдельного веб-сервера. Однако, SQLite очень отличается от других баз данных, поэтому, если вы работаете над чем-то существенным, рекомендуется выбрать ту же базу данных, которая будет использована на «боевом» сервере.
В дополнение к официально поддерживаемым базам данных есть бэкэнды, поставляемые третьими сторонами, которые позволяют использовать другие БД с Django.
Чтобы использовать другую базу данных, отличную от SQLite, вам необходимо убедиться, что установлены соответствующие привязки базы данных Python:
Если вы используете PostgreSQL, вам понадобится пакет psycopg или psycopg2. Дополнительную информацию можно найти в Заметках о PostgreSQL.
При использовании MySQL вам понадобится DB API драйвер, такой как
mysqlclient. Обратитесь к заметкам о MySQL для информации.Если вы используете SQLite, вам следует прочитать про особенности использования SQLite.
Если вы используете Oracle, вам необходимо установить oracledb, но, пожалуйста, прочтите примечания к серверной части Oracle для получения подробной информации о поддерживаемых версиях Oracle и
oracledb.При использовании неофициальных бэкендов от сторонних разработчиков смотрите соответствующую документацию о дополнительных требованиях.
И убедитесь, что следующие ключи в элементе 'default' словаря DATABASES соответствуют настройкам подключения к вашей базе данных:
ENGINE– Либо'django.db.backends.sqlite3','django.db.backends.postgresql','django.db.backends.mysql'или'django.db.backends.oracle'. Другие серверные части также доступны.NAME– Имя вашей базы данных. Если вы используете SQLite, база данных будет представлять собой файл на вашем компьютере. В этом случаеNAMEдолжен быть полным абсолютным путем, включая имя этого файла. Вам не нужно ничего создавать заранее; файл базы данных будет создан автоматически при необходимости. Значение по умолчанию, ``BASE_DIR/“db.sqlite3“`, сохранит файл в каталоге вашего проекта.
Для баз данных, отличных от SQLite
Если вы не используете SQLite в качестве базы данных, необходимо добавить дополнительные настройки, такие как USER, PASSWORD и HOST. Более подробную информацию см. в справочной документации по DATABASES.
Также убедитесь, что к этому моменту вы создали базу данных. Сделайте это с помощью «CREATE DATABASE имя_базы_данных;» в интерактивном приглашении вашей базы данных.
Если вы планируете использовать команду manage.py migrate для автоматической генерации таблиц БД для ваших моделей (после первого запуска Django и создания проекта), вам нужно убедиться, что Django имеет разрешение на создание и изменение таблиц БД; если же вы хотите создавать таблицы вручную, вам надо просто предоставить Django разрешения SELECT, INSERT, UPDATE и DELETE. После создания пользователя БД с указанными привилегиями, вам понадобится изменить настройки вашего проекта, см. DATABASES.
Если вы используете среду тестирования Django для проверки запросов к базе данных, Django понадобится разрешение на создание тестовой БД.
Установка Django¶
Инструкции по установке несколько различаются в зависимости от того, каким способом вы устанавливаете пакет: установка для конкретного дистрибутива, загрузка последней официальной версии или получение текущей разрабатываемой версии.
Установка официальной версии с помощью pip¶
Это рекомендуемый способ установки Django.
Установите pip. Самым простым способом сделать это является использование автономного установщика pip. Если ваш дистрибутив уже включает установленную версию
pip, возможно, вам потребуется обновить её до более свежей. (Если версия устарела, вы сразу поймёте это, поскольку установка не будет работать.)Взгляните на venv. Этот инструмент предоставляет изолированные среды Python, что более практично, чем установка пакетов по всей системе. Он также позволяет устанавливать пакеты без прав администратора. В руководстве по участию рассказывается, как создать виртуальную среду.
После того, как вы создали и активировали виртуальное окружение, выполните в консоли
pip install Django.$ python -m pip install Django
...\> py -m pip install Django
Установка пакета для конкретного дистрибутива¶
Проверьте наличие готового пакета, если ваша операционная система предоставляет возможность получить пакет/установщик Django. Как правило, этот способ удобен автоматическим разрешением зависимостей и обновлением версии Django. Однако эти пакеты редко содержат последний релиз Django.
Установка разрабатываемой версии¶
Следим за разработкой Django
Если вы приняли решение использовать текущую разрабатываемую версию Django, вам нужно следить за информацией о выпуске новых исправлений на the development timeline. Это поможет вам оставаться в курсе происходящих изменений , таких как включение новой функциональности. Для получения изменений вы должны будете обновить вашу копию Django. (Для стабильных релизов, все необходимые изменения описаны в примечаниях к выпуску.)
Если вы хотите обновить Django до разрабатываемой версии, чтобы иметь возможность использовать последние, возможно, нестабильные изменения и улучшения, следуйте этой инструкции:
Убедитесь, что у вас установлен Git и вы можете запустить его из командной оболочки. (Введите
git helpв командной оболочке, чтобы проверить это.)Склонируйте разрабатываемую ветку Django вот так:
$ git clone https://github.com/django/django.git
...\> git clone https://github.com/django/django.gitЭта команда создаст каталог
djangoв вашей текущей директории.Убедитесь, что интерпретатор Python может загрузить код Django. Самый удобный способ сделать это — использовать виртуальную среду и pip. В руководстве по участию рассказывается, как создать виртуальную среду.
После настройки и активации виртуальной среды выполните следующую команду:
$ python -m pip install -e django/
...\> py -m pip install -e django\Это сделает код Django импортируемым, а также сделает доступным запуск
django-admin.py. Иначе говоря, всё готово!
Когда вам понадобится обновить вашу копию Django, просто запустите команду git pull в директории django.После того, как вы сделаете это, Git автоматически загрузит изменения.