Python httpx 模块：入门指南

python库 › 网络编程
, ,

Python httpx 模块：入门指南

httpx 是一个为 Python 提供 HTTP 请求功能的异步客户端模块。它不仅与 requests 模块相似，但也支持异步请求，因此适合需要处理高并发请求的场景。httpx 适配于 Python 3.6 及更高版本。

模块介绍

httpx 模块是一个功能强大的 HTTP 客户端，可用于发送请求、处理响应、支持异步操作等。它被设计为既简单易用又功能强大，能够轻松地进行网络请求，并支持 HTTP/1.1 和 HTTP/2。此外，httpx 还支持家族 Cookies、身份验证、重定向和流式请求等多种特性。

应用场景

httpx 模块主要用于数据抓取、API 调用和网络应用开发，逻辑上可以分为三大类应用场景：

  1. API 调用：进行 RESTful API 调用，获取 JSON 数据。
  2. 网络爬虫：抓取网页内容，解析网页数据，进行数据分析。
  3. 异步任务：在处理大量并行任务时，利用异步协程避免阻塞，提高效率。

安装说明

httpx 并不是 Python 的默认模块，需要进行额外安装。可以通过以下命令安装：

1
pip install httpx  # 安装 httpx 模块

用法举例

1. 基本 GET 请求

1
2
3
4
5
6
7
8
9
10
11
import httpx  # 导入 httpx 模块

# 定义一个异步函数以执行 GET 请求
async def fetch_data():
    async with httpx.AsyncClient() as client:  # 创建异步客户端实例
        response = await client.get('https://api.github.com')  # 发送 GET 请求
        print(response.json())  # 打印响应的 JSON 数据

# 调用函数以获取数据
import asyncio  # 导入 asyncio 模块
asyncio.run(fetch_data())  # 执行异步任务

在这个示例中，我们使用 httpx 进行一次基本的 GET 请求，获取 GitHub API 的响应。

2. 发送 POST 请求

1
2
3
4
5
6
7
8
9
10
11
12
import httpx  # 导入 httpx 模块

# 定义一个异步函数以发送 POST 请求
async def post_data():
    async with httpx.AsyncClient() as client:  # 创建异步客户端实例
        data = {'key': 'value'}  # 定义要发送的数据
        response = await client.post('https://httpbin.org/post', json=data)  # 发送 POST 请求
        print(response.json())  # 打印响应的 JSON 数据

# 调用函数以发送数据
import asyncio  # 导入 asyncio 模块
asyncio.run(post_data())  # 执行异步任务

在这个例子中，我们创建了一个异步函数，通过 HTTP POST 方法将数据发送到指定的 URL。

3. 异步处理多个请求

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import httpx  # 导入 httpx 模块

# 定义一个异步函数以执行多个请求
async def fetch_multiple_urls(urls):
    async with httpx.AsyncClient() as client:  # 创建异步客户端实例
        tasks = [client.get(url) for url in urls]  # 为每个 URL 创建请求任务
        responses = await asyncio.gather(*tasks)  # 执行所有请求
        for response in responses:  # 遍历每个响应
            print(response.url, response.status_code)  # 打印 URL 和状态码

# 定义要请求的 URL 列表
urls = ['https://api.github.com', 'https://httpbin.org/get', 'https://httpbin.org/anything']

# 调用函数以获取多个请求结果
import asyncio  # 导入 asyncio 模块
asyncio.run(fetch_multiple_urls(urls))  # 执行异步任务

在此示例中，我们展示了如何使用 httpx 同时发送多个异步请求，提高了网络请求的效率。

通过这些例子，相信你已经对 httpx 模块的基本用法有了初步的了解。无论是简单的 GET 请求、POST 请求，还是复杂的异步请求场景，httpx 都能轻松应对。

强烈建议大家关注本人的博客全糖冲击博客，在这里，你可以找到所有 Python 标准库的使用教程，方便你进行查询和学习。我的博客致力于提供详细的教程，让你在数据分析、网络编程、机器学习等方面获得更深的理解和实践经验。关注我的博客，你将获得一手实用的编程技巧，帮助你在编程的道路上走得更远，欢迎你的加入与讨论！

软件和库版本不断更新

由于软件和库版本不断更新，如果本文档不再适用或有误，请留言或联系我进行更新。让我们一起营造良好的学习氛围。感谢您的支持！ - Travis Tang