读《Flask Web开发实战》（狼书）笔记 | 第1、2章

news2024/11/28 11:32:54

前言

2023-8-11

以前对网站开发萌生了想法，又有些急于求成，在B站照着视频敲了一个基于flask的博客系统。但对于程序的代码难免有些囫囵吞枣，存在许多模糊或不太理解的地方，只会照葫芦画瓢。

而当自己想开发一个什么网站的时，就如同摸着石头过河，常在许多小问题上卡住，不知怎么实现，也不知道需要去学习什么才能实现。例如，要做一个聊天室程序，我却不知道在一方发出消息时，如何在另一方实时地显示出来，思虑许久而终归于放弃。

学习系统且详细的知识有其好处，它可以冲退我那种徒手在黑暗中摸索的感觉。读了“狼书”的两个章节，自觉很有收获，此前的许多疑惑也得到了解答。然凡事各有弊益，啃书不是易事，还需下苦功夫。

曾有人对我说，看视频会更有效率。也许他是对的？但我好像更喜欢书籍给我的感觉。但有些讽刺的是，大学至今，我却也没看下来多少书，而时间在我休息的时候，它仍努力奔跑，两载一晃而过。而不少人，也是这相似的困境吧？

回到本文，它是一篇读书笔记，参杂少许个人想法但含量不高，所记零散，主要是作为个人提纲备忘，或许对诸位而言阅读价值不高。若想学习 Flask 框架，我还是很推荐去读“狼书”原著的。

文章目录

    • 前言
    • 开始
      • Git使用
    • 1 初识Flask
      • 1.1 搭建开发环境
      • 1.2 简单示例
    • 2 Flask与HTTP
      • 2.1 重定向回上一个页面
      • 2.2 使用AJAX技术发送异步请求
      • 2.3 HTTP服务器推送
      • 2.4 Web安全防范

开始

5个难度递增的案例：留言板SayHello，个人博客Bluelog，图片社交网站Albumy，待办事项程序Todoism，聊天室CatChat。

前端学习：

在这里插入图片描述

Web很多程序离不开javascript，它可以方便、简洁地实现很多页面按逻辑和功能。

了解Git：https://try.github.io/

文本编辑器：

在这里插入图片描述

作者的博客：http://greyli.com

Git使用

克隆本书代码仓库：

git clone https://github.com/greyli/helloflask.git

查看当前项目仓库中包含的所有标签：

git tag -n

签出对应标签版本的代码：

git checkout foo

签出前对文件做了修改，需要撤销：

git reset --hard

使用diff命令比较两个标签对应版本之间的变化：

git diff foo bar

使用git客户端直观查看版本变化：

gitk

定期使用git fetch命令来更新本地仓库：

git fetch --all
git fetch --tags
git reset --hard origin/master

在本地复制新的派生仓库，后可以在本地自由修改其中的代码：

git clone https://github.com/你的用户名/helloflask.git

1 初识Flask

Web框架可以让我们不用关心底层的请求响应处理，更方便地编写Web程序。

两个主要依赖：（p3）

  • WSGI（Web Server Gateway Interface，Web服务器网关接口）的工具集——Werkzeug（http://werkzeug.pocoo.org/）
  • Jinja2模板引擎

1.1 搭建开发环境

Pipenv：pip的加强版，让包安装、包依赖管理、虚拟环境管理更加方便。

创建虚拟环境：在项目根目录（即helloflask文件夹中），使用pipenv install命令。Pipfile文件列出的依赖包也会一并被安装。

在这里插入图片描述

显示激活虚拟环境：Pipenv会自动从项目目录下的.env文件中加载环境变量。

# 激活
pipenv shell
# 退出
exit

临时使用虚拟环境中的python解释器：（更推荐）

pipenv run python hello.py

查看当前环境下的依赖情况：

pipenv graph

关于Pipfile项目的更多情况，请访问其主页。

使用pipenv install命令安装包时，都是安装到虚拟环境中。相当于使用pip在激活虚拟环境的情况下安装包。

