Python中的http.server库用法详细介绍_Python

前言

http.server 是 python 标准库中的一个模块，用于创建基本的 http 服务器。这个模块非常适合用于开发、测试、以及在本地网络中共享文件。以下是对 http.server 模块的详细介绍。

python 官方文档：http.server — http 服务器

模块概述

http.server 提供了基本的 http 请求处理功能，它包含了以下几个核心类和方法：

http.server.basehttprequesthandler：这是所有请求处理类的基类，提供了处理 http 请求的基本框架。它定义了处理 http 请求的方法（如 do_get、do_post 等），这些方法需要在子类中被实现或重写。
http.server.simplehttprequesthandler：这是 basehttprequesthandler 的一个子类，专门用于处理简单的 get 和 head 请求。它可以直接用于服务文件系统中的文件，支持简单的文件目录浏览。
http.server.cgihttprequesthandler：这是 simplehttprequesthandler 的一个子类，支持 cgi 脚本的执行。它允许通过服务器运行 cgi 脚本，适用于简单的动态网页服务器。
http.server.httpserver：这是一个具体的 http 服务器类，基于 socketserver.tcpserver 实现。它用于处理客户端的请求并生成响应。
http.server.threadinghttpserver：这是 httpserver 的多线程版本，每个请求都会由一个单独的线程来处理。

基本用法

以下是如何使用 http.server 模块的基本示例：

1. 启动一个简单的 http 服务器

在命令行中，快速启动一个 http 服务器来服务当前目录中的文件：

python -m http.server 8000

这将在当前目录下启动一个 http 服务器，监听端口 8000。

2. 使用 python 代码启动服务器

from http.server import simplehttprequesthandler, httpserver

# 设置服务器地址和端口
server_address = ('', 8000)

# 创建服务器对象
httpd = httpserver(server_address, simplehttprequesthandler)

# 启动服务器
print("serving on port 8000...")
httpd.serve_forever()

这段代码启动了一个 http 服务器，并在 localhost 的 8000 端口上监听。

3. 自定义请求处理程序

通过继承 simplehttprequesthandler，你可以自定义服务器对特定请求的响应：

from http.server import simplehttprequesthandler, httpserver

class myrequesthandler(simplehttprequesthandler):
    def do_get(self):
        if self.path == '/hello':
            self.send_response(200)
            self.send_header("content-type", "text/html")
            self.end_headers()
            self.wfile.write(b"hello, world!")
        else:
            super().do_get()

# 创建服务器对象
httpd = httpserver(('', 8000), myrequesthandler)

# 启动服务器
print("serving on port 8000...")
httpd.serve_forever()

4. cgi 支持

使用 cgihttprequesthandler 运行支持 cgi 脚本的服务器：

from http.server import httpserver, cgihttprequesthandler

# 设置服务器地址和端口
server_address = ('', 8000)

# 启用cgi处理程序
httpd = httpserver(server_address, cgihttprequesthandler)

# 启动服务器
print("serving on port 8000 with cgi support...")
httpd.serve_forever()

cgi 处理程序允许你在服务器上运行诸如 python 脚本等 cgi 程序。

5. 启用 https 支持

虽然 http.server 默认只支持 http，但可以通过 ssl 模块添加 https 支持：

from http.server import simplehttprequesthandler, httpserver
import ssl

# 创建服务器对象
httpd = httpserver(('', 8000), simplehttprequesthandler)

# 添加ssl/tls层
httpd.socket = ssl.wrap_socket(httpd.socket,
                               keyfile="path/to/key.pem",
                               certfile='path/to/cert.pem',
                               server_side=true)

# 启动服务器
print("serving on https://localhost:8000...")
httpd.serve_forever()