python httpx如何使用

什么是 Httpx

Httpx 是一个 Python 库，它提供了一个现代化的、易于使用的 HTTP 客户端和服务器。Httpx 可以与 Python 的异步框架协同工作，并支持 WebSocket 和 HTTP/2。Httpx 具有极佳的性能和安全性，并支持对各种不同的协议、编码和验证方案进行灵活配置。

安装 Httpx

安装 Httpx 库非常简单。只需使用 pip 包管理器运行以下命令即可：

pip install httpx

如果您正在使用 Python 3.7 或更早版本，则需要安装 Httpx 的异步依赖项 aiohttp。

您可以通过运行以下命令来安装它：

pip install httpx[aiohttp]

发送 HTTP 请求

使用 Httpx 发送 HTTP 请求非常简单。以下是一个简单的示例，它使用 Httpx 发送一个 GET 请求：

import httpx

response = httpx.get('https://www.baidu.com')
print(response.status_code)
print(response.text)

在这个示例中，我们使用 Httpx 的 get 方法发送了一个 GET 请求。该请求的 URL 是 https://www.baidu.com。该方法返回一个 Response 对象，我们可以使用该对象来访问响应状态码和响应文本。

Httpx 支持许多不同的 HTTP 方法，包括 GET、POST、PUT、DELETE、HEAD 和 OPTIONS。您可以使用 Httpx 的方法来发送这些请求。

以下是一些示例：

import httpx

response = httpx.post('https://www.baidu.com', data={'key': 'value'})
response = httpx.put('https://www.baidu.com', data={'key': 'value'})
response = httpx.delete('https://www.baidu.com')
response = httpx.head('https://www.baidu.com')
response = httpx.options('https://www.baidu.com')

上述示例中的每个请求都可以使用 Httpx 的方法来发送。这些方法中的大多数都支持传递数据、标头和查询参数等参数。

发送异步 HTTP 请求

Httpx 还支持异步 HTTP 请求。以下是一个简单的示例，它使用 Httpx 发送一个异步 GET 请求：

import httpx
import asyncio

async def get_request():
    async with httpx.AsyncClient() as client:
        response = await client.get('https://www.baidu.com')
        print(response.status_code)
        print(response.text)

asyncio.run(get_request())

在这个示例中，我们创建了一个名为 get_request 的异步函数，它使用 Httpx 的 AsyncClient 类来发送一个异步 GET 请求。在异步函数中，我们使用 async with 语句来创建 Httpx 的异步客户端。使用这种方式创建客户端可以确保在请求完成后自动关闭客户端。然后，我们使用 await 关键字来异步等待响应，并从响应对象中访问响应状态码和响应文本。

类似于同步请求，Httpx 的异步客户端也支持许多不同的 HTTP 方法。

以下是一些示例：

import httpx
import asyncio

async def post_request():
    async with httpx.AsyncClient() as client:
        response = await client.post('https://www.baidu.com', data={'key': 'value'})
        print(response.status_code)
        print(response.text)

asyncio.run(post_request())

设置请求标头

在发送 HTTP 请求时，您通常需要设置请求标头。Httpx 允许您通过在请求方法中传递 headers 参数来设置请求标头。

以下是一个示例：

import httpx

headers = {
    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.3'}

response = httpx.get('https://www.baidu.com', headers=headers)
print(response.status_code)
print(response.text)

在这个示例中，我们使用 headers 参数设置了一个名为 User-Agent 的请求标头。

设置请求参数

Httpx 允许您在发送 HTTP 请求时设置请求参数。

以下是一些示例：

import httpx

params = {'key1': 'value1', 'key2': 'value2'}

response = httpx.get('https://www.baidu.com', params=params)
print(response.status_code)
print(response.text)

在这个示例中，我们使用 params 参数设置了两个查询参数 key1 和 key2。

发送请求体

在发送 POST、PUT 和 DELETE 请求时，您通常需要在请求体中包含数据。Httpx 允许您使用 data 参数设置请求体中的数据。

以下是一个示例：

import httpx

data = {'key': 'value'}

response = httpx.post('https://www.baidu.com', data=data)
print(response.status_code)
print(response.text)

在这个示例中，我们使用 data 参数设置了一个名为 key 的请求体参数。

发送 JSON 数据

Httpx 允许您使用 json 参数发送 JSON 数据。

以下是一个示例：

import httpx

data = {'key': 'value'}

response = httpx.post('https://www.baidu.com', json=data)
print(response.status_code)
print(response.text)

在这个示例中，我们使用 json 参数设置了一个名为 key 的 JSON 请求体参数。

设置超时

在发送 HTTP 请求时，您通常需要设置超时时间。Httpx 允许您使用 timeout 参数设置超时时间。

以下是一个示例：

import httpx

response = httpx.get('https://www.baidu.com', timeout=5)
print(response.status_code)
print(response.text)

在这个示例中，我们使用 timeout 参数设置了 5 秒的超时时间。

错误处理

Httpx 可以抛出各种不同类型的异常，以帮助您诊断和解决问题。以下是一些常见的异常：

• httpx.HTTPError：发生 HTTP 错误时引发。

• httpx.RequestError：发生请求错误时引发。

• httpx.NetworkError：发生网络错误时引发。

• httpx.TimeoutException：发生超时时引发。

在处理这些异常时，您可以使用 try/except 语句来捕获异常并采取适当的措施。以下是一个示例：

import httpx

try:
    response = httpx.get('https://www.baidu.com')
    response.raise_for_status()
except httpx.HTTPError as http_error:
    print(f'HTTP error occurred: {http_error}')
except httpx.RequestError as request_error:
    print(f'Request error occurred: {request_error}')
except httpx.NetworkError as network_error:
    print(f'Network error occurred: {network_error}')
except httpx.TimeoutException as timeout_error:
    print(f'Timeout error occurred: {timeout_error}')
else:
    print(response.status_code)
    print(response.text)

在这个示例中，我们使用 try/except 语句捕获了所有可能发生的异常，并根据异常类型采取了适当的措施。

证书验证

Httpx 允许您验证 SSL 证书以确保与服务器的安全连接。默认情况下，Httpx 会验证 SSL 证书。如果您需要禁用证书验证，可以将 verify 参数设置为 False。

以下是一个示例：

import httpx

response = httpx.get('https://www.baidu.com', verify=False)
print(response.status_code)
print(response.text)

在这个示例中，我们将 verify 参数设置为 False，以禁用 SSL 证书验证。

使用代理

Httpx 允许您使用代理来发送 HTTP 请求。以下是一个示例：

import httpx

proxies = {
    'http://http-proxy-server:8080',
    'https://https-proxy-server:8080'
}

response = httpx.get('https://www.baidu.com', proxies=proxies)
print(response.status_code)
print(response.text)

在这个示例中，我们使用 proxies 参数设置了两个代理服务器。

上传文件

Httpx 允许您使用 files 参数上传文件。以下是一个示例：

import httpx

files = {'file': ('file.txt', open('file.txt', 'rb'))}

response = httpx.post('https://www.baidu.com', files=files)
print(response.status_code)
print(response.text)

在这个示例中，我们使用 files 参数上传了名为 file.txt 的文件。

使用 Cookie

Httpx 允许您使用 cookies 参数发送 cookie。以下是一个示例：

import httpx

cookies = {'name': 'value'}

response = httpx.get('https://www.baidu.com', cookies=cookies)
print(response.status_code)
print(response.text)

在这个示例中，我们使用 cookies 参数发送了名为 name 的 cookie。