django简明操作（自强学堂）_django自强学堂-优快云博客

#创建项目
django-admin.py startproject project-name

#创建APP
python manage.py startapp app-name
或 django-admin.py startapp app-name

#数据库同步
python manage.py syncdb
Django 1.7.1及以上的版本需要用以下命令
python manage.py makemigrations
python manage.py migrate

#创建admin模块，修改密码
python manage.py createsuperuser
python manage.py changepassword username

#清空数据库，留下表结构
python manage.py flush

#导出、导入数据
python manage.py dumpdata appname > appname.json

python manage.py loaddata appname.json

#views.py中视图函数的写法，1.8以上

from django.http import HttpResponse

def index(request):

return HttpResponse(u"访问主页"

)



#urls.py中路由的写法，1.8以上

from blog import views as blog_views  # new

urlpatterns = [

    url(r'^$', blog_views.index),  # new

    ]



request.GET 类似于一个字典，更好的办法是用 request.GET.get('a', 0) 当没有传递 a 的时候默认 a 为 0

url(r'^add/(\d+)/(\d+)/$', calc_views.add2, name='add2'),

我们可以看到网址中多了 (\d+), 正则表达式中 \d 代表一个数字，+ 代表一个或多个前面的字符，写在一起 \d+ 就是一个或多个数字，用括号括起来的意思是保存为一个子组（更多知识请参见 Python 正则表达式），每一个子组将作为一个参数，被 views.py 中的对应视图函数接收。

url 中的 name [技能提升]

我们还有刚才的代码，再来看一下 urls.py 中的代码(注意：第二条改成了 add2)
from django.conf.urls import url
from django.contrib import admin
from calc import views as calc_views

urlpatterns = [
    url(r'^add/', calc_views.add, name='add'),
    url(r'^add2/(\d+)/(\d+)/$', calc_views.add2, name='add2'),
    url(r'^admin/', admin.site.urls),
]

url(r'^add/$', calc_views.add, name='add'), 这里的 name='add' 是用来干什么的呢？

我们在开发的时候，刚开始想用的是 /add2/4/5/ ，后来需求发生变化，比如我们又想改成 /4_add_5/这样的格式，但是我们在网页中，代码中很多地方都写死的是
<a href="/add2/4/5/">计算 4+5</a>

这样就导致当我们改了 urls.py 后，对应的模板，甚至还视图中的跳转，以及 models.py 中也可能有获取网址的地方。

每个地方都要改，修改的代价很大，一不小心，有的地方没改过来，那个就不能用了。

那么有没有更优雅的方式来解决这个问题呢？当然答案是肯定的。

我们先说一下如何用 Python 代码获取对应的网址：

我们在终端上输入(推荐安装 bpython, 这样Django会用 bpython的 shell)
python manage.py shell
>>> from django.core.urlresolvers import reverse
>>> reverse('add2', args=(4,5))
u'/add2/4/5/'
>>> reverse('add2', args=(444,555))
u'/add2/444/555/'

reverse 接收 url 中的 name 作为第一个参数，我们在代码中就可以通过 reverse() 来获取对应的网址（这个网址可以用来跳转，也可以用来计算相关页面的地址），只要对应的 url 的name不改，就不用改代码中的网址。

在网页模板中也是一样，可以很方便的使用。
不带参数的：
{% url 'name' %}
带参数的：参数可以是变量名
{% url 'name' 参数 %}

例如：
<a href="{% url 'add2' 4 5 %}">link</a>

上面的代码渲染成最终的页面是
<a href="/add2/4/5/">link</a>

这样就可以通过 {% url 'add2' 4 5 %} 获取到对应的网址 /add2/4/5/

当 urls.py 进行更改，前提是不改 name（这个参数设定好后不要轻易改），获取的网址也会动态地跟着变，比如改成：

url(r'^new_add/(\d+)/(\d+)/$', 'calc.views.add2', name='add2'),

