当前位置：首页 > news >正文

Python 的http.server库详细介绍

news 2025/7/17 22:32:32

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, HTTPServerclass 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()