在这里插入图片描述

更新flask版本：(书中为flask-1.0.2)

pipenv update flask

集成开发环境：pycharm专业版提供了更多针对Flask开发的功能，比如创建Flask项目模板，Jinja2语法高亮，与Flask命令行功能集成等。

设置Python解释器（好像已经不需要了）：因为PyCharm未集成支持Pipenv。（p10）

1.2 简单示例

from flask import Flask
app = Flask(__name__)

@app.route('/')
def index():
    return '<h1>Hello Flask!</h1>'

Flask类表示一个Flask程序，实例化这个类就得到了我们的程序实例app。__name__对于文件app.py而言，值即为“app”，它帮助Flask在相应的文件夹里找到需要的资源，比如模板和静态文件。（p12）

注册路由：路由负责管理URL和函数之间的映射。

  • 一个视图函数可以绑定多个路由。
  • 动态路由：可以传递参数，并可设置默认参数。

在这里插入图片描述

注：Flask内置一个开发服务器，但在实际生产环境中需要使用性能更好的生产服务器。

启动开发服务器：

# 未启动虚拟环境下使用
pipenv run flask run
# 在虚拟环境中
flask run
# 命令未找到
python -m flask run

app.run()方法也可启动开发服务器，已经不推荐使用。

flask寻找程序实例：

  • 在当前目录下，名为app.py或wsgi.py的文件中寻找名为app的程序实例。
  • 根据环境变量FLASK_APP寻找。
# 在linux
$ export FLASK_APP=hello
# 在windows
> set FLASK_APP=hello

管理环境变量：使用python-dotenv包，从.env或.flaskenv文件加载。其中.env文件存放一些敏感数据。

pipenv install python-dotenv

可在.flaskenv写入：

# 默认为production(生产环境)，开发模式将打开调试器和重载器。
FLASK_ENV=development

使用Pycharm的运行配置（而不使用命令行）：在Run --> Edit Configurations（p19）

使服务器外部可见：让局域网用户可以通过你的内网IP进行访问。想要公网访问，可以考虑内网穿透工具、端口转发工具等，如 ngrok、Localtunnel。

flask run --host=0.0.0.0

flask的环境变量：可通过FLASK_<COMMAND>_<OPTION>设置各种选项。

重载器：安装 Watchdog。Werkzeug内置有stat重载器，但耗电严重且准确性一般。

# dev: 开发依赖的包
pipenv install watchdog --dev

打开PythonShell：使用flask打开的shell自动包含程序上下文，并且已经导入了app实例。

flask shell

Flask扩展：使用Flask提供的接口编写的Python库。扩展可以加速开发，但也会降低灵活性，并可能存在bug。

Flask项目配置：可能用到Flask提供的配置、扩展提供的、程序特定的配置。它们用Flask对象的app.config属性作为统一的接口。

  • Flask配置章节：https://flask.pocoo.org/docs/latest/config/
app.config['ADMIN_NAME'] = 'Peter'
# 一次加载多个值
app.config.update()方法

URL：使用url_for()，方便url规则的修改。

  • 相对url与绝对url（p24）

自定义Flask命令：

  • Click官方文档（自定义命令）：http://click.pocoo.org/6/
@app.cli.command()
def hello():
    click.echo('Hello, Human!')

> flask hello
Hello, Human!

视图函数之名：可以溯源至MVC架构，即”模型 - 视图 - 控制器”。但flask并不是MVC架构的框架，因为没有内置数据模型的功能（需使用扩展），视图函数成为控制器函数才更加合适。（p28）

2 Flask与HTTP

request对象常用的属性和方法：（p43）

Response类常用属性和方法：（p48）

查看路由列表：这个列表由app.url_map解析得到。其中static为Flask添加的特殊路由，用来访问静态文件。

> flask routes

Flask内置的URL变量转换器：（p37）

URL规则中的转换器：<转换器:变量名>，

@app.route('goback/<int:year>')
def go_back(year):
    return '<p>Welcome to %d!</p>' % (2018 - year)

