sqlite3#

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

mysql#

使用mysql需要安装连接模块

 pip install mysqlclient  #安装时需要本地安装了mysql

django对mysqlclient版本有使用有要求,可以在django的源码查看mysqlclient版本要求

pip install pymysql

在项目的__init__.py中增加以下代码

import pymysql
pymysql.install_as_MySQLdb()

两者选择其一,不建议同时使用

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',  # 使用 MySQL
        'NAME': 'blog',  # 数据库名称
        'USER': 'root',  # MySQL 用户
        'PASSWORD': '123456',  # MySQL 密码
        'HOST': 'localhost',  # 数据库服务器地址，远程则改为 IP 地址
        'PORT': '3306',  # MySQL 端口，默认 3306
        'OPTIONS': {
            'charset': 'utf8mb4',  # 推荐使用 utf8mb4 支持 Emoji
            'init_command': "SET sql_mode='STRICT_TRANS_TABLES'",  # 避免非严格模式带来的数据问题
        },
    }
}

如果使用MySQL的版本是8.0以上,会提示django.utils.OperationaError错误信息,因为MySQL8.0以上的加密方式发生了改变,用户密码彩的是CHA2(caching_sha2_password)加密方式

解决报错用管理员登录mysql执行以下代码:

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'newpassword';
FLUSH PRIVILEGES;

多个数据库连接

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    },
    'MyIndex': {
        'ENGINE': 'django.db.backends.mysql',  # 使用 MySQL
        'NAME': 'my_index',  # 数据库名称
        'USER': 'root',  # MySQL 用户
        'PASSWORD': '123456',  # MySQL 密码
        'HOST': 'localhost',  # 数据库服务器地址，远程则改为 IP 地址
        'PORT': '3306',  # MySQL 端口，默认 3306
        'OPTIONS': {
            'charset': 'utf8mb4',  # 推荐使用 utf8mb4 支持 Emoji
            'init_command': "SET sql_mode='STRICT_TRANS_TABLES'",  # 避免非严格模式带来的数据问题
        },
    },
    'mysqlbak': {
        'ENGINE': 'django.db.backends.mysql',  # 使用 MySQL
        'NAME': 'mysqlbak',  # 数据库名称
        'USER': 'root',  # MySQL 用户
        'PASSWORD': '123456',  # MySQL 密码
        'HOST': 'localhost',  # 数据库服务器地址，远程则改为 IP 地址
        'PORT': '3306',  # MySQL 端口，默认 3306
        'OPTIONS': {
            'charset': 'utf8mb4',  # 推荐使用 utf8mb4 支持 Emoji
            'init_command': "SET sql_mode='STRICT_TRANS_TABLES'",  # 避免非严格模式带来的数据问题
        },
    }
}

若项目中连接了多个数据库,每个模型所对应的数据表可以选择在某个数据库中生成,如果 没有模型没有指向某个数据库,则模型就会在key为default的数据库中生成.

配置文件#

在项目根目录新建my.cnf文件增加以下配置

# my.cnf
[client]
database=index
user=root
password=root123456
host=127.0.0.1
port=3306

编写配置文件my.cnf必须设置[clinet]分组,settings.py配置DATABASE配置信息如下:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',  # 使用 MySQL
        'OPTIONS':{'read_default_file':str(BASE_DIR/'my.cnf')},
    },
}

执行生成数据表(配置不能有中文)

python manage.py migrate

查看数据表

更改index的view.py

from django.shortcuts import render
from django.contrib.contenttypes.models import ContentType

def home(request):
    c=ContentType.objects.values_list().all()
    print(c)
    return render(request, 'home.html')

资源路由#

