http —- HTTP 模块

http —- HTTP 模块

源代码: Lib/http/init.py

http 是一个包，它收集了多个用于处理超文本传输协议的模块:

• http.client 是一个底层的 HTTP 协议客户端；对于高层级的 URL 访问请使用 urllib.request

• http.server 包含基于 socketserver 的基本 HTTP 服务类

• http.cookies 包含一些有用来实现通过 cookies 进行状态管理的工具

• http.cookiejar 提供了 cookies 的持久化

http 模块还定义了下列枚举来帮助你使用 http 相关的代码:

class http.HTTPStatus

Added in version 3.5.

enum.IntEnum 的子类，它定义了组 HTTP 状态码，原理短语以及用英语书写的长描述文本。

用法：

>>> from http import HTTPStatus
>>> HTTPStatus.OK
HTTPStatus.OK
>>> HTTPStatus.OK == 200
True
>>> HTTPStatus.OK.value
200
>>> HTTPStatus.OK.phrase
'OK'
>>> HTTPStatus.OK.description
'Request fulfilled, document follows'
>>> list(HTTPStatus)
[HTTPStatus.CONTINUE, HTTPStatus.SWITCHING_PROTOCOLS, ...]

HTTP 状态码

已支持的，IANA 注册的状态码 在 http.HTTPStatus 中可用的有:

为了保持向后兼容性，枚举值也以常量形式出现在 http.client 模块中，。 枚举名等于常量名 (例如 http.HTTPStatus.OK 也可以是 http.client.OK)。

在 3.7 版本发生变更: 添加了 421 MISDIRECTED_REQUEST 状态码。

Added in version 3.8: 添加了 451 UNAVAILABLE_FOR_LEGAL_REASONS 状态码。

Added in version 3.9: 增加了 103 EARLY_HINTS, 418 IM_A_TEAPOT 和 425 TOO_EARLY 状态码

在 3.13 版本发生变更: 实现了针对状态常量的 RFC9110 命名。 旧常量名被保留用于向下兼容。

HTTP 状态类别

Added in version 3.12.

这些枚举值具有一些用于指明 HTTP 状态类别的特征属性:

用法：

```

from http import HTTPStatus HTTPStatus.OK.is_success True HTTPStatus.OK.is_client_error False

_class_ http.HTTPMethod

Added in version 3.11.

一个 [enum.StrEnum](</read/python-3.13.0-zh/4d9681786a5be5a6.md#enum.StrEnum> "enum.StrEnum") 的子类，它定义了一组 HTTP 方法以及用英文书写的描述。

用法：

from http import HTTPMethod

HTTPMethod.GET HTTPMethod.GET == 'GET' True HTTPMethod.GET.value 'GET' HTTPMethod.GET.description 'Retrieve the target.' list(HTTPMethod) [, , , , , , , , ] ```

HTTP 方法

已支持的，IANA 注册的方法 在 http.HTTPMethod 中可用的有: