每週一薦：Python Web開發框架Django

作　　者：david++
發佈時間：2012/08/09 22:40

花了兩週時間，利用工作間隙時間，開發了一個基於Django的項目任務管理Web應用。項目計劃的實時動態，可以方便地被項目成員查看（^_^又重複發明輪子了）。從前臺到後臺，好好折騰了一把，用到：HTML、CSS、JavaScript、Apache、Python、mod_wsgi、Django。好久不用CSS和JavaScript了，感到有點生疏了，查了無數次手冊。後臺Django開發環境的搭建也花了不少時間和精力。記錄下來，免得以後走彎路。同時給大家推薦一下Django框架，如果你想非常快速地編寫自己的web應用，可以考慮使用Django，同時Django還會給你提供一個功能強大的後臺管理界面。

Django是一個開源的Web應用框架，由Python寫成。採用MVC的軟件設計模式，主要目標是使得開發複雜的、數據庫驅動的網站變得簡單。Django注重組件的重用性和“可插拔性”，敏捷開發和DRY法則（Don’t Repeat Yoursef）。在Django中Python被普遍使用，甚至包括配置文件和數據模型。它可以運行在啓用了mod_python或mod_wsgi的Apache2，或者任何兼容WSGI（Web Server Gataway Interface）的Web服務器。

1. Django的快速開發

• 第一步（Model）：設計自己的數據模型。
• 第二步（View）：創建網頁模板。Django自己的Html模板語言，非常容易將數據和模板結合起來，創建動態頁面。
• 第三步（Control）：定義URL，提供服務和控制。

入門教程：https://docs.djangoproject.com/en/1.4/intro/tutorial01/

2. Django開發環境的搭建

Django可以運行在任何遵守WSGI的Web服務器上。本文主要介紹Apache2+mod_wsgi+Django的環境搭建。所需要的軟件如下：

1. Apache2：Web服務器
2. Python2.x：Python語言支持
3. mod_wsgi：Apache的WSGI模塊，有了該模塊的支持，就可以用Python做爲CGI腳本來編寫網絡應用（之前還有一個mod_python，在Apache官網上發現mod_python已經過時，漸漸要被mod_wsgi替代，據說mod_wsig性能要好一些）
4. Django：一個強大的Python Web開發框架，本文的主角。

2.1 Apache的安裝

下　　載：http://httpd.apache.org/download.cgi （選擇版本2.2.22，mod_wsig暫不支持2.4.2）
解壓縮　：$tar xvfz httpd-NN.tar.gz
$cd httpd-NN
編譯配置：$./configure –with-included-apr –prefix=PREFIX #with-included-apr選項指定使用apache軟件包裏面的apr庫
編　　譯：$make
安　　裝：$make install
配　　置：$vim PREFIX/conf/httpd.conf
測　　試：$PREFIX/bin/apachectl -k start
參　　考：

• 官方主頁：http://httpd.apache.org/
• 安裝文檔：http://httpd.apache.org/docs/2.2/install.html

2.2 Python的安裝

下　　載：http://www.python.org/getit/releases/2.7.3/（選擇2.X版都可以，3.0暫不支持）
解壓縮　：$tar xvf python-X.tar
$cd python-Y
編譯配置：$./configure –enable-shared –prefix=PREFIX #–enable-shared選項指定生成python的動態庫
編　　譯：$make
安　　裝：$make install
測　　試：$python
參　　考：

• 官方主頁：http://www.python.org/

2.3 mod_wsgi模塊的安裝

下　　載：http://code.google.com/p/modwsgi/ （選擇3.3版本）
解壓縮　：$tar xvfz mod_wsgi.X.Y.tar.gz
$cd mod_wsgi.X.Y
編譯配置：$././configure –with-apxs=/usr/local/apache2/bin/apxs –with-python=/usr/local/bin/python # 指定Apache2的模塊編譯程序和Python解析器
編　　譯：$make
安　　裝：$make install

測　　試：$python

2.3.1  配置Apache（修改/usr/local/apche2/confi/httpd.conf）

# 加載wsgi模塊
LoadModule wsgi_module modules/mod_wsgi.so
....
# HTTP請求處理腳本
WSGIScriptAlias /test  /home/xxx/www/test.wsgi
<Directory "/home/xxx/www">
Order allow, deny
Allow from all
</Directory>

2.3.2 編寫test.wsgi（WSGI標準：http://www.python.org/dev/peps/pep-3333/）

def application(environ, start_response):
    status = '200 OK'
    output = 'Hello World!'

    response_headers = [('Content-type', 'text/plain'),
                        ('Content-Length', str(len(output)))]
    start_response(status, response_headers)

    return [output]

2.3.3  重啓apche2

在任意網絡瀏覽器中輸入：http://www.mysite.com/test。看到“Hello World!”，恭喜你成功安裝了WSGI模塊。

參　　考：