注意看重点 add2 变成了 new_add，但是后面的 name='add2' 没改，这时 {% url 'add2' 4 5 %} 就会渲染对应的网址成 /new_add/4/5/

reverse 函数也是一样，获取的时候会跟着变成新的网址，这样，在想改网址时只需要改 urls.py 中的正则表达式（url 参数第一部分），其它地方都“自动”跟着变了，是不是这样更好呢？

另外，如何让以前的 /add2/3/4/自动跳转到新的网址呢？要知道Django不会帮你做这个，这个需要自己来写一个跳转方法：

具体思路是，在 views.py 写一个跳转的函数：
from django.http import HttpResponseRedirect
from django.core.urlresolvers import reverse

def old_add2_redirect(request, a, b):
    return HttpResponseRedirect(
        reverse('add2', args=(a, b))
    )

urls.py中：
    url(r'^add2/(\d+)/(\d+)/$', calc_views.old_add2_redirect),
    url(r'^new_add/(\d+)/(\d+)/$', calc_views.add2, name='add2'),

#模板的用法

def home(request):

return render(request, 'home.html')

模板一般放在app下的templates中，Django会自动去这个文件夹中找。但假如我们每个app的templates中都有一个 index.html，当我们在views.py中使用的时候，直接写一个 render(request, 'index.html')，Django 能不能找到当前 app 的 templates 文件夹中的 index.html 文件夹呢?（答案是不一定能，有可能找错）

Django 模板查找机制： Django 查找模板的过程是在每个 app 的 templates 文件夹中找（而不只是当前 app 中的代码只在当前的 app 的 templates 文件夹中找）。各个 app 的 templates 形成一个文件夹列表，Django 遍历这个列表，一个个文件夹进行查找，当在某一个文件夹找到的时候就停止，所有的都遍历完了还找不到指定的模板的时候就是 Template Not Found （过程类似于Python找包）。这样设计有利当然也有弊，有利是的地方是一个app可以用另一个app的模板文件，弊是有可能会找错了。所以我们使用的时候在 templates 中建立一个 app 同名的文件夹，这样就好了。

这就需要把每个app中的 templates 文件夹中再建一个 app 的名称，仅和该app相关的模板放在 app/templates/app/ 目录下面，

views.py
def home(request):
TutorialList = ["HTML", "CSS", "jQuery", "Python", "Django"]
return render(request, 'home.html', {'TutorialList': TutorialList})

在视图中我们传递了一个List到模板 home.html，在模板中这样使用它：

home.html
教程列表：
{% for i in TutorialList %}
{{ i }}
{% endfor %}

for 循环要有一个结束标记，上面的代码假如我们对应的是首页的网址（自己修改urls.py）

views.py
def home(request):
info_dict = {'site': u'自强学堂', 'content': u'各种IT技术教程'}
return render(request, 'home.html', {'info_dict': info_dict})

home.html
站点：{{ info_dict.site }} 内容：{{ info_dict.content }}

在模板中取字典的键是用点info_dict.site，而不是Python中的 info_dict['site']

用变量 forloop.last 这个变量，如果是最后一项其为真，否则为假，更改如下：
{% for item in List %}
    {{ item }}{% if not forloop.last%},{% endif %}
{% endfor %}
在for循环中还有很多有用的东西，如下：
变量   描述
forloop.counter   索引从 1 开始算
forloop.counter0   索引从 0 开始算
forloop.revcounter   索引从最大长度到 1
forloop.revcounter0   索引从最大长度到 0
forloop.first   当遍历的元素为第一项时为真
forloop.last   当遍历的元素为最后一项时为真
forloop.parentloop

用在嵌套的 for 循环中，

获取上一层 for 循环的 forloop

当列表中可能为空值时用 for empty
<ul>
{% for athlete in athlete_list %}
    <li>{{ athlete.name }}</li>
{% empty %}
    <li>抱歉，列表为空</li>
{% endfor %}
</ul>

