有需要上网现查现学的东西。

分页

  • 分页是指在web页面有大量数据需要显示，为了阅读方便在每个页页中只显示部分数据。
  • 好处:
    1. 方便阅读
    2. 减少数据提取量，减轻服务器压力。
  • Django提供了Paginator类可以方便的实现分页功能
  • Paginator类位于django.core.paginator 模块中。

Paginator对象

  • 负责分页数据整体的管理

  • 对象的构造方法

    • paginator = Paginator(object_list, per_page)
    • 参数
      • object_list 需要分类数据的对象列表
      • per_page 每页数据个数
    • 返回值:
      • Paginator的对象

  • Paginator属性

    • count：需要分类数据的对象总数
    • num_pages：分页后的页面总数
    • page_range：从1开始的range对象, 用于记录当前面码数
    • per_page 每页数据的个数

  • Paginator方法

    • page(number)
      • 参数 number为页码信息(从1开始)
      • 返回当前number页对应的页信息
      • 如果提供的页码不存在，抛出InvalidPage异常

  • Paginator异常exception

    • InvalidPage：总的异常基类，包含以下两个异常子类
      • PageNotAnInteger：当向page()传入一个不是整数的值时抛出
      • EmptyPage：当向page()提供一个有效值，但是那个页面上没有任何对象时抛出

Page对象

  • 负责具体某一页的数据的管理

  • 创建对象
    Paginator对象的page()方法返回Page对象

    1
    page = paginator.page(页码)

  • Page对象属性

    • object_list：当前页上所有数据对象的列表
    • number：当前页的序号，从1开始
    • paginator：当前page对象相关的Paginator对象

  • Page对象方法

    • has_next()：如果有下一页返回True
    • has_previous()：如果有上一页返回True
    • has_other_pages()：如果有上一页或下一页返回True
    • next_page_number()：返回下一页的页码，如果下一页不存在，抛出InvalidPage异常
    • previous_page_number()：返回上一页的页码，如果上一页不存在，抛出InvalidPage异常
    • len()：返回当前页面对象的个数

  • 说明:

    • Page 对象是可迭代对象,可以用 for 语句来 访问当前页面中的每个对象

  • 参考文档 https://docs.djangoproject.com/en/2.2/topics/pagination/

  • 分页示例:

    • 视图函数 
      1
      2
      3
      4
      5
      6
      7
      from django.core.paginator import Paginator
      def book(request):  
          bks = Book.objects.all()
          paginator = Paginator(bks, 10)
          cur_page = request.GET.get('page', 1)  # 得到默认的当前页
          page = paginator.page(cur_page)
          return render(request, 'bookstore/book.html', locals())

  • 模板设计

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
        <html>
        <head>
            <title>分页显示</title>
        </head>
        <body>
        {% for b in page %}
            <div>{{ b.title }}</div>
        {% endfor %}
        
        {% if page.has_previous %}
        <a href="{% url 'book' %}?page={{ page.previous_page_number }}">上一页</a>
        {% else %}
        上一页
    {% endif %}
        
        {% for p in paginator.page_range %}
            {% if p == page.number %}
                {{ p }}
            {% else %}
                <a href="{% url 'book' %}?page={{ p }}">{{ p }}</a>
            {% endif %}
    {% endfor %}
        
        {% if page.has_next %}
        <a href="{% url 'book' %}?page={{ page.next_page_number }}">下一页</a>
        {% else %}
        下一页
        {% endif %}
        </body>
    </html>

文件下载

Django可直接在视图函数中生成csv文件 并响应给浏览器

1
2
3
4
5
6
7
8
9
10
11
12
13
14
import csv
from django.http import HttpResponse
from .models import Book

def make_csv_view(request):
    response = HttpResponse(content_type='text/csv')
    response['Content-Disposition'] = 'attachment; filename="mybook.csv"'
	all_book = Book.objects.all()
    writer = csv.writer(response)
    writer.writerow(['id', 'title'])
    for b in all_book:    
    	writer.writerow([b.id, b.title])

    return response
  • 响应获得一个特殊的MIME类型text / csv。这告诉浏览器该文档是CSV文件，而不是HTML文件
  • 响应会获得一个额外的Content-Disposition标头，其中包含CSV文件的名称。它将被浏览器用于“另存为…”对话框
  • 对于CSV文件中的每一行，调用writer.writerow，传递一个可迭代对象，如列表或元组。