• 官方主頁：http://code.google.com/p/modwsgi/
• 安裝文檔：http://code.google.com/p/modwsgi/wiki/QuickInstallationGuide
• 配置文檔：http://code.google.com/p/modwsgi/wiki/QuickConfigurationGuide
• WSGI文檔：http://www.python.org/dev/peps/pep-3333/

2.4 Django的安裝

下　　載：https://www.djangoproject.com/download/ （選擇1.4版本）
解壓縮　：$tar xvfz Django-1.4.tar.gz
$cd Django-1.4
安　　裝：$python setup.py install
測　　試：

$python
>>> import django
>>> print(django.get_version())

參　　考：

• 官方主頁：https://www.djangoproject.com/
• 安裝文檔：https://docs.djangoproject.com/en/1.4/intro/install/
• 快速入門：https://docs.djangoproject.com/en/1.4/intro/tutorial01/

3. Django中文支持

Django使用的是UTF-8編碼，所以對於國際化支持不成問題。因爲初次玩Django，中文顯示亂，折騰死人了（一直在用的的mysql默認字符串是latin1編碼，vim默認保存的文件編碼爲ascii）。最終得出結論，如果中文顯示亂碼，或者Django報錯(… unicode …blabla…)，請檢查：

1. Django的設置。打開自己項目的settings.py，LANGUAGE_CODE=”zh_CN” ？FILE_CHARSET=’UTF-8′ ？DEFAULT_CHARSET=’utf-8′？
2. 查看自己項目所有的文件編碼是否以UTF-8編碼保存的？確保.py文件第一行要加上：#-*-  coding:utf-8 -*- ？
3. HTML模板文件head部分，添加<meta http-equiv=“Content-Type” content=“text/html;charset=utf-8″/>
4. 檢查自己項目的數據庫字符串編碼是否爲UTF-8，命令如下：
   查看：
   show create database dbname;
   show create table tablename;
   show full columns from tablename;
   創建：
   create database dbname CHARACTER SET utf8;
   create table tblname CHARACTER SET utf8;
   修改：
   alter database dbname CHARACTER SET = utf8;
   alter table tablename CONVERT TO CHARACTER SET utf8;

4. Django應用的部署

Django應用的運行有兩個方式，一種是在開發階段，使用創建項目下面的manager.py runserver ip:port來啓動一個用Python實現的輕型web服務器；另外一種就是通過mod_wsgi將你自己的應用部署到生產環境，對外提供服務。下面簡單介紹一下Django的部署（虛擬主機上的配置，自行參考文檔）。

假設你創建的Django項目文件列表如下：

my-site
|- my-site
|- myapp
    |-static
    |- ...
|- static
    |- css
    |- js
    | ...
|- apache
|- ...

4. 1. 創建Django項目的wsgi腳本（my-site/apache/django.wsgi），內容如下：

import os, sys

sys.path.append('/.../www/')
sys.path.append('/.../www/my-site')
os.environ['DJANGO_SETTINGS_MODULE'] = 'my-site.settings'
os.environ['PYTHON_EGG_CACHE'] = '/.../www/.python-eggs'

import django.core.handlers.wsgi

_application = django.core.handlers.wsgi.WSGIHandler()

def application(environ, start_response):
    if environ['wsgi.url_scheme'] == 'https':
        environ['HTTPS'] = 'on'
    return _application(environ, start_response)

4.2. 配置Apache（httpd.conf），內容如下：

# 請求訪問www.xxx.com/的時候，轉到django.wsgi
WSGIScriptAlias / /.../www/my-site/apache/django.wsgi

<Directory /.../www/my-site/apache>
Order deny,allow
Allow from all
</Directory>

# 靜態文件的訪問路徑配置
Alias /static/ /.../www/my-site/static/

<Directory /.../www/my-site/static>
Order deny,allow
Allow from all
</Directory>

4.3. 配置setting.py

• EBUG=False
• 自定義404.html，500.html模板（網頁未找到、服務器內部錯誤）

4.4. 靜態文件

• STATIC_ROOT = ‘/…/www/my-site/static/’
• STATIC_URL = ‘/static/’
• $./manager.py collectstatic

注意：開發階段，一般都會把相應app的靜態文件，放在app目錄下的static目錄下。在正式生產環境部署的時候，使用./manager.py collectstatic來把所有靜態文件收集到STATIC_ROOT指定的位置，包括管理後臺的。

4.5. 重啓apahce

瀏覽器輸入相應的URL地址，看到你自己的web應用界面的話，恭喜大功告成！

5. 總結

本文主要介紹了一下Django開發環境的搭建、Django應用的部署和中文亂碼的解決方法。具體如何使用Django快速地創建自己的web應用，並沒有提及。Django相對來說，文檔比較齊全，加上官方推出的一本書：《The Django Book》，相信只要開發環境搭建好，創建自己的Web應用也會非常容易。

進一步學習Django，請看：

1. Django1.4文檔：https://docs.djangoproject.com/en/1.4/
2. Django Book 英文版：http://www.djangobook.com/en/2.0/
3. Django Book 中文版：http://djangobook.py3k.cn/2.0/