Detta dokument hjälper dig att komma igång med Django.
\nDjango är ett webbramverk i Python. Se Vilken Python-version kan jag använda med Django? för mer information.
\nHämta den senaste versionen av Python på https://www.python.org/downloads/ eller med ditt operativsystems pakethanterare.
\n\nmod_wsgiLink to this heading#Om du bara vill experimentera med Django kan du hoppa vidare till nästa avsnitt; Django innehåller en lättviktig webbserver som du kan använda för testning, så du behöver inte installera Apache förrän du är redo att distribuera Django i produktion.
\nOm du vill använda Django på en produktionssite ska du använda Apache med mod_wsgi. mod_wsgi fungerar i ett av två lägen: inbäddat läge eller daemonläge. I inbäddat läge liknar mod_wsgi mod_perl - det bäddar in Python i Apache och laddar Python-kod i minnet när servern startar. Koden stannar i minnet under hela Apache-processens livstid, vilket leder till betydande prestandavinster jämfört med andra serverarrangemang. I daemonläge skapar mod_wsgi en oberoende daemonprocess som hanterar förfrågningar. Daemonprocessen kan köras som en annan användare än webbservern, vilket eventuellt kan leda till förbättrad säkerhet. Daemonprocessen kan startas om utan att hela Apache-webbservern startas om, vilket kan göra uppdateringen av din kodbas mer sömlös. Se dokumentationen för mod_wsgi för att avgöra vilket läge som är rätt för din installation. Se till att du har Apache installerat med mod_wsgi-modulen aktiverad. Django kommer att fungera med alla versioner av Apache som stöder mod_wsgi.
\nSe Hur man använder Django med mod_wsgi för information om hur man konfigurerar mod_wsgi när man har installerat det.
\nOm du av någon anledning inte kan använda mod_wsgi, var inte orolig: Django stöder många andra distributionsalternativ. Ett är uWSGI; det fungerar mycket bra med nginx. Dessutom följer Django WSGI-specifikationen (PEP 3333), vilket gör att den kan köras på en mängd olika serverplattformar.
\nOm du planerar att använda Djangos databas-API-funktionalitet måste du se till att en databasserver körs. Django stöder många olika databasserver och stöds officiellt med PostgreSQL, MariaDB, MySQL, Oracle och SQLite.
\nOm du utvecklar ett litet projekt eller något som du inte planerar att distribuera i en produktionsmiljö är SQLite i allmänhet det bästa alternativet eftersom det inte kräver att du kör en separat server. SQLite har dock många skillnader jämfört med andra databaser, så om du arbetar med något stort rekommenderar vi att du utvecklar med samma databas som du planerar att använda i produktionen.
\nUtöver de databaser som stöds officiellt finns det backends som tillhandahålls av tredje part som gör att du kan använda andra databaser med Django.
\nOm du vill använda en annan databas än SQLite måste du se till att lämpliga Python-databasbindningar är installerade:
\nOm du använder PostgreSQL behöver du paketet psycopg eller psycopg2. Se PostgreSQL notes för ytterligare information.
Om du använder MySQL eller MariaDB behöver du en DB API-drivrutin som mysqlclient. Se notes for the MySQL backend för mer information.
Om du använder SQLite kanske du vill läsa SQLite backend notes.
Om du använder Oracle måste du installera oracledb, men läs notes for the Oracle backend för information om vilka versioner av både Oracle och oracledb som stöds.
Om du använder en inofficiell backend från tredje part, se den dokumentation som tillhandahålls för eventuella ytterligare krav.
Och se till att följande nycklar i 'default' i DATABASES-ordlistan stämmer överens med dina inställningar för databasanslutning:
ENGINE – Antingen 'django.db.backends.sqlite3', 'django.db.backends.postgresql', 'django.db.backends.mysql', eller 'django.db.backends.oracle'. Andra backends är också tillgängliga.
NAME – Namnet på din databas. Om du använder SQLite kommer databasen att vara en fil på din dator. I så fall ska NAME vara den fullständiga absoluta sökvägen, inklusive filnamnet på den filen. Du behöver inte skapa något i förväg, utan databasfilen skapas automatiskt när den behövs. Standardvärdet, BASE_DIR / 'db.sqlite3', lagrar filen i din projektkatalog.
Om du planerar att använda Djangos kommando manage.py migrate för att automatiskt skapa databastabeller för dina modeller (efter att du först har installerat Django och skapat ett projekt), måste du se till att Django har behörighet att skapa och ändra tabeller i den databas du använder; om du planerar att manuellt skapa tabellerna kan du ge Django behörigheterna SELECT, INSERT, UPDATE och DELETE. När du har skapat en databasanvändare med dessa behörigheter anger du detaljerna i ditt projekts inställningsfil, se DATABASER för detaljer.
Om du använder Djangos testramverk för att testa databasfrågor, behöver Django tillstånd att skapa en testdatabas.
\nInstallationsanvisningarna skiljer sig något åt beroende på om du installerar ett distributionsspecifikt paket, hämtar den senaste officiella versionen eller hämtar den senaste utvecklingsversionen.
\npipLink to this heading#Detta är det rekommenderade sättet att installera Django.
\nInstallera pip. Det enklaste är att använda det fristående installationsprogrammet för pip. Om din distribution redan har pip installerat, kan du behöva uppdatera det om det är föråldrat. Om det är föråldrat vet du det eftersom installationen inte fungerar.
Ta en titt på venv. Detta verktyg tillhandahåller isolerade Python-miljöer, vilket är mer praktiskt än att installera paket i hela systemet. Det gör det också möjligt att installera paket utan administratörsbehörighet. I contributing tutorial går man igenom hur man skapar en virtuell miljö.
När du har skapat och aktiverat en virtuell miljö skriver du in kommandot:
\nLinux / macOS
$ python -m pip install Django\nWindows
...\\> py -m pip install Django\nKontrollera distributionsspecifika anmärkningar för att se om din plattform/distribution tillhandahåller officiella Django-paket/installerare. Paket som tillhandahålls av distributionen tillåter vanligtvis automatisk installation av beroenden och uppgraderingsvägar som stöds; dessa paket innehåller dock sällan den senaste versionen av Django.
\nOm du vill kunna uppdatera din Django-kod då och då med de senaste buggfixarna och förbättringarna, följ dessa instruktioner:
\nSe till att du har Git installerat och att du kan köra dess kommandon från ett skal. (Ange git help vid en shell-prompt för att testa detta)
Kolla in Djangos huvudsakliga utvecklingsgren på följande sätt:
\nLinux / macOS
$ git clone https://github.com/django/django.git\nWindows
...\\> git clone https://github.com/django/django.git\nDetta kommer att skapa en katalog django i din nuvarande katalog.
Se till att Python-tolken kan ladda Djangos kod. Det mest praktiska sättet att göra detta är att använda en virtuell miljö och pip. I Bidragshandledning går vi igenom hur man skapar en virtuell miljö.
När du har konfigurerat och aktiverat den virtuella miljön kör du följande kommando:
\nLinux / macOS
$ python -m pip install -e django/\nWindows
...\\> py -m pip install -e django\\\nDetta kommer att göra Djangos kod importerbar och kommer också att göra kommandot django-admin tillgängligt. Med andra ord, du är redo!
När du vill uppdatera din kopia av Djangos källkod kör du kommandot git pull från katalogen django. När du gör detta kommer Git att ladda ner alla ändringar.