模板上得到视图对应的网址：
# views.py
def add(request, a, b):
    c = int(a) + int(b)
    return HttpResponse(str(c))

# urls.py
urlpatterns = patterns('',
    url(r'^add/(\d+)/(\d+)/$', 'app.views.add', name='add'),
)

# template html
{% url 'add' 4 5 %}

这样网址上就会显示出：/add/4/5/ 这个网址，假如我们以后修改 urls.py 中的
r'^add/(\d+)/(\d+)/$'
这一部分，改成另的，比如：
r'^jiafa/(\d+)/(\d+)/$'
这样，我们不需要再次修改模板，当再次访问的时候，网址会自动变成 /jiafa/4/5/
注意：如果是 Django 1.4 的话，需要在模板开头加上 {% load url from future %} (如果有 extends 的话，加在 extends 下面）
还可以使用 as 语句将内容取别名（相当于定义一个变量），多次使用（但视图名称到网址转换只进行了一次）
{% url 'some-url-name' arg arg2 as the_url %}

<a href="{{ the_url }}">链接到：{{ the_url }}</a>

模板中获取当前网址，当前用户等：
如果不是在 views.py 中用的 render 函数，是 render_to_response 的话，需要将 request 加入到上下文渲染器（点击查看详细）
Django 1.8 及以后修改 settings.py
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                ...
                'django.template.context_processors.request',
                ...
            ],
        },
    },
]
然后在模板中我们就可以用 request 了。

7.1 获取当前用户：
{{ request.user }}

如果登陆就显示内容，不登陆就不显示内容：
{% if request.user.is_authenticated %}
    {{ request.user.username }}，您好！
{% else %}
    请登陆，这里放登陆链接
{% endif %}

7.2.1 获取当前网址：
{{ request.path }}

7.2.2 获取当前 GET 参数：
{{ request.GET.urlencode }}

7.2.3 合并到一起用的一个例子：
<a href="{{ request.path }}?{{ request.GET.urlencode }}&delete=1">当前网址加参数 delete</a>

比如我们可以判断 delete 参数是不是 1 来删除当前的页面内容。

name 和 age 等字段中不能有 __（双下划线，因为在Django QuerySet API中有特殊含义（用于关系，包含，不区分大小写，以什么开头或结尾，日期的大于小于，正则等）

也不能有Python中的关键字，name 是合法的，student_name 也合法，但是student__name不合法，try, class, continue 也不合法，因为它是Python的关键字( import keyword; print(keyword.kwlist) 可以打出所有的关键字)

from .models import Article
admin.site.register(Article)

class Article(models.Model):
    title = models.CharField(u'标题', max_length=256)
    content = models.TextField(u'内容')

    pub_date = models.DateTimeField(u'发表时间', auto_now_add=True, editable = True)
    update_time = models.DateTimeField(u'更新时间',auto_now=True, null=True)

    def __unicode__(self):# 在Python3中用 __str__ 代替 __unicode__
        return self.title

所以推荐定义 Model 的时候写一个 __unicode__ 函数(或 __str__函数)

技能提升：如何兼容python2.x和python3.x呢？

示例如下：
# coding:utf-8
from __future__ import unicode_literals

from django.db import models
from django.utils.encoding import python_2_unicode_compatible

@python_2_unicode_compatible
class Article(models.Model):
    title = models.CharField('标题', max_length=256)
    content = models.TextField('内容')

    pub_date = models.DateTimeField('发表时间', auto_now_add=True, editable = True)
    update_time = models.DateTimeField('更新时间',auto_now=True, null=True)

    def __str__(self):
        return self.title

python_2_unicode_compatible 会自动做一些处理去适应python不同的版本，本例中的 unicode_literals 可以让python2.x 也像 python3 那个处理 unicode 字符，以便有更好地兼容性。

在列表显示与字段相关的其它内容

后台已经基本上做出来了，可是如果我们还需要显示一些其它的fields，如何做呢？
from django.contrib import admin
from .models import Article

