Как установить Django
Этот документ поможет вам начать работу с Django.
Установка Python
Django — это фреймворк для веб-приложений на Python. Подробности см. в Какой версии Python можно использовать с Django?.
Получите последнюю версию Python по адресу https://www.python.org/downloads/ или с помощью менеджера пакетов вашей операционной системы.
Python в Windows
Если вы только начинаете работать с Django и используете Windows, вам может быть полезно Как установить Django в Windows.
Установка Apache и mod_wsgi
Если вы хотите просто поэкспериментировать с Django, переходите к следующему разделу; Django включает в себя лёгкий веб-сервер, который можно использовать для тестирования, поэтому вам не нужно устанавливать Apache, пока вы не готовы развернуть Django в рабочей среде.
Если вы хотите использовать 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, MariaDB, MySQL, Oracle и SQLite.
Если вы разрабатываете небольшой проект или проект, который вы не планируете развертывать в рабочей среде, SQLite обычно является лучшим вариантом, поскольку он не требует запуска отдельного сервера. Однако SQLite имеет много отличий от других баз данных, поэтому если вы работаете над чем-то существенным, рекомендуется разрабатывать с той же базой данных, которую вы планируете использовать в рабочей среде.
В дополнение к официально поддерживаемым базам данных существуют бекенды, предоставляемые третьими сторонами, которые позволяют использовать другие базы данных с Django.
Чтобы использовать базу данных, отличную от SQLite, вам необходимо убедиться, что установлены соответствующие привязки Python для базы данных:
- Если вы используете PostgreSQL, вам потребуется пакет psycopg или psycopg2. Дополнительные сведения см. в Примечания к PostgreSQL.
- Если вы используете MySQL или MariaDB, вам понадобится драйвер 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 database_name;» в интерактивном приглашении вашей базы данных.
Если вы планируете использовать команду Django manage.py migrate для автоматического создания таблиц базы данных для ваших моделей (после первоначальной установки Django и создания проекта), вам нужно убедиться, что Django имеет разрешение на создание и изменение таблиц в используемой базе данных; если вы планируете создавать таблицы вручную, вы можете предоставить Django разрешения SELECT, INSERT, UPDATE и DELETE. После создания пользователя базы данных с этими разрешениями вы укажете подробности в файле настроек вашего проекта, см. DATABASES для получения подробностей.
Если вы используете фреймворк тестирования Django для тестирования запросов к базе данных, Django потребуется разрешение на создание тестовой базы данных.
Установка кода Django
Инструкции по установке немного отличаются в зависимости от того, устанавливаете ли вы пакет, специфичный для дистрибутива, загружаете последнюю официальную версию или получаете последнюю версию разработки.
Установка официальной версии с pip
Это рекомендуемый способ установки Django.
- Установите pip. Самый простой способ — использовать установщик pip. Если ваш дистрибутив уже имеет
pip, возможно, вам потребуется обновить его, если он устарел. Если он устарел, вы об этом узнаете, потому что установка не сработает. - Обратите внимание на venv. Этот инструмент предоставляет изолированные среды Python, которые более практичны, чем установка пакетов во всей системе. Он также позволяет устанавливать пакеты без привилегий администратора. В руководстве по сотрудничеству показано, как создать виртуальную среду.
-
После создания и активации виртуальной среды введите команду:
$ python -m pip install Django
...\> py -m pip install Django
Установка пакета, специфичного для дистрибутива
Проверьте заметки, специфичные для дистрибутива, чтобы увидеть, предоставляет ли ваша платформа/дистрибутив официальные пакеты/инсталляторы Django. Пакеты, предоставляемые дистрибутивом, обычно позволяют автоматически устанавливать зависимости и поддерживать пути обновления; однако эти пакеты редко содержат последнюю версию Django.
Установка версии разработки
Отслеживание разработки Django
Если вы решите использовать последнюю версию разработки Django, вы должны внимательно следить за графиком разработки, а также за примечаниями к выпуску предстоящей версии. Это поможет вам следить за новыми функциями, которые вы могли бы использовать, а также за изменениями, которые вам нужно будет внести в свой код при обновлении вашей копии 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. Другими словами, вы всё сделали правильно!
При желании обновить свою копию исходного кода Django, выполните команду git pull в директории django. При этом Git загрузит все изменения.
© Django Software Foundation and individual contributors
Licensed under the BSD License.
https://docs.djangoproject.com/en/5.2/topics/install/
