Httpx 是一個 Python 函式庫,它提供了一個現代化的、易於使用的 HTTP 用戶端和伺服器。 Httpx 可以與 Python 的非同步框架協同工作,並支援 WebSocket 和 HTTP/2。 Httpx 具有極佳的效能和安全性,並支援對各種不同的協定、編碼和驗證方案進行靈活配置。
安裝 Httpx 函式庫非常簡單。只需使用 pip 套件管理器執行以下命令:
pip install httpx
如果您正在使用 Python 3.7 或更早版本,則需要安裝 Httpx 的非同步依賴項 aiohttp。
您可以透過執行以下命令來安裝它:
pip install httpx[aiohttp]
使用 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 的方法來傳送。這些方法中的大多數都支援傳遞資料、標頭和查詢參數等參數。
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 的請求體參數。
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 的文件。
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。
以上是python httpx如何使用的詳細內容。更多資訊請關注PHP中文網其他相關文章!