Створення нового проєкту Django

Проєкт Django — це основа твого застосунку. Він містить усю конфігурацію, яка знадобиться для запуску твого веб-застосунку. Проєкт складається з набору файлів та папок, які надає Django, щоб спростити розробку та структурування застосунку. Всередині проєкту ти будеш розміщувати свої застосунки-к-django (apps) (про них пізніше), які вже містять функціонал твого веб-сайту.

Уяви проєкт як коробку, а застосунки всередині — як деталі конструктора, які ти можеш збирати та змінювати.

Основи створення проєкту в Django

Django постачається з утилітою django-admin, яка значно спрощує створення базової структури проєкту.

Крок 1: Активуємо віртуальне оточення

Перш ніж приступати до створення проєкту, нам потрібно переконатися, що активоване віртуальне оточення. Нагадую, що це ізольований простір для нашого Python-коду та бібліотек.

# На Windows
venv\Scripts\activate

# На macOS/Linux
source venv/bin/activate

Коли віртуальне оточення увімкнено, ти маєш побачити щось на кшталт venv перед командним рядком. Якщо його немає, варто повернутися до лекції про віртуальні оточення.

Крок 2: Використовуємо команду startproject

Тепер час використати суперсилу Django — команду startproject, щоб створити проєкт. У терміналі введи наступну команду:

django-admin startproject mysite

Ця команда створить базову структуру проєкту під назвою mysite (можна вибрати іншу назву, якщо хочеш). Після виконання команди має з'явитися папка mysite.

Крок 3: Зазирнемо всередину структури проєкту

Давай подивимося, які файли та папки з'явилися в твоєму проєкті:

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

Пояснення файлів та папок

• mysite/: коренева папка проєкту.
• manage.py: головний скрипт для керування проєктом. З його допомогою ми будемо запускати сервер, створювати додатки, виконувати міграції та багато іншого.
• mysite/ (вкладена папка): тут знаходиться конфігурація проєкту.
  • init.py: порожній файл, який вказує Python, що ця папка — модуль.
  • settings.py: головний файл налаштувань проєкту. Саме тут ми будемо вказувати базу даних, підключати додатки, налаштовувати статичні файли та багато іншого.
  • urls.py: файл маршрутів. У ньому будемо зв'язувати URL-адреси з їх обробниками (представленнями).
  • asgi.py: налаштування для асинхронного інтерфейсу сервера та додатків (ASGI). Це потрібно для роботи з асинхронними запитами.
  • wsgi.py: налаштування для інтерфейсу сервера та додатків (WSGI). Це стандарт для розгортання Django-додатків на продакшені.

Проєкт Django мало чим відрізняється від креслення: він задає структуру, а ми будемо додавати до нього функціональність на наступних етапах.

Перевірка працездатності проєкту

Чудово, проєкт створено. Давай переконаємось, що він працює: запустимо сервер розробки.

Використовуй наступну команду:

python manage.py runserver

Після цього у терміналі ти побачиш щось типу:

Watching for file changes with StatReloader
Performing system checks...

Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Тепер відкрий браузер і перейди за адресою http://127.0.0.1:8000/. Якщо все пройшло успішно, ти побачиш стандартну сторінку привітання Django зі словами "The install worked successfully! Congratulations!"

Що тут відбувається? Коли ми запускаємо сервер розробки, Django починає слухати локальну адресу (у цьому випадку 127.0.0.1, це ж localhost) на порту 8000 за замовчуванням. Таким чином, ми можемо тестувати додаток на локальній машині. Ура! Перший дзвіночок успіху!

Налаштування проєкту після створення

Тепер, коли проєкт працює, давай трохи його налаштуємо.

Зміна settings.py

Завдання TIME_ZONE Відкрий файл mysite/settings.py і знайди змінну TIME_ZONE. Встанови значення свого часового поясу. Наприклад, для Молдови використовуй:

TIME_ZONE = 'Europe/Chisinau'

Підказка: якщо не впевнений у назві зони, всі доступні значення можна знайти у списку часових зон.

Додавання LANGUAGE_CODE Подібним чином ми можемо задати мову проєкту:

LANGUAGE_CODE = 'uk-ua'

Ці зміни допоможуть коректно відображати час і форматувати дані у додатку.

Робота з manage.py

manage.py — це наш "швейцарський ніж" для керування проєктом. Ось кілька корисних команд, які тобі знадобляться на початковому етапі:

• runserver: запускає сервер розробки.
• startapp: створює новий додаток (майже як startproject, але для додатків).
• makemigrations і migrate: робота з базою даних (про міграції розкажемо детальніше пізніше).
• shell: відкриває інтерактивний Python-інтерпретатор із попередньо завантаженими налаштуваннями проєкту.

Типові помилки при створенні проєкту

1. Помилка команди django-admin: якщо термінал видає помилку типу command not found, швидше за все, Django не встановлений або віртуальне середовище не активоване. Повернись і перевір кроки встановлення.

2. Проєкт із такою назвою вже існує: якщо ти намагаєшся створити проєкт із назвою, яка вже використовується на твоєму комп'ютері, зміни назву проєкту.

3. Запуск сервера на зайнятому порту: якщо при запуску сервера видається помилка "Port 8000 is already in use", спробуй вказати інший порт:
   

   python manage.py runserver 8080
   

Практичне завдання

1. Створіть проєкт Django з назвою mysite.
2. Запустіть сервер розробки та відкрийте http://127.0.0.1:8000/ у браузері.
3. Спробуйте змінити параметр TIME_ZONE у settings.py на відповідний для твого регіону і перевір, що зміни набули чинності.
4. Вимкніть і знову активуйте віртуальне середовище, щоб закріпити навичку роботи з ним.