请求钩子：也称回调函数，可以用来注册在请求处理的不同阶段执行的处理函数，如预处理、后处理，它们使用装饰器 实现。（p58）

响应：大多数情况下，我们只负责返回响应的主体内容（而不负责首部及各种字段）。Flask会调用make_response()方法将视图函数返回值转换为响应对象。当然，响应也可以包含响应主体、状态码、首部字段 三个部分内容。

可使用redirect(<url字符串>)方法重定向。

@app.route('/')
def hello_flask():
    return '', 302, {'Location':'https://www.baidu.com'}

注：状态码不可儿戏，如将上面的302改为202，则重定向会失效。

错误响应：在视图函数中使用abort(<状态码>)，例如：

@app.route('/404')
def not_found():
    abort(404)

响应格式：在 HTTP 响应中，数据可以通过多种格式传输，默认为 HTML。可以设置不同的 MIME 类型来标识不同的数据格式，MIME 类型在 Content-Type 字段中定义。

# method 1 - 修改响应对象的属性
# @plain 纯文本
from flask import make_response
...
response = make_response("hello")
response.mimetype = 'text/plain'
# method 2 - 设置首部字段
response.headers['Content-Type'] = 'text/html; charset=utf-8'

  • XML：application/xml，一般作为 AJAX 请求的响应格式，或是 Web API 的响应格式。

  • JSON：application/json，指 JavaScript Object Notation（JavaScript对象表示法），更轻量、易解析。

    json模块的dumps()方法，可以将python中的字典、列表、元组数据序列化为json字符串。

# 1 - python标准库的json模块
response = make_response(json.dumps(data))
response.mimetype = 'application/json'
return response
# 2 - 使用flask包装的jsonify()函数
return jsonify(data)

Cookie：HTTP 是无状态协议。Cookie是保存在浏览器上的小型文本数据，保存一定时间，在下一次向同一个服务器发送请求时附带这些数据。但明文存储存在安全隐患。

使用set_cookie()方法设置（参数见p68），从cookies属性获取。

Session：在Flask中，session对象用来存储加密的cookie。

  • 设置程序密钥：通过Flask.secret_key属性；或环境变量SECRET_KEY（可保存在.env文件），在脚本中通过getenv()方法获取。
import os
app.secret_key = os.getenv('SECRET_KEY', 'secret string')

疑问：写进了环境变量还需再脚本中手动获取？那我随便用个环境变量名称是不是也可以？

疑问：看不懂：使用session对象存储的Cookie，用户可以看到其加密后的值，但无法修改它。因为session中的内容使用密钥进行签名，一旦数据被修改，签名的值也会变化。这样再读取时，就会验证失败，对应的session值也会失效。 （p51）

  • session cookie的保存时间：

在这里插入图片描述

上下文：Flask中有两种上下文：程序上下文 和请求上下文 。

两种上下文在视图函数中都会自动激活，这也意味折一些依赖于上下文的函数只能在视图函数中使用，如url_for()、jsonify()等。

也可手动激活程序上下文：

>>> from app import app
>>> from flask import current_app

# 方法1
>>> with app.app_context():
    ... current_app.name
   
# 方法2
>>> app_ctx = app.app_context()
>>> app_ctx.push()
>>> current_app.name
>>> app_ctx.pop()

# 激活请求上下文类似
>>> from app import app
>>> from flask import request
>>> with app.test_request_context('/hello'):
    ...

在这里插入图片描述

疑惑：g、request等对象如何区分不同的客户端？

上下文钩子：使用它注册的回调函数会在程序上下文被销毁时调用。

@app.teardown_appcontext
def teardown_db(exception):
    ...
    db.close()

2.1 重定向回上一个页面

利用referrer或URL的查询参数。（p59）

referrer：即访问来源。当用户在某个站点单击链接，浏览器向新链接所在的服务器发起请求，请求的数据中包含的HTTP_REFERER字段记录了用户所在的原站点URL。