文件上传

  • 文件上传必须为POST提交方式

  • 表单<form>中文件上传时必须有带有enctype="multipart/form-data" 时才会包含文件内容数据。

  • 表单中用<input type="file" name="xxx">标签上传文件

    • 名字xxx对应request.FILES['xxx'] 对应的内存缓冲文件流对象。可通能过request.FILES['xxx'] 返回的对象获取上传文件数据
    • file=request.FILES['xxx'] file 绑定文件流对象，可以通过文件流对象的如下信息获取文件数据
      file.name 文件名
      file.file 文件的字节流数据

  • 上传文件的表单书写方式

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    <!-- file: index/templates/index/upload.html -->
    <html>
    <head>
        <meta charset="utf-8">
        <title>文件上传</title>
    </head>
    <body>
        <h3>上传文件</h3>
        <form method="post" action="/test_upload" enctype="multipart/form-data">
            <input type="file" name="myfile"/><br>
            <input type="submit" value="上传">
        </form>
    </body>
    </html>

  • 在setting.py中设置MEDIA相关配置；Django把用户上传的文件，统称为media资源

    1
    2
    3
    # file : settings.py
    MEDIA_URL = '/media/'
    MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

  • 在当前项目文件夹下创建 media 文件夹

    1
    $ mkdir media

  • 上传文件的视图处理函数 方案1 传统写入

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    # file views.py
    from django.http import HttpResponse
    from django.conf import settings
    from django.views.decorators.csrf import csrf_exempt
    import os

    @csrf_exempt
    def upload_view(request):
        if request.method == 'GET':
            return render(request, 'test_upload.html')
        elif request.method == "POST":
            a_file = request.FILES['myfile']
            print("上传文件名是:", a_file.name)
            filename =os.path.join(settings.MEDIA_ROOT, a_file.name)
            with open(filename, 'wb') as f:
                data = a_file.file.read()
                f.write(data)  
            return HttpResponse("接收文件:" + a_file.name + "成功")

  • 上传文件的视图处理函数 方案2 借助orm

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    #test_upload/models.py
    from django.db import models
      
    # Create your models here.
    class Content(models.Model):

        desc = models.CharField(max_length=100)
        myfile = models.FileField(upload_to='myfiles')

    #test_upload/views.py
    from test_upload.models import *
    from django.views.decorators.csrf import csrf_exempt

    @csrf_exempt
    def upload_view_dj(request):
        if request.method == 'GET':
            return render(request, 'test_upload.html')
        elif request.method == 'POST':
            title = request.POST['title']
            a_file = request.FILES['myfile']
            Content.objects.create(desc=title,myfile=a_file)
            return HttpResponse('----upload is ok-----')

  • 若要在浏览器中访问 上传的资源，runserver环境下，需要在项目得主路由下添加media路由的绑定

    1
    2
    3
    from django.conf import settings
    from django.conf.urls.static import static
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

    浏览器可以访问 http://127.0.0.1:8000/media/xxxx

Django中的用户认证 (使用Django认证系统)

  • Django带有一个用户认证系统。 它处理用户账号、组、权限以及基于cookie的用户会话。

  • 作用:

    1. 添加普通用户和超级用户
    2. 修改密码

  • 文档参见

  • User模型类

    • 位置: from django.contrib.auth.models import User

    • 默认user的基本属性有：

      属性名 类型 是否必选
      username 用户名 是
      password 密码 是
      email 邮箱 可选
      first_name 名
      last_name 姓
      is_superuser 是否是管理员帐号(/admin)
      is_staff 是否可以访问admin管理界面
      is_active 是否是活跃用户,默认True。一般不删除用户，而是将用户的is_active设为False。
      last_login 上一次的登录时间
      date_joined 用户创建的时间

