使用 Python 和 Django 搭建 Web 应用

使用 Python 和 Django 搭建 Web 应用
简介
Django 是 Python 开发的 Web 框架。使用 Django 搭建 Web 应用很方便。

写本文时 django 的最新版本为 1.4，但本文不关注新版本的特性，只搭建一个简单的应用。

安装 Django
本文以 CentOS 6.2 为例进行安装:
安装 python

# yum install python
本文使用的是 CentOS 6.2 Desktop，默认安装了 python. 查看一下 python 的版本

# python --version
Python 2.6.6
Django-1.4 支持 python 2.5 以上（ python3 暂不支持）。具体请看 Django的官方博客。
根据 python 的版本安装 setuptools，pip（使用pip安装软件很方便，pip 依赖 setuptools），安装 setuptools 很简单，到其 pipy 下载并安装(注意跟 python 的版本对应)。

# curl -O http://pypi.python.org/packages/2.6/s/setuptools/setuptools-0.6c11-py2.6.egg
# sh setuptools-0.6c11-py2.6.egg
# curl -O https://raw.github.com/pypa/pip/master/contrib/get-pip.py
# python get-pip.py
本文关注 django ，暂不考虑 virtualenv，buildout 等虚拟环境的安装。
安装 django

# pip install django
查看 django 的版本

$ django-admin.py --version
1.4
创建Django项目及Web应用
使用 django 搭建 Web 应用很快。

$ mkdir ~/dev
$ cd ~/dev
创建项目，使用 django-admin.py 的 startproject 命令。

～/dev$ django-admin.py startproject djdemo
django-1.4 创建的目录结构较以前的版本有了些调整，本文例子如下：