class ArticleAdmin(admin.ModelAdmin):
    list_display = ('title','pub_date','update_time',)

admin.site.register(Article,ArticleAdmin)

list_display 就是来配置要显示的字段的，当然也可以显示非字段内容，或者字段相关的内容，比如：
class Person(models.Model):
    first_name = models.CharField(max_length=50)
    last_name = models.CharField(max_length=50)

    def my_property(self):
        return self.first_name + ' ' + self.last_name
    my_property.short_description = "Full name of the person"

    full_name = property(my_property)

在admin.py中
from django.contrib import admin
from .models import Article, Person

class ArticleAdmin(admin.ModelAdmin):
    list_display = ('title', 'pub_date', 'update_time',)

class PersonAdmin(admin.ModelAdmin):
    list_display = ('full_name',)

admin.site.register(Article, ArticleAdmin)
admin.site.register(Person, PersonAdmin)

其它一些常用的功能：
搜索功能：search_fields = ('title', 'content',) 这样就可以按照标题或内容搜索了
筛选功能：list_filter = ('status',) 这样就可以根据文章的状态去筛选，比如找出是草稿的文章
有时候我们需要对django admin site进行修改以满足自己的需求，那么我们可以从哪些地方入手呢？

以下举例说明：

1.定制加载的列表, 根据不同的人显示不同的内容列表，比如输入员只能看见自己输入的，审核员能看到所有的草稿，这时候就需要重写get_queryset方法
class MyModelAdmin(admin.ModelAdmin):
    def get_queryset(self, request):
        qs = super(MyModelAdmin, self).get_queryset(request)
        if request.user.is_superuser:
            return qs
        else:
            return qs.filter(author=request.user)

该类实现的功能是如果是超级管理员就列出所有的，如果不是，就仅列出访问者自己相关的

2.定制搜索功能（django 1.6及以上才有)
class PersonAdmin(admin.ModelAdmin):
    list_display = ('name', 'age')
    search_fields = ('name',)

    def get_search_results(self, request, queryset, search_term):
        queryset, use_distinct = super(PersonAdmin, self).get_search_results(request, queryset, search_term)
        try:
            search_term_as_int = int(search_term)
            queryset |= self.model.objects.filter(age=search_term_as_int)
        except:
            pass
        return queryset, use_distinct

queryset 是默认的结果，search_term 是在后台搜索的关键词

3.修改保存时的一些操作，可以检查用户，保存的内容等，比如保存时加上添加人
from django.contrib import admin

class ArticleAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        obj.user = request.user
        obj.save()

其中obj是修改后的对象，form是返回的表单（修改后的），当新建一个对象时 change = False, 当修改一个对象时 change = True
如果需要获取修改前的对象的内容可以用
from django.contrib import admin

class ArticleAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        obj_original = self.model.objects.get(pk=obj.pk)
        obj.user = request.user
        obj.save()

那么又有问题了，这里如果原来的obj不存在，也就是如果我们是新建的一个怎么办呢，这时候可以用try,except的方法尝试获取,当然更好的方法是判断一下这个对象是新建还是修改，是新建就没有 obj_original，是修改就有
from django.contrib import admin

class ArticleAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        if change:# 更改的时候
            obj_original = self.model.objects.get(pk=obj.pk)
        else:# 新增的时候
            obj_original = None

        obj.user = request.user
        obj.save()

4, 删除时做一些处理,
from django.contrib import admin

class ArticleAdmin(admin.ModelAdmin):
    def delete_model(self, request, obj):
        """
        Given a model instance delete it from the database.
        """
        # handle something here
        obj.delete()

第二节，使用 Django 的表单 (forms)
在tools文件夹中新建一个 forms.py 文件
from django import forms

class AddForm(forms.Form):
    a = forms.IntegerField()
    b = forms.IntegerField()

