開始著手第一個Django項目

一但你安裝好了python，django和（可選的）資料庫及相關庫，你就可以通過建立一個project，邁出開發django應用的第一步。

項目 是 Django 執行個體的一系列設定的集合，它包括資料庫配置、Django 特定選項以及應用程式的特定設定。

如果第一次使用 Django，必須進行一些初始化設定工作。 建立一個工作目錄，例如 /home/username/djcode/ ，然後進入該目錄。

這個目錄應該放哪兒？

有過 PHP 編程背景的話，你可能習慣於將代碼都放在 Web 服務器的主目錄 (例如 /var/www 這樣的地方)。 而在 Django 中，把任何Python代碼和web server的文檔根(root)放在一起並不是一個好主意。因為這樣做有使人能通過網路看到你原代碼的風險. 那就太糟了。

把代碼放置在主目錄 之外 的某些目錄中。

轉到你建立的目錄，運行命令django-admin.py startproject mysite。這樣會在你的目前的目錄下建立一個目錄。mysite

注意

如果用的是 setup.py 工具安裝的 Django ， django-admin.py 應該已被加入了系統路徑中。

如果你使用一個trunk版本，你會在 djtrunk/django/bin 下發現 django-admin.py 。你將來會常用到django-admin.py，考慮把它加到你的系統路徑中去比較好。 在Unix中, 你也可以用來自/usr/local/bin 的符號串連, 用一個命令, 諸如

sudo ln -s /path/to/django/bin/django-admin.py /usr/local/bin/django-admin.py

. 在Windows中, 你需要修改你的 PATH 環境變數.

如果你的django是從linux發行版中安裝的，那麼，常會被django-admin.py替代。django-admin

如果在運行時，你看到許可權拒絕的提示，你應當修改這個檔案的許可權。django-admin.py startproject 為此, 鍵入 cd /usr/local/bin轉到django-admin.py所在的目錄，運行命令chmod +x django-admin.py

startproject 命令建立一個目錄，包含4個檔案：

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

檔案如下：

• __init__.py ：讓 Python 把該目錄當成一個開發包 (即一組模組)所需的檔案。 這是一個空檔案，一般你不需要修改它。
• manage.py ：一種命令列工具，允許你以多種方式與該 Django 項目進行互動。 鍵入python manage.py help，看一下它能做什麼。 你應當不需要編輯這個檔案；在這個目錄下產生它純是為了方便。
• settings.py ：該 Django 項目的設定或配置。 查看並理解這個檔案中可用的設定類型及其預設值。
• urls.py：Django項目的URL設定。 可視其為你的django網站的目錄。 目前，它是空的。

儘管這些的檔案很小，但這些檔案已經構成了一個可啟動並執行Django應用。
運行程式開發伺服器

為了安裝後更多的體驗，讓我們運行一下django程式開發伺服器看看我們的准系統。

django開發服務是可用在開發期間的，一個內建的，輕量的web服務。 我們提供這個伺服器是為了讓你快速開發網站，也就是說在準備發布產品之前，無需進行產品級 Web 服務器（比如 Apache）的配置工作。 程式開發伺服器監測你的代碼並自動載入它，這樣你會很容易修改代碼而不用重啟動服務。

如果你還沒啟動伺服器的話，請切換到你的項目目錄裡 (cd mysite )，運行下面的命令：

python manage.py runserver

你會看到些像這樣的

Validating models...0 errors found.Django version 1.0, using settings 'mysite.settings'Development server is running at http://127.0.0.1:8000/Quit the server with CONTROL-C.

這將會在連接埠8000啟動一個本機伺服器, 並且只能從你的這台電腦串連和訪問。 既然伺服器已經運行起來了，現在用網頁瀏覽器訪問 http://127.0.0.1:8000/ 。 你應該可以看到一個令人賞心悅目的淡藍色Django歡迎頁面。 它開始工作了。

在進一步學習之前， 一個重要的，關於開發網路伺服器的提示很值得一說。 雖然 django 內建的這個 網頁伺服器對於開發很方便，但是，千萬不要在正式的應用布署環境中使用它。 在同一時間，該伺服器只能可靠地處理一次單個請求，並且沒有進行任何類型的安全審計。 發布網站前，請參閱第 20 章瞭解如何部署 Django 。

更改這個 Development Server 的主機地址或連接埠

預設情況下， runserver 命令在 8000 連接埠啟動程式開發伺服器，且僅監聽本地串連。 要想要更改伺服器連接埠的話，可將連接埠作為命令列參數傳入：

python manage.py runserver 8080

通過指定一個 IP 位址，你可以告訴伺服器–允許非本地串連訪問。 如果你想和其他開發人員共用同一開發網站的話，該功能特別有用。 `` 0.0.0.0`` 這個 IP 位址，告訴伺服器去偵聽任意的網路介面。

python manage.py runserver 0.0.0.0:8000

完成這些設定後，你本網中的其它電腦就可以在瀏覽器中訪問你的 IP 位址了。比如： http://192.168.1.103:8000/ . (注意，你將需要校閱一下你的網路設定來決定你在本網中的IP 位址) Unix使用者可以在命令提示字元中輸入ifconfig來擷取以上資訊。 使用Windows的使用者，請嘗試使用 ipconfig 命令。

