免费公司网站模版,深圳网站开发,做网站代理商好赚吗,东莞网站建设 牛魔网Python httpx 模块详细讲解
一、引言
httpx 是一个用于发送 HTTP 请求的 Python 库#xff0c;它提供了简单易用的 API#xff0c;支持同步和异步请求#xff0c;并且具有出色的性能和灵活性。httpx 是 requests 的一个现代替代品#xff0c;它使用 httpcore 作为底层传输…Python httpx 模块详细讲解
一、引言
httpx 是一个用于发送 HTTP 请求的 Python 库它提供了简单易用的 API支持同步和异步请求并且具有出色的性能和灵活性。httpx 是 requests 的一个现代替代品它使用 httpcore 作为底层传输层支持 HTTP/1.1 和 HTTP/2 协议。
二、安装
你可以使用 pip 命令来安装 httpx
pip install httpx三、基本用法
发送 GET 请求
import httpxresponse httpx.get(https://www.example.com)
print(response.status_code) # 打印 HTTP 状态码
print(response.text) # 打印响应内容发送 POST 请求
import httpxpayload {key: value}
response httpx.post(https://www.example.com/post, jsonpayload)
print(response.status_code)
print(response.text)其他 HTTP 方法
httpx 同样支持 PUT、DELETE、HEAD 等其他 HTTP 方法。
response httpx.put(https://www.example.com/put, jsonpayload)
response httpx.delete(https://www.example.com/delete)
response httpx.head(https://www.example.com/head)四、响应处理
状态码
print(response.status_code) # 打印 HTTP 状态码响应头
print(response.headers) # 打印响应头信息响应内容
print(response.text) # 打印响应内容字符串形式
print(response.json()) # 如果响应内容是 JSON 格式可以使用此方法解析
print(response.content) # 打印响应内容字节形式错误处理
如果请求发生错误httpx 会抛出一个 httpx.HTTPError 异常。你可以使用 try-except 语句来捕获这个异常。
try:response httpx.get(https://www.example.com/invalid)print(response.text)
except httpx.HTTPError as err:print(err)五、高级特性
参数传递
在 GET 请求中你可以使用 params 参数来传递查询字符串。
payload {key1: value1, key2: value2}
response httpx.get(https://www.example.com/get, paramspayload)
print(response.url) # 打印完整的 URL包括查询字符串自定义请求头
你可以使用 headers 参数为请求添加自定义的头部信息。
headers {User-Agent: my-app/0.0.1}
response httpx.get(https://www.example.com, headersheaders)文件上传
使用 files 参数可以上传文件。
files {file: open(path/to/file, rb)}
response httpx.post(https://www.example.com/upload, filesfiles)认证
使用 auth 参数可以为请求添加 HTTP 认证。
from httpx import BasicAuthresponse httpx.get(https://www.example.com, authBasicAuth(username, password))超时设置
使用 timeout 参数可以为请求设置超时时间。
response httpx.get(https://www.example.com, timeout5.0) # 超时时间为 5 秒代理设置
使用 proxies 参数可以设置代理服务器。
proxies {http: http,https: http,
}response httpx.get(https://www.example.com, proxiesproxies)流式响应
对于大文件或长时间运行的响应你可能想要以流的方式处理数据而不是一次性加载整个响应体。httpx 支持流式响应允许你按需读取数据。
import httpxwith httpx.stream(GET, https://www.example.com/large-file) as response:for chunk in response.iter_content(chunk_size8192):# 处理每个数据块process(chunk)客户端会话
与 requests 的 Session 类似httpx 提供了 Client 和 AsyncClient 类用于创建客户端会话。这允许你在多个请求之间重用底层连接从而提高了性能。
import httpx# 创建同步客户端会话
with httpx.Client() as client:response1 client.get(https://www.example.com/api/data1)response2 client.get(https://www.example.com/api/data2)# 创建异步客户端会话
async with httpx.AsyncClient() as client:response1 await client.get(https://www.example.com/api/data1)response2 await client.get(https://www.example.com/api/data2)连接池管理
httpx 使用了连接池来管理底层 TCP 连接这有助于减少建立连接的开销。你可以通过配置 httpx.Client 或 httpx.AsyncClient 的连接池参数来定制连接池的行为。
# 同步客户端的连接池配置
with httpx.Client(limitshttpx.Limits(max_connections100, max_keepalive5)) as client:# ...# 异步客户端的连接池配置
async with httpx.AsyncClient(limitshttpx.AsyncLimits(max_connections100, max_keepalive5)) as client:# ...请求和响应模型
httpx 提供了 Request 和 Response 类这些类可以用来手动创建请求和响应对象。这在某些高级用法中可能很有用例如当你需要更细粒度的控制时。
import httpx# 创建请求对象
request httpx.Request(GET, https://www.example.com)# 发送请求并获取响应
with httpx.Client() as client:response client.send(request)# 处理响应
print(response.status_code)
print(response.text)错误处理
除了标准的 httpx.HTTPError 异常httpx 还提供了其他异常类用于处理不同的错误情况。
try:response httpx.get(https://www.example.com/invalid)response.raise_for_status()
except httpx.HTTPError as exc:print(fHTTP error occurred: {exc})
except httpx.RequestError as exc:print(fA request error occurred: {exc})
except httpx.ConnectError as exc:print(fConnection error occurred: {exc})工具和实用功能
httpx 还提供了一些实用的工具和函数如 httpx.URL 类用于解析和处理 URLhttpx.codes 模块包含 HTTP 状态码常量等。
from httpx import URL, codes# 解析 URL
parsed_url URL(https://www.example.com/path?queryvalue#fragment)
print(parsed_url.scheme) # 输出 https# 检查状态码是否表示成功
if response.status_code codes.ok:# 处理成功的响应pass