我们的视图函数 views.py 中
# coding:utf-8
from django.shortcuts import render
from django.http import HttpResponse

# 引入我们创建的表单类
from .forms import AddForm

def index(request):
    if request.method == 'POST':# 当提交表单时

        form = AddForm(request.POST) # form 包含提交的数据

        if form.is_valid():# 如果提交的数据合法
            a = form.cleaned_data['a']
            b = form.cleaned_data['b']
            return HttpResponse(str(int(a) + int(b)))

    else:# 当正常访问时
        form = AddForm()
    return render(request, 'index.html', {'form': form})

对应的模板文件 index.html
<form method='post'>
{% csrf_token %}
{{ form }}
<input type="submit" value="提交">
</form>

再在 urls.py 中对应写上这个函数
from django.conf.urls import patterns, include, url

from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns('',
    # 注意下面这一行
    url(r'^$', 'tools.views.index', name='home'),
    url(r'^admin/', include(admin.site.urls)),
)

新手可能觉得这样变得更麻烦了，有些情况是这样的，但是 Django 的 forms 提供了：

    模板中表单的渲染

    数据的验证工作，某一些输入不合法也不会丢失已经输入的数据。

    还可以定制更复杂的验证工作，如果提供了10个输入框，必须必须要输入其中两个以上，在 forms.py 中都很容易实现

运行 django-admin.py startproject [project-name] 命令会生成一系列文件，在Django 1.6版本以后的 settings.py 文件中有以下语句：
# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
import os
BASE_DIR = os.path.dirname(os.path.dirname(__file__))

这里用到了python中一个神奇的变量 __file__ 这个变量可以获取到当前文件（包含这个代码的文件）的路径。os.path.dirname(__file__) 得到文件所在目录，再来一个os.path.dirname()就是目录的上一级，BASE_DIR 即为项目所在目录。我们在后面的与目录有关的变量都用它，这样使得移植性更强。

# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = True
TEMPLATE_DEBUG = True

DEBUG＝True 时，如果出现 bug 便于我们看见问题所在，但是部署时最好不要让用户看见bug的详情，可能一些不怀好心的人攻击网站，造成不必要的麻烦。

ALLOWED_HOSTS = ['*.besttome.com','www.ziqiangxuetang.com']

ALLOWED_HOSTS 允许你设置哪些域名可以访问，即使在Apache中绑定了，这里不允许的话，也是不能访问的。

当 DEBUG=False 时，这个为必填项，如果不想输入，可以用 ALLOW_HOSTS = ['*'] 来允许所有的。

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR,'static')

static 是静态文件所有目录，比如 jquery.js, bootstrap.min.css 等文件。

一般来说我们只要把静态文件放在 APP 中的 static 目录下，部署时用 python manage.py collectstatic 就可以把静态文件收集到 STATIC_ROOT 目录，但是有时我们有一些共用的静态文件，这时候可以设置 STATICFILES_DIRS 另外弄一个文件夹，如下：
STATICFILES_DIRS = (
    os.path.join(BASE_DIR, "common_static"),
    '/var/www/static/',
)

这样我们就可以把静态文件放在 common_static 和 /var/www/static/中了，Django也能找到它们。

MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR,'media')

media文件夹用来存放用户上传的文件，与权限有关，详情见 Django 静态文件和   Django 部署

有时候有一些模板不是属于app的，比如 baidutongji.html, share.html等，

Django 1.5 - Django 1.7
TEMPLATE_DIRS = (
    os.path.join(BASE_DIR, 'templates').replace('\\', '/'),
    os.path.join(BASE_DIR, 'templates2').replace('\\', '/'),
    # ...
)

Django 1.8 及以上版本
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [
            os.path.join(BASE_DIR,'templates').replace('\\', '/'),
            os.path.join(BASE_DIR,'templates2').replace('\\', '/'),
        ],
        'APP_DIRS': True,
]

这样就可以把模板文件放在 templates 和 templates2 文件夹中了。