疑惑：书中判断url是否安全的代码（如下）使我困惑了许久：既然test_url中也与request.host_url做了拼接，那最后的netloc不是必然相同吗？

后来我查找了urljoin(base, url)函数的处理机制：

  • 如果url是一个相对URL，那么urljoin会从url中获取路径部分，并于base中获取的部分合并；
  • 如果url是一个绝对URL，则urljoin会直接返回url。

那么在什么情况下，is_safe_url函数的返回值才为False呢？

  • 首先，target是一个绝对URL。
  • 同时，该绝对URL的协议或主机不是本机。

综上，还是感觉该函数的逻辑写得有些隐晦了，不便于理解（肯定不能是我太笨）。

def is_safe_url(target):
    ref_url = urlparse(request.host_url)
    test_url = urlparse(urljoin(request.host_url, target))
    return test_url.scheme in ('http', 'https') and \
           ref_url.netloc == test_url.netloc

2.2 使用AJAX技术发送异步请求

jQuery中和AJAX相关的方法和具体用法：http://api.jquery.com/category/ajax/

前言

在传统的Web应用中，程序的操作都是基于请求响应循环来实现的。每当页面状态需要变动，或是需要更新数据时，都伴随折一个发向服务器的请求。当服务器响应时，整个页面会重载，并渲染新页面。

频繁更新页面会牺牲性能，且影响用户体验。

AJAX是指异步Javascript和XML（Asynchronous JavaScript And XML），是一系列技术的组合体，如XMLHttpRequest、JavaScript、DOM。它让Web程序更像是程序，而非一堆用链接和按钮链接起来的网页资源。

可以使用 jQuery 实现AJAX操作：函数ajax()可以发送AJAX请求。

在这里插入图片描述

2.3 HTTP服务器推送

推送技术对比：https://stackoverflow.com/a/12855533/5511489

  • 传统轮询
  • 长轮询
  • SSE（Server-Sent Events）
  • Websocket

2.4 Web安全防范

OWASP（Open Web Application Security Project，开放式Web程序安全项目）：https://www.owasp.org 。（p66）

常见攻击方式：

  • 注入攻击
  • XSS攻击（Cross-Site Scripting，跨站脚本）：将代码注入被攻击者的网站
  • CSRF攻击：（Cross Site Request Forgery，跨站请求伪造）：伪造用户的登陆状态。

提示：虽然在实际开发中，通过在”删除“按钮中加入链接来删除资源非常方便，但安全问题应该作为编写代码时的第一考量，应该将这些按钮内嵌在使用了POST方法的form元素中。攻击者就无法通过GET请求来修改用户的数据。

疑惑：未理解csrf攻击的防御原理。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/866663.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

限流在不同场景的最佳实践

限流在不同场景的最佳实践

目录导读 限流在不同场景的最佳实践1. 前言2. 为什么要限流3. 有哪些限流场景3.1 限流场景分类3.2 限流与熔断降级之间的关系3.3 非业务限流3.4 业务限流 4. 有哪些限流算法4.1 计数器限流算法4.2 漏桶限流算法4.3 令牌桶限流算法4.4 滑动时间窗限流算法4.5 限流算法选型 5. 限…
阅读更多...
【数据结构与算法】稀疏数组

【数据结构与算法】稀疏数组

文章目录 一&#xff1a;为什么会使用稀疏数组1.1 先看一个实际的需求1.2 基本介绍1.2.1 稀疏数组的处理方法1.2.2 数组的举例说明1.2.3 应用实例1.2.4 整体思路分析二维数组转稀疏数组的思路稀疏数组转原始的二维数组的思路 二&#xff1a;代码实现2.1 创建一个原始的11*11二维…
阅读更多...
​LeetCode解法汇总1572. 矩阵对角线元素的和

​LeetCode解法汇总1572. 矩阵对角线元素的和

目录链接&#xff1a; 力扣编程题-解法汇总_分享记录-CSDN博客 GitHub同步刷题项目&#xff1a; https://github.com/September26/java-algorithms 原题链接&#xff1a;力扣&#xff08;LeetCode&#xff09;官网 - 全球极客挚爱的技术成长平台 描述&#xff1a; 给你一个正…
阅读更多...
探秘金和OA：解析任意文件读取漏洞的潜在威胁

