声明:此文章根据Django 使用 整理
一 安装
略
二 Django工程
2.1 创建项目
假设我们要创建一个名为 mysite的工程,使用Django命令如下:
django-admin.py startproject mysite
会在当前目录下生成一个mysite
的文件夹,里面的目录如下:
|—manage.py
|—mysite
|—__init.py
|—settings.py
|—urls.py
|—wsgi.py
关于每个文件的作用:
- init.py :Python特性,可以是空文件,表明这个文件夹是一个可以导入的包。
- settings.py :配置文件,本文主要修改数据库信息、模板目录、加载模块的信息。
- url.py :URL配置文件,指定函数与URL的映射关系。
wsgi.py :本文中不会使用,nginx/apache+wsgi在生产环境中运行Django时使用。
2.2 启动项目
创建完成后,在项目文件夹启动Django自带的web服务器。Django会自动检查配置文件中的错误,如果全部正常则顺利启动。
进入项目(manage.py文件所在文件夹路径)执行如下命令:
python manage.py runserver
访问http://127.0.0.1:8000,如果顺利显示,说明Django已经安装成功了。
3 Django数据库
关于安装使用mysql的问题参考另外一篇博文安装使用python Django。
现在要让Django支持MySQL数据库。编辑配置文件(mysite/mysite/settings.py)。找到DATABASES
的配置,默认是sqlite,把它改成MySQL:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql', #设置为mysql数据库
'NAME': 'test', #mysql数据库名
'USER': 'root', #mysql用户名,留空则默认为当前linux用户名
'PASSWORD': 'root', #mysql密码
'HOST': '', #留空默认为localhost(最好修改为127.0.0.1,localhost可能会出错)
'PORT': '', #留空默认为3306端口
}
}
代码的中文注释,在不指定Python文件编码的情况下会引起SyntaxError,所以不要复制这些中文注释。下文的中文注释同理。
4 配置web应用
4.1 url
完成以上配置之后,首页仍然是默认内容。Django会通过URL配置文件来查找相应的对象,URL地址使用正则表达式设置。在mysite/mysite目录下可以找到urls.py文件,它是URL配置的默认起点,修改这个文件增加首页的配置:
from django.conf.urls import include, url
from django.contrib import admin
from . import views #引入views
urlpatterns = [
url(r'^admin/', include(admin.site.urls)),
url(r'^$', views.home),#增加一条URL规则,r'^$'表示首页(/)
在mysite/mysite文件夹下新建views.py文件,内容如下:
from django.http import HttpResponse
def home(request):
return HttpResponse('hello, world')
4.2 应用
编写一个名为articles的应用,从mysql数据库读取文章作者、标题、内容。
首先建立应用,在项目文件夹中执行:
python manage.py startapp articles
运行后在项目文件夹中会创建article文件夹,包含下列文件:
articles/
|—admin.py
|—init.py
|—-migrations
__init__py
|—models.py
|—tests.py
|—views.py
- admin.py:当前应用在Django管理界面的设置。
- migrations:数据库迁移用文件夹,创建的migrate会存在这个文件夹里。
- models.py:模型文件,用 Python 类来描述数据表。
- views.py:视图文件,用来联系模型与模版,主要的业务逻辑一般都写在这里。
- tests.py:单元测试文件。生成应用之后,要修改配置文件,告诉Django这个应用是属于当前项目的。打开配置文件(mysite/mysite/settings.py),找到INSTALLED_APPS元组,增加articles:
INSTALLED_APPS = (
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django_openid_auth',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
#……
'articles', #加入应用
)
然后编写模型文件(article/models.py):
from django.db import models
# Create your models here.
class Article(models.Model):
title = models.CharField(max_length=64)
author = models.CharField(max_length=32)
content = models.TextField()
Django会根据模型文件自动生成migrations来操作数据库。
$ python manage.py makemigrations
Migrations for ‘articles’:
0001_initial.py:
– Create model Article
$ python manage.py migrate
Running migrations:
Rendering model states… DONE
Applying articles.0001_initial… OK
Django会创建名为articles_article的表,包含一个默认的主键和之前定义的字段。简单的模型就设置完成了,现在编辑应用的视图(articles/views.py)文件:
from django.shortcuts import render
from articles.models import Article #引入之前定义的model
def latest_article(request):
article_list = Article.objects.order_by('-id')
return render(request, 'articles.html', {'article_list':article_list})
编辑之前的urls.py文件(mysite/mysite/urls.py):
from django.conf.urls import include, url
from django.contrib import admin
from . import views
from articles import views as articles_views #导入articles的views
urlpatterns = [
url(r'^admin/', include(admin.site.urls)),
url(r'^$', views.home),
url(r'^articles/', articles_views.latest_article),
现在访问http://127.0.0.1:8000/articles/,直接运行会报错TemplateDoesNotExist at 路径,因为还没有告诉Django,到哪里去找articles.html文件。
编辑配置文件(mysite/mysite/settings.py),在56行找到TEMPLATE设置,在DIRS中设置一个模版路径,这里将模版目录指定为项目文件夹下的templates
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [os.path.join(BASE_DIR, 'templates'),],
'APP_DIRS': True,
创建templates(mysite/templates)文件夹和articles.html文件(mysite/templates/articles.html)。如果使用过其它框架或者模板引擎,下面articles.html的内容就很容易看懂了,Django在模版文件中利用相应的TAG控制传递过来的变量显示的位置:
{% for article in article_list %}
Author:{{ article.author }}
Title:{{ article.title }}
Content:{{ article.title }}
{% endfor %}
样所有的配置就完成了,访问 http://127.0.0.1:8000/articles,Django会自动读取数据库中的内容,并显示在网页上。可以直接在数据库中写入数据,或是在Django的shell中操作:
$ python manage.py shell
>>> from articles.models import Article
>>> Article.create(title=’Django’, author=’perchouli’, content=’Django+MySQL’)
完整教程参考Django 2.0 教程