建立Django第一個項目

1、 新建項目

進入你指定的項目保存目錄，而後運行下面的命令：

$ django-admin startproject mysite

這將在目錄下生成一個mysite目錄，也就是你的這個Django項目的根目錄。它包含了一系列自動生成的目錄和文件，具有各自專有的用途。

注意：在給項目命名的時候必須避開Django和Python的保留關鍵字，好比「django」，「test」等，不然會引發衝突和莫名的錯誤。對於mysite的放置位置，不建議放在傳統的/var/www目錄下，它會具備必定的數據暴露危險，所以Django建議你將項目文件放在例如/home/mycode相似的位置。

一個新創建的項目結構大概以下：

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

各文件和目錄解釋：

• 外層的mysite/目錄與Django無關，只是你項目的容器，能夠任意命名。

• manage.py：一個命令行工具，用於與Django進行不一樣方式的交互腳本，很是重要！

• 內層的mysite/目錄是真正的項目文件包裹目錄，它的名字是你引用內部文件的包名，例如：mysite.urls。

• mysite/__init__.py:一個定義包的空文件。

• mysite/settings.py:項目的主配置文件，很是重要！

• mysite/urls.py:路由文件，全部的任務都是從這裏開始分配，至關於Django驅動站點的內容表格，很是重要！

• mysite/wsgi.py:一個基於WSGI的web服務器進入點，提供底層的網絡通訊功能，一般不用關心。

2、 啓動開發服務器

進入mystie項目的根目錄，輸入下面的命令：

$ python manage.py runserver

你會看到下面的提示，這代表Django的開發服務器已經啓動，開始提供Web服務了：

Performing system checks...
System check identified no issues (0 silenced).
You have unapplied migrations; your app may not work properly until they are applied.
Run `python manage.py migrate' to apply them.
September 10, 2017 - 15:50:53
Django version 1.10, using settings `mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Django提供了一個用於開發的web服務器，使你無需配置一個相似Ngnix的線上服務器，就能讓站點運行起來。這是一個由Python編寫的輕量級服務器，簡易而且不安全，所以不要將它用於生產環境。

修改配置文件，圖以下：

打開瀏覽器，訪問http://127.0.0.1:8000/，你將看到Django的歡迎界面，一切OK！

Django的開發服務器（之後簡稱服務器）默認運行在內部的8000端口，若是你想指定端口，請在命令中顯示給出：

$ python manage.py runserver 8080

若是想修改服務器的ip地址，請按下面的方式運行命令：

$ python manage.py runserver 0.0.0.0:8000

這時，Django將運行在8000端口，整個局域網內都將能夠訪問站點，而不僅是是本機。

注意： Django的開發服務器具備自動重載功能，當你的代碼有修改，每隔一段時間服務器將自動更新。可是，有一些例如增長文件的動做，不會觸發服務器重載，這時就須要你本身手動重啓。

3、 建立投票應用(app)

app應用與project項目的區別：

• 一個app實現某個功能，好比博客、公共檔案數據庫或者簡單的投票系統；

• 一個project是配置文件和多個app的集合，這些app組合成整個站點；

• 一個project能夠包含多個app；

• 一個app能夠屬於多個project！

app的存放位置能夠是任何地點，可是一般都將它們放在與manage.py腳本同級的目錄下，這樣方便導入文件。

進入mysite項目根目錄，確保與manage.py文件處於同一級，輸入下述命令：

$ python manage.py startapp polls

系統會自動生成 polls應用的目錄，其結構以下：

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

在Pycharm中，沒有能夠建立app的圖形化按鈕，須要在下方的terminal終端中輸入命令：

python manage.py startapp polls

4、編寫第一個視圖

在polls/views.py文件中，編寫代碼：

from django.http import HttpResponse
from django.conf.urls import include
def index(request):
    return HttpResponse("Hello, world. You're at the polls index.")

爲了調用該視圖，咱們還須要編寫urlconf，也就是路由路徑。如今，在polls目錄中新建一個文件，名字爲urls.py，在其中輸入代碼以下：

from django.conf.urls import url
from . import views
urlpatterns = [
    url(r'^$', views.index, name='index'),
]

此時，目錄的文件結構是這樣的：

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    urls.py
    views.py

接下來，在項目的主urls文件中添加urlpattern條目，指向咱們剛纔創建的polls這個app獨有的urls文件，這裏須要導入include模塊。打開mysite/urls.py文件，代碼以下：

from django.conf.urls import include, url
from django.contrib import admin
from django.conf.urls import include
urlpatterns = [
    url(r'^polls/', include('polls.urls')),
    url(r'^admin/', admin.site.urls),
]

include語法至關於多級路由，它把接收到的url地址去除前面的正則表達式，將剩下的字符串傳遞給下一級路由進行判斷。在路由的章節，有更加詳細的用法指導。

include的背後是一種即插即用的思想。項目根路由不關心具體app的路由策略，只管往指定的二級路由轉發，實現了應用解耦。app所屬的二級路由能夠根據本身的須要隨意編寫，不會和其它的app路由發生衝突。app目錄能夠放置在任何位置，而不用修改路由。這是軟件設計裏很常見的一種模式。

建議：除了admin路由外，儘可能給每一個app設計本身獨立的二級路由。

好了，路由設置成功後，啓動服務器，而後在瀏覽器中訪問地址http://localhost:8000/polls/。一切正常的話，你將看到「Hello, world. You’re at the polls index.」

打開瀏覽器出現：