探秘金和OA：解析任意文件读取漏洞的潜在威胁

是喜是悲&#xff0c;但可以慰藉的是&#xff0c;你总不枉在这世界上活了一场&#xff0c;有了这样的认识&#xff0c;你就会珍重生活&#xff0c;而不会玩世不恭&#xff1b;同时也会给人自身注入一种强大的内在力量…… 漏洞复现 访问url&#xff1a; 构造payload /C6/Jh…
阅读更多...
【网络编程（二）】NIO快速入门

【网络编程（二）】NIO快速入门

NIO Java NIO 三大核心组件 Buffer&#xff08;缓冲区&#xff09;&#xff1a;每个客户端连接都会对应一个Buffer&#xff0c;读写数据通过缓冲区读写。Channel&#xff08;通道&#xff09;&#xff1a;每个channel用于连接Buffer和Selector&#xff0c;通道可以进行双向读…
阅读更多...
日常问题——使用Java转将long类型为date类型，日期是1970年

日常问题——使用Java转将long类型为date类型，日期是1970年

&#x1f61c;作 者&#xff1a;是江迪呀✒️本文关键词&#xff1a;日常BUG、BUG、问题分析☀️每日 一言 &#xff1a;存在错误说明你在进步&#xff01; 一、问题描述 long类型的日期为&#xff1a;1646718195 装换为date类型&#xff1a; Date date new Dat…
阅读更多...
SQL | 使用函数处理数据

SQL | 使用函数处理数据

8-使用函数处理数据 8.1-函数 SQL可以用函数来处理数据。函数一般是在数据上执行的&#xff0c;为数据的转换和处理提供了方便。 8.1.1 函数带来的问题 每种DBMS都有特定的函数&#xff0c;只有很少一部分函数&#xff0c;是被所有主要的DBMS等同的支持。 虽然所有的类型的…
阅读更多...
Linux 基础（五）常用命令-文件属性

Linux 基础（五）常用命令-文件属性

文件属性 文件权限文件属性修改文件权限属性 文件所有者 文件权限 文件属性 Linux中文件权限 可以通过文件属性体现&#xff1b; 使用 ll 查看文件列表 最前面的 l d 表示文件类型 1 5 表示硬链接数 或者 子文件夹个数 所属用户 所属用户组 文件大小 创建/更新时间 文件&…
阅读更多...
【前端二次开发框架关于关闭eslint】

【前端二次开发框架关于关闭eslint】

前端二次开发框架关于关闭eslint 方法一方法二方法三方法四&#xff1a;以下是若想要关闭项目中的部分代码时&#xff1a; 方法一 在vue.config.js里面进行配置&#xff1a; module.exports {lintOnSave:false,//是否开启eslint保存检测 ,它的有效值为 true || false || err…
阅读更多...
一个简单实用的线程池及线程池组的实现！

一个简单实用的线程池及线程池组的实现！

1.线程池简介 线程池&#xff0c;顾名思义&#xff0c;就是一个“池子”里面放有多个线程。为什么要使用线程池呢&#xff1f;当我们编写的代码需要并发异步处理很多任务时候&#xff0c;一般的处理办法是一个任务开启一个线程去处理&#xff0c;处理结束后释放线程。可是这样…
阅读更多...
Docker安装 Kibana

Docker安装 Kibana

目录 前言安装Kibana步骤1&#xff1a;准备1. 安装docker2. 搜索可以使用的镜像。3. 也可从docker hub上搜索镜像。4. 选择合适的redis镜像。 步骤2&#xff1a;拉取 kibana 镜像拉取镜像查看已拉取的镜像 步骤3&#xff1a;创建容器创建容器方式1&#xff1a;快速创建容器 步骤…
阅读更多...
vue父页面给iframe子页面传值

vue父页面给iframe子页面传值