auth基本模型操作:

  • 创建用户
    • 创建普通用户create_user 
      1
      2
      3
      from django.contrib.auth.models import User
      user = User.objects.create_user(username='用户名', password='密码', email='邮箱',...)

    • 创建超级用户create_superuser 
      1
      2
      from django.contrib.auth.models import User
      user = User.objects.create_superuser(username='用户名', password='密码', email='邮箱',...)
  • 删除用户 
    1
    2
    3
    4
    5
    6
    7
    8
    9
    from django.contrib.auth.models import User
    try:
        user = User.objects.get(username='用户名')
        user.is_active = False  # 记当前用户无效
        user.save()
        print("删除普通用户成功！")
    except:
        print("删除普通用户失败")

  • 修改密码set_password 
    1
    2
    3
    4
    5
    6
    7
    8
    from django.contrib.auth.models import User
    try:
        user = User.objects.get(username='xiaonao')
        user.set_password('654321')
        user.save()
        return HttpResponse("修改密码成功！")
    except:
        return HttpResponse("修改密码失败！")
  • 检查密码是否正确check_password 
    1
    2
    3
    4
    5
    6
    7
    8
    9
    from django.contrib.auth.models import User
    try:
        user = User.objects.get(username='xiaonao')
        if user.check_password('654321'):  # 成功返回True,失败返回False
            return HttpResponse("密码正确")
        else:
            return HttpResponse("密码错误")
    except: 
        return HttpResponse("没有此用户！")

auth扩展字段

如果需要在默认auth表上扩展新的字段，如phone

  1. 添加新的应用
  2. 定义模型类 继承 AbstractUser
  3. settings.py中 指明 AUTH_USER_MODEL = ‘应用名.类名’
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
#models.py案例
from django.db import models
from django.contrib.auth.models import AbstractUser

# Create your models here.
class UserInfo(AbstractUser):

    phone = models.CharField(max_length=11, default='')
    
#settings.py添加配置
AUTH_USER_MODEL = 'user.UserInfo'

#添加用户
from user.models import UserInfo
UserInfo.objects.create_user(username='guoxiao', password='123456', phone='13488871101')

电子邮件发送

  • 利用QQ邮箱发送电子邮件
  • django.core.mail 子包封装了 电子邮件的自动发送SMTP协议
  • 前其准备:
    1. 申请QQ号
    2. 用QQ号登陆QQ邮箱并修改设置
      • 用申请到的QQ号和密码登陆到 https://mail.qq.com/
      • 修改 QQ邮箱->设置->帐户->“POP3/IMAP......服务”
    3. 设置Django服务器端的，用简单邮件传输协议SMTP(Simple Mail Transfer Protocol) 发送电子邮件
  • settings.py 设置
1
2
3
4
5
6
7
# 发送邮件设置
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend' # 固定写法
EMAIL_HOST = 'smtp.qq.com' # 腾讯QQ邮箱 SMTP 服务器地址
EMAIL_PORT = 25  # SMTP服务的端口号
EMAIL_HOST_USER = 'xxxx@qq.com'  # 发送邮件的QQ邮箱
EMAIL_HOST_PASSWORD = '******'  # 在QQ邮箱->设置->帐户->“POP3/IMAP......服务” 里得到的在第三方登录QQ邮箱授权码
EMAIL_USE_TLS = True  # 与SMTP服务器通信时，是否启动TLS链接(安全链接)默认false

视图函数中

1
2
3
4
5
6
7
from django.core import mail
mail.send_mail(
            subject,  #题目
            message,  # 消息内容
            from_email,  # 发送者[当前配置邮箱]
            recipient_list=['xxx@qq.com'],  # 接收者邮件列表
            )

项目部署

  • 项目部署是指在软件开发完毕后，将开发机器上运行的开发板软件实际安装到服务器上进行长期运行
  • 部署要分以下几个步骤进行

    1. 在安装机器上安装和配置同版本的环境

    2. django 项目迁移

      $ sudo scp 当前项目源代码 远程主机地址和文件夹

      1
      2
      sudo scp /home/tarena/django/mysite1 root@88.77.66.55:/home/root/xxx
      请输入root密码：

    3. 用 uwsgi 替代python3 manage.py runserver 方法启动服务器

    4. 配置 nginx 反向代理服务器

    5. 用nginx 配置静态文件路径,解决静态路径问题