.
`--djdemo
   |--djdemo
   |  |--__init__.py
   |  |--settings.py
   |  |--urls.py
   |  `--wsgi.py
   `--manage.py
创建应用，使用 manage.py 的 startapp 命令，本文创建一个订单（Order）的例子。

$ cd djdemo
~/dev/djdemo$ python manage.py startapp orders
django 会自动创建此应用的基本文件，目录如下：

.
`--djdemo
   |--djdemo
   |  |--__init__.py
   |  |--settings.py
   |  |--urls.py
   |  `--wsgi.py
+  |--orders
+  |  |--__init__.py
+  |  |--models.py
+  |  |--tests.py
+  |  `--views.py
   `--manage.py
在 orders 文件夹中新建 admin.py ，用于 django 管理工具使用。最终目录如下：

.
`--djdemo
   |--djdemo
   |  |--__init__.py
   |  |--settings.py
   |  |--urls.py
   |  `--wsgi.py
   |--orders
   |  |--__init__.py
+  |  |--admin.py
   |  |--models.py
   |  |--tests.py
   |  `--views.py
   `--manage.py
创建一个 Django 的模型
接下来修改 models.py，管理此应有的模型。 注意：如果使用非 ASCII 码，需要在文件头部添加

    # -*- coding: utf-8 -*-
添加 Order 模型：

# -*- coding: utf-8 -*-
from django.db import models

# Create your models here.
from django.utils.translation import ugettext_lazy as _

class Order(models.Model):
    order_no = models.CharField(max_length=255)
    description = models.CharField(max_length=255)
    created_on = models.DateTimeField(help_text=_(‘creation date‘), auto_now_add = True)
    updated_on = models.DateTimeField(help_text=_(‘last update date‘), auto_now = True)

    def __unicode__(self):
        return self.order_no
这是一个 models 的例子，设计到了属性，国际化，自动填充时间等内容，关于 models，更多请参考 django 网站的 models相关文档。

以下是 admin.py 的内容，使 django 可以管理这个模型。 通常只需要添加就可以了如下例子：

# -*- coding: utf-8 -*-
from django.contrib import admin
from .models import Order

admin.site.register(Order)
但是django可以定制管理界面。如下更改：

# -*- coding: utf-8 -*-
from django.contrib import admin
from django.utils.translation import ugettext_lazy as _

from .models import Order

class OrderAdmin(admin.ModelAdmin):
    """Admin form Order model"""
    list_display = (‘order_no‘, ‘description‘, ‘created_on‘)
    search_fields = (‘order_no‘, ‘description‘)
    fieldsets = (
        (_(‘Content‘), {
            ‘fields‘: (‘order_no‘, ‘description‘)
        }),
        (_(‘Advanced options‘), {
            ‘classes‘: (‘collapse‘,),
            ‘fields‘: (‘created_on‘, ‘updated_on‘)
        }),
    )
    actions_on_top = True
    actions_on_bottom = True
    readonly_fields = ("created_on", "updated_on")

admin.site.register(Order, OrderAdmin)
这是一个 admin 的例子，涉及到了列表显示，搜索，配置界面等，关于 admin，更多请参考 django 网站的文档 admin 相关文档。

配置
主要配置 settings.py 和 urls.py。

在 settings.py 开始添加如下，主要设置路径：

# -*- coding: utf-8 -*-
# Django settings for djdemo project.

import os
import sys

ROOT_PATH = os.path.dirname(os.path.abspath(__file__))

if ROOT_PATH not in sys.path:
    sys.path.append(ROOT_PATH)
修改数据库配置，本文使用 sqlite3，这是 django 自带驱动的，其他的请参考 django 网站的 database 相关文档

DATABASES = {
    ‘default‘: {
        ‘ENGINE‘: ‘django.db.backends.sqlite3‘, # Add ‘postgresql_psycopg2‘, ‘mysql‘, ‘sqlite3‘ or ‘oracle‘.
        ‘NAME‘: os.path.abspath(os.path.join(ROOT_PATH, ‘..‘, ‘sqlite.db‘)), # Or path to database file if using sqlite3.
        ‘USER‘: ‘‘,                      # Not used with sqlite3.
        ‘PASSWORD‘: ‘‘,                  # Not used with sqlite3.
        ‘HOST‘: ‘‘,                      # Set to empty string for localhost. Not used with sqlite3.
        ‘PORT‘: ‘‘,                      # Set to empty string for default. Not used with sqlite3.
    }
}
接下来修改 INSTALLED_APPS 部分：
将 orders 应用添加到 INSTALLED_APPS 设置中，并去掉 admin 模块的#注释。

INSTALLED_APPS = (
    ‘django.contrib.auth‘,
    ‘django.contrib.contenttypes‘,
    ‘django.contrib.sessions‘,
    ‘django.contrib.sites‘,
    ‘django.contrib.messages‘,
    ‘django.contrib.staticfiles‘,
    # Uncomment the next line to enable the admin:
    ‘django.contrib.admin‘, 
    # Uncomment the next line to enable admin documentation:
    # ‘django.contrib.admindocs‘,
)
INSTALLED_APPS += (
    ‘orders‘,
)
配置 urls.py。
要让该管理工具可以通过 /admin URL 使用，只需要简单地取消项目的 urls.py 文件中提供的对应行的内容即可。

# -*- coding: utf-8 -*-
from django.conf.urls import patterns, include, url

# Uncomment the next two lines to enable the admin:
from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns(‘‘,
    # Examples:
    # url(r‘^$‘, ‘djdemo.views.home‘, name=‘home‘),
    # url(r‘^djdemo/‘, include(‘djdemo.foo.urls‘)),

    # Uncomment the admin/doc line below to enable admin documentation:
    # url(r‘^admin/doc/‘, include(‘django.contrib.admindocs.urls‘)),

    # Uncomment the next line to enable the admin:
    url(r‘^admin/‘, include(admin.site.urls)),
)
此时，程序基本配置完毕，下面开始数据库的初始化和 django 管理界面的使用。

先进行 sql 语句的显示，可以查看表结构是否正确(必须指明应用名称，本文为orders)。使用 manage.py 的 sqlall 命令。

~/dev/djdemo$ python manage.py sqlall orders
得到如下结果

BEGIN;
CREATE TABLE "orders_order" (
    "id" integer NOT NULL PRIMARY KEY,
    "order_no" varchar(255) NOT NULL,
    "description" varchar(255) NOT NULL,
    "created_on" datetime NOT NULL,
    "updated_on" datetime NOT NULL
)
;
COMMIT;
接下来开始数据库初始化，使用 manage.py 的 syncdb 命令, 期间会询问是否添加 superusers，过程如下：

~/dev/djdemo$ python manage.py syncdb
Creating tables ...
Creating table auth_permission
Creating table auth_group_permissions
Creating table auth_group
Creating table auth_user_user_permissions
Creating table auth_user_groups
Creating table auth_user
Creating table django_content_type
Creating table django_session
Creating table django_site
Creating table django_admin_log
Creating table orders_order
    
You just installed Django‘s auth system, which means you don‘t have any superusers defined.
Would you like to create one now? (yes/no): yes
Username (leave blank to use ‘****‘): admin
E-mail address: username@domain.com
Password: 
Password (again): 
Superuser created successfully.
Installing custom SQL ...
Installing indexes ...
Installed 0 object(s) from 0 fixture(s)
此时数据库初始化完毕。

测试
启动 django，进行应用的测试，使用 manage.py 的 runserver 命令，开启服务。

~/dev/djdemo$ python manage.py runserver
现在可以访问 http://localhost:8000/admin 查看。