在vue父页面有两个个参数 名称和图标&#xff0c;需要把这两个参数传到iframe的地图里面&#xff0c;在地图触发绘点事件的时候&#xff0c;获取到传来的参数并且展示 vue:传值给子页面iframe // 传值给子页面iframe(2个参数)handleIframeLoad() {const iframeWindow this.$re…
阅读更多...
海康威视iVMS综合安防系统任意文件上传(0Day)

海康威视iVMS综合安防系统任意文件上传(0Day)

漏洞描述 攻击者通过请求/svm/api/external/report接口任意上传文件，导致获取服务器webshell权限，同时可远程进行恶意代码执行。 免责声明 技术文章仅供参考，任何个人和组织使用网络应当遵守宪法法律，遵守公共秩序，尊重社会公德，不得利用网络从事危害国家安全、荣誉和…
阅读更多...
安全第二次

安全第二次

一&#xff0c;iframe <iframe>标签用于在网页里面嵌入其他网页。 1&#xff0c;sandbox属性 如果嵌入的网页是其他网站的页面&#xff0c;因不了解对方会执行什么操作&#xff0c;因此就存在安全风险。为了限制<iframe>的风险&#xff0c;HTML 提供了sandb…
阅读更多...
HCIA---动态路由---RIP协议

HCIA---动态路由---RIP协议

提示&#xff1a;文章写完后&#xff0c;目录可以自动生成&#xff0c;如何生成可参考右边的帮助文档 文章目录 目录 前言 一.动态路由 二.动态路由协议分类 IGP&#xff1a;内部网关协议 EGP:外部网关协议 三.RIP协议概述 RIP版本分类&#xff1a; RIP三要素&#xff1a; 思维…
阅读更多...
TypeScript 关于对【泛型】的定义使用解读

TypeScript 关于对【泛型】的定义使用解读

目录 概念导读泛型函数多个泛型参数泛型约束泛型别名泛型接口泛型类总结&#xff1a; 概念导读 泛型&#xff08;Generics&#xff09;是指在定义函数、接口或类的时候&#xff0c;不预先指定具体的类型&#xff0c;而在使用的时候再指定类型的一种特性。使用泛型 可以复用类型…
阅读更多...
【非科班如何丝滑转码？】探索计算机领域跳槽之路

【非科班如何丝滑转码？】探索计算机领域跳槽之路

近年来&#xff0c;计算机领域的蓬勃发展吸引着越来越多非计算机科班出身的人士投身其中。本文将就如何顺利实现非科班转码&#xff0c;计算机岗位的发展前景&#xff0c;以及现阶段转码的建议&#xff0c;结合个人经验和观察&#xff0c;为您阐述详细全面的观点。 一、如何规划…
阅读更多...
【雕爷学编程】Arduino动手做（201）---行空板开发环境之VSCode

【雕爷学编程】Arduino动手做（201）---行空板开发环境之VSCode

37款传感器与模块的提法&#xff0c;在网络上广泛流传&#xff0c;其实Arduino能够兼容的传感器模块肯定是不止37种的。鉴于本人手头积累了一些传感器和执行器模块&#xff0c;依照实践出真知&#xff08;一定要动手做&#xff09;的理念&#xff0c;以学习和交流为目的&#x…
阅读更多...
Kotlin 基础教程一

Kotlin 基础教程一

Kotlin 基本数据类型 Java | Kotlin byte Byte short Short int Int long Long float Float double Double boolean Boolean c…
阅读更多...
PHP最简单自定义自己的框架view使用引入smarty（8）--自定义的框架完成

PHP最简单自定义自己的框架view使用引入smarty（8）--自定义的框架完成

1、实现效果。引入smarty&#xff0c; 实现assign和 display 2、下载smarty&#xff0c;创建缓存目录cache和扩展extend 点击下面查看具体下载使用&#xff0c;下载改名后放到extend PHP之Smarty使用以及框架display和assign原理_PHP隔壁老王邻居的博客-CSDN博客 3、当前控…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023