uWSGI 网关接口配置 (ubuntu 18.04 配置)

  • WSGI (Web Server Gateway Interface)Web服务器网关接口，是Python应用程序或框架和Web服务器之间的一种接口，被广泛使用

  • 使用 python manage.py runserver 通常只在开发和测试环境中使用。

  • 当开发结束后，完善的项目代码需要在一个高效稳定的环境中运行，这时可以使用WSGI

  • uWSGI是WSGI的一种, 它实现了 http协议 WSGI协议 以及 uwsgi协议

  • 安装uWSGI

    • 终端输入如下命令

      1
      sudo pip3 install uwsgi==2.0.18 -i https://pypi.tuna.tsinghua.edu.cn/simple/

    • 检查是否安装成功

      1
      2
      3
      sudo pip3 freeze|grep -i 'uwsgi'
      #如果成功安装，则会输出
      uWSGI==2.0.18

  • 配置uWSGI

    • 添加配置文件 项目同名文件夹/uwsgi.ini

      • 如: mysite1/mysite1/uwsgi.ini 
        1
        2
        3
        4
        5
        6
        7
        8
        9
        10
        11
        12
        13
        14
        15
        16
        17
        18
        19
            [uwsgi]
            # 套接字方式的 IP地址:端口号
            # socket=127.0.0.1:8000
            # Http通信方式的 IP地址:端口号
            http=127.0.0.1:8000
            # 项目当前工作目录
            chdir=/home/tarena/.../my_project 这里需要换为项目文件夹的绝对路径
            # 项目中wsgi.py文件的目录，相对于当前工作目录
            wsgi-file=my_project/wsgi.py
            # 进程个数
            process=4
            # 每个进程的线程个数
            threads=2
            # 服务的pid记录文件
            pidfile=uwsgi.pid
            # 服务的目志文件位置
            daemonize=uwsgi.log
            # 开启主进程管理模式
        master=true

    • 修改settings.py将 DEBUG=True 改为DEBUG=False

    • 修改settings.py 将ALLOWED_HOSTS = [] 改为ALLOWED_HOSTS = [‘网站域名’] 或者 [‘服务监听的ip地址’]

  • uWSGI的运行管理

    • 启动 uwsgi

      1
      2
      $ 进入到项目同名文件夹下 【即settings.py所在目录】
      $ sudo uwsgi --ini uwsgi.ini

    • 停止 uwsgi

      1
      2
      $ 进入到项目同名文件夹下 【即settings.py所在目录】
      $ sudo uwsgi --stop uwsgi.pid

    • 说明:

      • 当uwsgi 启动后,当前django项目的程序已变成后台守护进程,在关闭当前终端时此进程也不会停止。

      • 若执行 stop 操作失败，则需要执行如下操作杀死进程

        1
        2
        3
        4
        5
        6
        ps aux|grep 'uwsgi'  -> 查看uwsgi进程

        tarena   103408  0.0  0.9 137172 39984 ?        S    10:02   0:01 uwsgi --ini uwsgi.ini
        tarena   103410  0.0  0.9 436200 38552 ?        Sl   10:02   0:00 uwsgi --ini uwsgi.ini

        ps -ef | grep 'uwsgi' | grep -v grep | awk '{print $2}' | xargs sudo kill -9

  • 测试:

nginx 及反向代理配置

  • Nginx是轻量级的高性能Web服务器，提供了诸如HTTP代理和反向代理、负载均衡、缓存等一系列重要特性，在实践之中使用广泛。

  • C语言编写，执行效率高

  • nginx 作用

    • 负载均衡， 多台服务器轮流处理请求
    • 反向代理

  • 原理:

  • 客户端请求nginx,再由nginx 将请求转发 uWSGI 运行的django

  • ubuntu 下 nginx 安装
    $ sudo apt install nginx

    1
    2
    3
    vim /etc/apt/sources.list
    更改国内源
    sudo apt-get update

  • nginx 配置

    • 修改nginx 的配置文件 /etc/nginx/sites-enabled/default 
      1
      2
      3
      4
      5
      6
      7
      8
      9
      # 在server节点下添加新的location项，指向uwsgi的ip与端口。
      server {
          ...
          location / {
              uwsgi_pass 127.0.0.1:8000;  # 重定向到127.0.0.1的8000端口
              include /etc/nginx/uwsgi_params; # 将所有的参数转到uwsgi下
          }
          ...
      }

  • nginx服务控制

    1
    2
    3
    $ sudo /etc/init.d/nginx start|stop|restart|status
    # 或
    $ sudo service nginx start|stop|restart|status

    通过 start,stop,restart,status 可能实现nginx服务的启动、停止、重启、操作

  • 修改uWSGI配置

    • 修改项目同名文件夹/uwsgi.ini下的Http通信方式改为socket通信方式

      1
      2
      3
      4
      5
      [uwsgi]
      # 去掉如下
      # http=127.0.0.1:8000
      # 改为
      socket=127.0.0.1:8000

    • 重启uWSGI服务

      1
      2
      3
      进入到 项目同名文件夹下
      $ sudo uwsgi --stop uwsgi.pid
      $ sudo uwsgi --ini uwsgi.ini

    • 测试:

      • 在浏览器端输入http://127.0.0.1 进行测试

      • 注意 ：

        1，此时端口号为80(nginx默认值)

        2，Django中有任何修改 需要重启 uwsgi , 否则修改不生效

nginx 配置静态文件路径

  • 创建新路径-主要存放Django所有静态文件 如： /home/tarena/项目名_static/

  • 在Django settings.py 中添加新配置

    1
    2
    STATIC_ROOT = '/home/tarena/项目名_static/static  
    #注意 此配置路径为 存放所有正式环境中需要的静态文件

  • 进入项目，执行 python3 manage.py collectstatic 。执行该命令后，Django将项目重所有静态文件 复制到 STATIC_ROOT 中 ，包括Django内建的静态文件【如admin后台的样式】

  • Nginx配置中添加新配置

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    # file : /etc/nginx/sites-enabled/default
    # 新添加location /static 路由配置，重定向到指定的 第一步创建的路径即可
    server {
        ...
        location /static {
            # root 第一步创建文件夹的绝对路径,如:
             root /home/tarena/项目名_static;          
        }
        ...      
    }

404/500 界面

  • 在模板文件夹内添加 404.html 模版，当视图触发Http404 异常时将会被显示
  • 404.html 仅在发布版中(即setting.py 中的 DEBUG=False时) 才起作用
  • 当向应处理函数触发Http404异常时就会跳转到404界面
1
2
3
from django.http import Http404
def xxx_view( ):
    raise Http404  # 直接返回404

邮件告警

  • 当正式服务器上代码运行有报错时，可将错误追溯信息发至指定的邮箱

  • 配置如下 settings.py中

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    #在基础邮件配置之后 添加如下

    #关闭调试模式
    DEBUG = False  

    #错误报告接收方
    ADMINS = [('guoxiaonao', 'xxxx@example.com'), ('wanglaoshi', 'xxxx@example.com')]

    #发送错误报告方，默认为 root@localhost账户，多数邮件服务器会拒绝
    SERVER_EMAIL = 'email配置中的邮箱'


  • 过滤敏感信息

报错邮件中会显示一些错误的追踪，这些错误追踪中会出现如 password等敏感信息，Django已经将配置文件中的敏感信息 过滤修改为 多个星号，但是用户自定义的视图函数需要用户手动过滤敏感信息

1，视图函数中的局部变量

1
2
3
4
5
6
7
8
9
10
11
12
13
from django.views.decorators.debug import sensitive_variables

@sensitive_variables('user', 'pw', 'cc')
def process_info(user):
    pw = user.pass_word
    cc = user.credit_card_number
    name = user.name
    ...
#注意：
#1 若报错邮件中牵扯到user,pw,cc等局部变量的值，则会将其替换成  *****, 而 name 变量还显示其真实值
#2 多个装饰器时，需要将其放在最顶部
#3 若不传参数，则过滤所有局部变量的值

2，POST提交中的数据

1
2
3
4
5
6
7
from django.views.decorators.debug import sensitive_post_parameters

@sensitive_post_parameters('password', 'username')
def index(request):
    s = request.POST['username'] + request.POST['abcd']
	#'abcd' 并不存在，此时引发error
#POST中 username 及 password的值会被替换成  ******