在“DEBUG=True`时,STATIC_URL,默认创建项目就有配置,可以旋转css,js,images等静态资源,注册了的app下的static下的文件可以访问

STATIC_URL = 'static/'

以上配置在根目录访问static中的文件是访问不了,如果注册的app换了一个名称也是不能识别的,用到STATICFILES_DIRS

资源整合#

STATICFILES_DIRS就是处理多个静态文件目录的

# 静态文件
STATIC_URL = 'static/' # 静态文件的路由地址
STATICFILES_DIRS = [
    BASE_DIR / "static", # 配置项目的static,就是项目根目录的static
    # BASE_DIR / "article/static",
]

配置app下的其它目录

STATIC_URL = 'static/' # 静态文件的路由地址
STATICFILES_DIRS = [
    BASE_DIR / "static", # 配置项目的static,就是项目根目录的static
    BASE_DIR / "index/Mystatic", # 配置index App下的Mystatic为静态文件目录
]

当访问static可以访问根目录的static,也可以访问注册app下的static,还可以访问注册app的Mystatic下的文件

如果改了STATIC_URL = 'allStatic/',访问的地址就是这个目录

STATIC_URL = 'allStatic/' # 静态文件的路由地址
STATICFILES_DIRS = [
    BASE_DIR / "static", # 配置项目的static,就是项目根目录的static
    BASE_DIR / "index/Mystatic", # 配置index App下的Mystatic为静态文件目录
]

资源部署#

STATIC_ROOT,是在服务器上部署项目时,收集整个项目的静态资源并存放在一个新的文件夹中,以实现服务器和项目之间的映射关系.配置如下:

STATIC_ROOT = BASE_DIR / 'AllStatic'

设置STATIC_ROOT需要使用Django操作指令python manage.py collectstatic来收集所有静态资源到配置文件夹中

可以设置服务器的一个绝对路径,需要有写入权限

媒体文件#

一般情况下,STATIC_URL用于设置静态文件的路由地址,如css,js以及常用图片等.

对于经常变动的资源,如用户上传的头像,歌曲文件等,通常存放在媒体资源文件夹中.

设置如下:

# 媒体文件路由地址
MEDIA_URL = '/media/'
# 获取media文件夹的完整路径信息
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

设置完成属性后,还需要将media文件夹注册到Django中.以便让Django知道如何找到媒体文件,否则无法在浏览器中访问该文件夹内的文件信息.

打开项目文件中的urls.py,为媒体文件夹media添加相应的路由地址.

from django.contrib import admin
from django.urls import path, re_path
# 配置媒体文件夹media路由地址
from django.views.static import serve
from django.conf import settings

# 方法一
urlpatterns = [
    path('admin/', admin.site.urls),
    re_path('media/(?P<path>.*)', serve, {'document_root': settings.MEDIA_ROOT}, name='media')
]
# 方法二
if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

settings

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [BASE_DIR / 'templates']
        ,
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
                # 将media_url上传文件路径注册到横版中
                'django.template.context_processors.media'
            ],
        },
    },
]

配置完成后重启服务,访问media下的文件,可以正常访问

测试设置是否成功#

在根目录的templates下新建404.html和500.html处理服务器错误和404页面

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<h1>404页面</h1>
</body>
</html>

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<h1>500页面</h1>
</body>
</html>

在app index的templates下新建home.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<h1>home页面</h1>
</body>
</html>

在index的views设置处理路由函数

from django.shortcuts import render


def home(request):
    return render(request, 'home.html')


def custom_404_view(request):
    return render(request, '404.html')


def custom_500_view(request):
    return render(request, '500.html')

设置路由

from django.contrib import admin
from django.urls import path, re_path
from index import  views
# 配置媒体文件夹media路由地址
from django.views.static import serve
from django.conf import settings

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.home), # 首页
    re_path('media/(?P<path>.*)', serve, {'document_root': settings.MEDIA_ROOT}, name='media')
]

settings.py

DEBUG = False

ALLOWED_HOSTS = ['*']

首页路由设计一个错误

from django.shortcuts import render

def home(request):
    # 测试服务器500
    print(fsfsd)
    return render(request, 'home.html')

全部都可以访问

正则表达式路由#

路由的正则表达示是路由函数 re_path 定义的，作用是对路由地址进行截取与判断。正则表达示以圆括号为单位，每个圆括号的前后可以使用斜杠或者其它字符来分隔或结束。

变量以一个圆括号为单位以(?P[0-9]{4})解释：

• ?P 是固定格式，字母 P 必须为大写。
• 为变量名
• [0-9]{4}是正则表达式的匹配模式，代表变量长度为4，只允许0-9的值。

命名空间#

路由分发的时候可以指定命名空间

路由函数 include 设有参数 arg 和 namespace,参数 arg 指向项目应用 App 的 urls.py 文件，其数据格式以元组或字符串表示，可选参数 namespace 是路由的命名空间。

要对路由设置参数 namespace，则参数arg 必须以元组格式表示，并且元组的长度必须为2.元组的元素说明如下：

• 第一个元素为项目应用的 urls.py 文件
• 第二个元素可以自行命名，但不能为空。通常情况下，会将其命名为项目应用 app的名称，如(‘index.urls’,‘index’)

如果设置了参数 namespace，并且参数 arg为字符串或元组长度不足2，则运行 djadngo 项目会报以下错误

django.core.exceptions.ImproperlyConfigured: Specifying a namespace in include() without providing an app_name is not supported. Set the app_name attribute in the included module, or pass a 2-tuple containing the list of patterns and app_name instead.

正确的配置如下：

from django.contrib import admin
from django.urls import path, re_path, include
from index import views
# 配置媒体文件夹media路由地址
from django.views.static import serve
from django.conf import settings

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include(('index.urls', 'index'), namespace='index')), # 正确配置
    path('user/', include(('user.urls','user'), namespace='user')), # 正确配置
    re_path('media/(?P<path>.*)', serve, {'document_root': settings.MEDIA_ROOT}, name='media')
]

路由命名#

指定路由处理的视图函数或视图类时可以指定路由的地址 name如下:

from django.urls import re_path, path
from . import views

urlpatterns = [
    path('', views.profile, name='userProfile'),
    path('login/', views.login, name='userLogin'),
    path('register/', views.register, name='userRegister'),
]

reverse#

源码

def reverse(viewname, urlconf=None, args=None, kwargs=None, current_app=None):
    if urlconf is None:
        urlconf = get_urlconf()
    resolver = get_resolver(urlconf)
    args = args or []
    kwargs = kwargs or {}

    prefix = get_script_prefix()

    if not isinstance(viewname, str):
        view = viewname
    else:
        *path, view = viewname.split(":")
        .....

函数 reverse 中设必选参数viewname，其余参数是可选参数，参数说明如下：

• viewname：代表路由命名或可调用视图对象，一般情况下是以路由命名 name 来生成路由地址
• urlconf：设置反向解析的 URLconf 模块。默认情况下，使用配置文件 settings.py的 ROOT_URLCONF属性
• args：以列表方式传递路由地址变量，列表元素顺序和数量应与路由地址变量的顺序和数量一致
• kwargs：以字典方式传递路由地址变量，字典 的键必须对应路由地址变量名，字典键值对数量 与变量的数量要一致
• current_app：提示当前正在执行的视图所在的项目应用，主要起到提示作用，在功能上并无实质的作用

一般情况下中需高雷函数 reverse 的参数 viewname 即可，如果路由地址设有变量，可自行设置参数 args 或 kwargs 来设置路由的变量值。但是 args 和 kwargs 不能同时设置，否则会提示 ValueError报错信息。

from django.urls import re_path, path
from . import views

urlpatterns = [
    path('', views.profile, name='userProfile'),
    path('login/', views.login, name='userLogin'),
    path('register/<str:a>', views.register, name='userRegister'),
]

from django.shortcuts import render, reverse
from django.urls import resolve


def home(request):
    result = reverse('user:userRegister',args=['a'])
    res = resolve(result)
    print(result) # /user/register/a
    print(res)
    return render(request, 'home.html')

同时设置报错

from django.shortcuts import render, reverse
from django.urls import resolve


def home(request):
    b=1
    result = reverse('user:userRegister',args=['a'],kwargs={'b':b})
    res = resolve(result)
    print(result)
    print(res)
    return render(request, 'home.html')

resolve#

源码

def resolve(path, urlconf=None):
    if urlconf is None:
        urlconf = get_urlconf()
    return get_resolver(urlconf).resolve(path)

函数 resolve 设有两个参数，path 是必选参数 ，urlfconf 是可选参数，参数说明如下：

• path：代表路由地址，通过路由地址来获取对应的路由对象信息。
• urlconf：设置反向解析的 URLconf模块。在默认情况下，使用配置 settings.py 的 ROOT_URLCONF属性
• 返回值如下：

ResolverMatch(func=user.views.register, args=(), kwargs={}, url_name='userRegister', app_names=['user'], namespaces=['user'], route='user/register/')

路由重定向#

from django.views.generic import  RedirectView
urlpatterns = [
    path('', views.home, name='home'),
    path('turnTo/', RedirectView.as_view(url='/'), name='turnTo'),
]

视图重定向#

• HttpResponseRedirect 状态码301，永久性跳转
• HttpResponsePermanentRedirect 状态码302，临时的跳转，搜索引擎认为新的网址只是暂时的
• 函数redirect

HttpResponseRedirect和HttpResponsePermanentRedirect的使用只需传入路由地址即可，不支持路由命名的传入，所以有了函数 redirect

源码

def redirect(to, *args, permanent=False, **kwargs):
    redirect_class = (
        HttpResponsePermanentRedirect if permanent else HttpResponseRedirect
    )
    return redirect_class(resolve_url(to, *args, **kwargs))
  
 def resolve_url(to, *args, **kwargs):
    # If it's a model, use get_absolute_url()
    if hasattr(to, "get_absolute_url"):
        return to.get_absolute_url()

    if isinstance(to, Promise):
        # Expand the lazy instance, as it can cause issues when it is passed
        # further to some Python functions like urlparse.
        to = str(to)

    # Handle relative URLs
    if isinstance(to, str) and to.startswith(("./", "../")):
        return to

    # Next try a reverse URL resolution.
    try:
        return reverse(to, args=args, kwargs=kwargs)
    except NoReverseMatch:
        # If this is a callable, re-raise.
        if callable(to):
            raise
        # If this doesn't "feel" like a URL, re-raise.
        if "/" not in to and "." not in to:
            raise

    # Finally, fall back and assume it's a URL
    return to

from django.shortcuts import render, reverse,redirect

def home(request):
    return redirect(reverse('user:userLogin'))

返回响应内容#

视图函数通过 return 方式返回响应内容，设置不同的响应方式，则需要使用Django 内置的响应类，如下表：

以上响应类主要来自模块Django.http

打开源码发现响应类都是在 HttpResponse 的基础上实现的，只不过他们的HTTP状态码有所不同。

render#

因为HttpResponse的使用过程要生成网页内容，就需要将 HTML 语言以字符串的形式表示，如果网页过大，就会增加视图函数的代码量，同时也没有体现模板的作用，因为 Django 在此基础上进行了封装处理，定义了函数 render 和 redirect。部分源码如下：

def render(
    request, template_name, context=None, content_type=None, status=None, using=None
):
    """
    Return an HttpResponse whose content is filled with the result of calling
    django.template.loader.render_to_string() with the passed arguments.
    """
    content = loader.render_to_string(template_name, context, request, using=using)
    return HttpResponse(content, content_type, status)


def redirect(to, *args, permanent=False, **kwargs):
    """
    Return an HttpResponseRedirect to the appropriate URL for the arguments
    passed.

    The arguments could be:

        * A model: the model's `get_absolute_url()` function will be called.

        * A view name, possibly with arguments: `urls.reverse()` will be used
          to reverse-resolve the name.

        * A URL, which will be used as-is for the redirect location.

    Issues a temporary redirect by default; pass permanent=True to issue a
    permanent redirect.
    """
    redirect_class = (
        HttpResponsePermanentRedirect if permanent else HttpResponseRedirect
    )
    return redirect_class(resolve_url(to, *args, **kwargs))

render 的 request 和 template_name 参数是必选参数，其余的是可选参数，各参数说明如下：

• request：浏览器向服务器发送的请求对象，包含用户信息、请求内容和请求方式等
• templaet_name：模板文件名，用于生成网页内容
• context：对模板上下文赋值中，以字典格式表示，默认情况下是一个空字典
• content_type：响应内容的数据格式，一般情况下使用默认值即可
• status：HTTP 状态码，默认为200
• using：设置模板引擎，用于解析模板文件，生成网页内容

异常响应#

异常响应是指 HTTP 状态码为404或500的响应状态，它与正常的响应过程是一样的，只是 HTTP 状态码有所不同。使用 render 函数作为响应过程，设置参数status 状态码为404或500即可实现异常响应

def home(request):
    return render(request, 'home.html', status=404)

def home(request):
    return render(request, 'home.html', status=500)

全局设置异常响应页面

urls.py

from django.contrib import admin
from django.urls import path, include


urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include(('index.urls', 'index'), namespace='index')),
]
handler404 = 'index.views.page_not_found'
handler500 = 'index.views.page_not_error'

views.py

from django.shortcuts import render
from django.http import Http404

def home(request):
    if request.GET.get('error',''):
        raise Http404('没有找到页面')
    return render(request, 'home.html')

def page_not_found(request,exception):
    return render(request, '404.html', status=404)

def page_not_error(request):
    return render(request, '500.html', status=500)

文件下载#

Django 提供了三种方式来实现下载功能，分别是 HttpResponse、StreamingHttpResponse 和 FileResponse

• HttpResponse 是所有响应过程的核心类，它的底层功能是 HttpResponseBase
• StreamingHttpResponse是在HttpResponseBase 基础上进行继承和重写的，实现流式响应输出，适用于大规模数据响应和文件传输响应
• FileResponse 是在 StreamingHttpResponse 的基础上进行继承和重写，实现文件的流式响应输出，只适用于文件传输响应

urls.py

from django.urls import path
from . import views

urlpatterns = [
    path('', views.home, name='home'),
    path('download/file1', views.download1, name='download1'),
    path('download/file2', views.download2, name='download2'),
    path('download/file3', views.download3, name='download3'),
]

views.py

from django.http import Http404, HttpResponse, StreamingHttpResponse, FileResponse


def home(request):
    return render(request, 'home.html')


def download1(request):
    file_path = '/Users/rh/Pictures/10.jpg'
    try:
        r = HttpResponse(open(file_path, 'rb'))
        r['content_type'] = 'application/octet-stream'
        r['Conntent-Disposition'] = 'attachment;filename=10.jpg'
        return r
    except Exception:
        raise Http404('下载错误')


def download2(request):
    file_path = '/Users/rh/Pictures/9.jpg'
    try:
        r = StreamingHttpResponse(open(file_path, 'rb'))
        r['content_type'] = 'application/octet-stream'
        r['Conntent-Disposition'] = 'attachment;filename=9.jpg'
        return r
    except Exception:
        raise Http404('下载错误')


def download3(request):
    file_path = '/Users/rh/Pictures/8.jpg'
    try:
        f = open(file_path, 'rb')
        r = FileResponse(f, as_attachment=True, filename='7.jpg')
        return r
    except Exception:
        raise Http404('下载错误')

以上三个都能实现下载，前两个都是以流的方式返回，第三个可以直接下载文件：

• HttpResponse实现文件下载存在很大的弊端，其工作原理是将文件读取并载入内存，然后输出到浏览器上实现下载功能。如果下载的文件较大，会占用很多内存，下载大文件 Django 推荐使用StreamingHttpResponse和FileResponse，这两个方法将下载文件分批写入服务器的本地磁盘，而不将文件载入服务器的内存。
• StreamingHttpResponse和FileResponse实现原理是一样的，都是把文件分批写入服务器的本地磁盘，实现文件的流式响应输出
• 从适用范围来说，StreamingHttpResponse适用范围更为广泛，可支持大规模数据或文件输出，而FileResponse只支持文件输出
• 从适用方式来说，StreamingHttpResponse支持数据格式或文件输出，因此在使用时需要设置响应输出类型和方式，而FileResponse只需要设置3个参数即可实现文件下载功能。