从0到1一个文件，用Python 实现 Web 框架

本文通过一个简单的Python文件，介绍了如何从零开始构建一个Web框架，涵盖HTTPServer处理连接、HTTPRequestHandler处理请求的基本原理，并提供了代码示例。文章强调理解Web框架核心原理的重要性，以帮助开发者更轻松地学习和适应新框架。

当下网络就如同空气一样在我们的周围，它以无数种方式改变着我们的生活，但要说网络的核心技术变化甚微。

随着开源文化的蓬勃发展，诞生了诸多优秀的开源 Web 框架，让我们的开发变得轻松。但同时也让我们不敢停下学习新框架的脚步，其实万变不离其宗，只要理解了 Web 框架的核心技术部分，当有一个新的框架出来的时候，基础部分大同小异只需要重点了解：它有哪些特点，用到了哪些技术解决了什么痛点？这样接受和理解起新技术来会更加得心应手，不至于疲于奔命。

还有那些只会用 Web 框架的同学，是否无数次打开框架的源码，想学习提高却无从下手？

今天我们就抽丝剥茧、去繁存简，用一个文件，实现一个迷你 Web 框架，从而把其核心技术部分清晰地讲解清楚，配套的源码均已开源。

GitHub 地址：https://github.com/521xueweihan/OneFile

在线查看：https://hellogithub.com/onefile/

如果你觉得我做的这件事对你有帮助，就请给我一个 ✨Star，多多转发让更多人受益。

闲言少叙，下面就开始我们今天的提高之旅。

一、介绍原理

说到 Web 不得不提的就是网络协议，如果我们从 OSI 七层网络模型开始，我敢断定看完的绝对不超过三成！

所以今天我们就直接聊最上面的一层，也就是 Web 框架接触最多的 HTTP 应用层，至于 TCP/IP 部分会在聊 socket 的时候粗略带过。期间我会刻意打码非必要讲解技术的细枝末节，切断远离本期主题的技术话题，一个文件只讲一个技术点！绝不拖堂请大家放心阅读。

首先让我们先回忆下，平常浏览网站的流程。

如果我们把在网上冲浪，比做在一间教室听课，那么老师就是服务器（server），学生就是客户端（client）。当同学有问题的时候会先举手（请求建立 TCP），老师发现学生的提问请求，同意学生回答问题后，学生起立提出问题（发送请求），如果老师承诺会给提问的学生加课堂表现分，那么提问的时候就需要有个高效的提问方式（请求格式），即：

先报学号
再提问题

师接收到学生的提问后就可以立即回答问题（返回响应）无需再问学号，回答格式（响应格式）如下：

回答问题
根据学号加分！

有了约定好的提问格式（协议），就可以省去老师每次询问学生的学号，即高效又严谨。最后，老师回答完问题让学生坐下（关闭连接）。

其实，我们在网络上通信流程也大致如此：

只不过机器执行起来更加严格，大家都是遵循某种协议来开发软件，这样就可以实现在某种协议下进行通信，而这种网络通信协议就叫做 HTTP（超文本传输协议）。

而我们要做的 Web 框架就是处理上面的流程：建立连接、接收请求、解析请求、处理请求、返回请求。

原理部分就聊这么多，目前你只需要记住网络上通信分为两大步：建立连接（用于通信）和处理请求。

所谓框架就是处理大多数情况下要处理的事情，所以我们要写的 Web 框架也就是处理两件事，即：

处理连接（socket）
处理请求（request）

一定要记住：连接和请求是两个东西，建立起连接才能发送请求。

而想要建立连接发起通信，就需要通过 socket 来实现（建立连接），socket 可以理解为两个虚拟的本子（文件句柄），通信的双方人手一个，它既能读也能写，只要把传输的内容写到本子上（处理请求），对方就可以看到了。

下面我把 Web 框架分为两部分进行讲解，所有代码将采用简单易懂的 Python3 进行实现。

二、编写 Web 框架

代码+注释一共 457 行，请放心绝对简单易懂。

2.1 处理连接（HTTPServer）

这里需要简单聊一下 socket 这个东西，在编程语言层面它就是一个类库，负责搞定连接建立网络通信。但本质上是系统级别提供通信的进程，而一台电脑可以建立多条通信线路，所以每一个端口号后面都是一个 socket 进程，它们相互独立、互不干涉，这也是为什么我们在启动服务的时候要指定端口号的原因。

最后，上面所说的服务器其实就是一台性能好一点、一直开着的电脑，而客户端就是浏览器、手机、电脑，它们都有 socket 这个东西（操作系统级别的一个进程）。

如果上面这段话没有看懂也不碍事，能看懂下面的图就行，得搞明白 socket 处理连接的步骤和流程，才能编写 Web 框架处理连接的部分。

下面分别展示基于 socket 编写的 server.py 和 client.py 代码。

# coding: utf-8
# 服务器端代码（server.py）
import socket

print('我是服务端！')
HOST = ''
PORT = 50007
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)  # 创建 TCP socket 对象
s.setsockopt(socket.SOL_SOCKET,