Oefening: uw eerste project maken

Voltooid

Nu we enkele basisconcepten van Django hebben verkend, gaan we beginnen met het maken van het project.

Een project maken met Django-admin

Zoals eerder is gemarkeerd, is een Django-project de container voor ons hele project en alle toepassingen die we maken. We gaan ons project maken.

Voer in het terminalvenster in Visual Studio Code de volgende opdracht uit:

django-admin startproject helloproject .

Belangrijk

De afsluitende periode aan het einde van de opdracht is belangrijk. Het geeft django-admin aan om de huidige map te gebruiken. Als u de periode verlaat, wordt er een extra submap gemaakt.

Nadat u de voorgaande opdracht hebt uitgevoerd, moet het nieuwe project zich nu in de door u gekozen map bevinden. In dit geval ziet u een nieuwe map met de naam helloproject.

Projectstructuur verkennen

Nu het Django-project is gemaakt, kijken we naar de structuur om te zien wat er is opgenomen.

manage.py
helloproject/
    __init__.py
    asgi.py
    settings.py
    urls.py
    wsgi.py
  • Het opdrachtregelprogramma manage.py wordt gemaakt in elk Django-project. Het heeft dezelfde functie als django-admin. In het volgende voorbeeld ziet u hoe deze kan worden gebruikt als u zich in de projectmap bevindt en de beschikbare subopdrachten wilt zien.

    python manage.py help
    
  • helloproject wordt beschouwd als het Python-pakket voor uw project.

  • init.py is een leeg bestand waarmee Python kan worden verteld dat deze map moet worden beschouwd als een pakket.

  • settings.py bevat al uw instellingen of configuraties.

  • urls.py bevat de URL's in het project.

  • asgi.py en wsgi.py fungeren als toegangspunt voor uw webservers, afhankelijk van het type server dat wordt geïmplementeerd.

Het project uitvoeren

Nu Django is geïnstalleerd, is er een project gemaakt en we hebben de projectstructuur onderzocht, is het tijd om ervoor te zorgen dat ons project correct werkt.

  1. Voer in het terminalvenster in Visual Studio Code de volgende code in om de server te starten.

    python manage.py runserver
    

    Het project voert systeemcontroles uit en start de ontwikkelserver. Kopieer en plak de URL van uw ontwikkelserver, die moet zijn http://localhost:8000, in de browser van uw voorkeur. Je zou een Django Gefeliciteerd pagina moeten zien met een afbeelding van een raket die van start gaat.

  2. Stop de server tijdelijk, omdat we het project opnieuw moeten configureren. Selecteer Ctrl+C in het terminalvenster.

De Hallo wereld-app maken

We hebben de basisbeginselen van het Django-framework geleerd en de mapstructuur van ons project onderzocht. Nu is het tijd om onze eerste app te maken. De Hello, world! -app helpt u inzicht te krijgen in hoe apps worden gemaakt en hoe ze samenwerken met het Django-project.

Voer in het terminalvenster de volgende opdracht uit om de app te maken.

python manage.py startapp hello_world

Met deze opdracht maakt Django de vereiste mappen en bestanden. De volgende structuur moet nu zichtbaar zijn.

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

App registreren bij project

Omdat apps en projecten gescheiden zijn in Django, moet u uw app registreren bij het project. Dit wordt gedaan door de INSTALLED_APPS variabele in settings.py voor het project bij te werken, waarbij een verwijzing naar de configuratieklasse voor de app wordt toegevoegd. De configuratieklasse vindt u in apps.py en is dezelfde naam als het project. In ons voorbeeld krijgt de klasse de naam HelloWorldConfig.

  1. Open in helloproject settings.py.

  2. Zoek de lijst INSTALLED_APPS, die in regel 33 moet staan.

  3. Voeg het volgende toe aan het einde van de lijst, binnen de vierkante haken ([ ]):

    'hello_world.apps.HelloWorldConfig',
    
  4. De bijgewerkte INSTALLED_APPS lijst moet er als volgt uitzien:

    INSTALLED_APPS = [
        'django.contrib.admin',
        'django.contrib.auth',
        'django.contrib.contenttypes',
        'django.contrib.sessions',
        'django.contrib.messages',
        'django.contrib.staticfiles',
        'hello_world.apps.HelloWorldConfig',
    ]    
    
  5. Sla alle bestanden op door Bestand>opslaan te selecteren.

Gefeliciteerd. U hebt nu uw eerste Django-project en -app gemaakt. Vervolgens maakt u een pad en weergave om functionaliteit toe te voegen.