Python - 第三方HTTP庫Requests使用詳解4（文件上傳）

五、文件上傳（Form 表單方式）

1，單文件上傳

（1）下面是最簡單的文件上傳代碼，運行後將 logo.png 這個文件上傳到服務器：

import requests
files = {'file1': open('logo.png', 'rb')}
response = requests.post('http://www.hangge.com/upload.php', files=files)
print(response.text)

（2）我們也可以顯式地設置文件名，文件類型和請求頭：

import requests
files = {'file1': ('hangge.png', open('logo.png', 'rb'), 'image/png', {'Expires': '0'})}
response = requests.post('http://www.hangge.com/upload.php', files=files)
print(response.text)

（3）服務端代碼（ upload.php）

<?
move_uploaded_file($_FILES["file1"]["tmp_name"],
$_SERVER["DOCUMENT_ROOT"]."/uploadFiles/" . $_FILES["file1"]["name"]);
?>

2，多文件上傳

（1）有時我們需要在一個請求中同時發送多個文件，同樣使用 files 參數傳入一個數組即可：

import requests
files = [
('file1', ('1.png', open('logo.png', 'rb'), 'image/png')),
('file2', ('2.png', open('logo.png', 'rb'), 'image/png'))
]
response = requests.post('http://www.hangge.com/upload.php', files=files)
print(response.text)

（2）服務端代碼（ upload.php）

<?
move_uploaded_file($_FILES["file1"]["tmp_name"],
$_SERVER["DOCUMENT_ROOT"]."/uploadFiles/" . $_FILES["file1"]["name"]);
move_uploaded_file($_FILES["file2"]["tmp_name"],
$_SERVER["DOCUMENT_ROOT"]."/uploadFiles/" . $_FILES["file2"]["name"]);
?>

3，上傳時附帶其它參數

（1）如果我們需要在上傳文件的同時傳遞一些其它參數，也是可以的：

import requests
data = {
"name": "hangge.com",
"age": 100
}
files = [
('file1', ('1.png', open('logo.png', 'rb'), 'image/png')),
('file2', ('2.png', open('logo.png', 'rb'), 'image/png'))
]
response = requests.post('http://www.hangge.com/upload.php', data=data, files=files)
print(response.text)

（2）服務端代碼（ upload.php）

<?
$value1 = $_POST["name"];
$value2 = $_POST["age"];
move_uploaded_file($_FILES["file1"]["tmp_name"],
$_SERVER["DOCUMENT_ROOT"]."/uploadFiles/" . $_FILES["file1"]["name"]);
move_uploaded_file($_FILES["file2"]["tmp_name"],
$_SERVER["DOCUMENT_ROOT"]."/uploadFiles/" . $_FILES["file2"]["name"]);
?>

附：流式上傳文件

1，requests-toolbelt 擴展庫

（1）有時我們需要上傳一個非常大的文件（比如 1G 左右），如果像上面的方式直接使用 Requests 提交，可能會造成內存不足而崩潰。
（2）所以發送大文件時還是建議將請求做成數據流。不過默認下 Requests 不支持流式上傳，但有個第三方包 requests-toolbelt 是支持的（本質還是 multipart/form-data 上傳） （3）在使用 requests-toolbelt 之前，我們首先通過 pip 進行安裝：

pip install requests-toolbelt

2，使用流式上傳文件

下面樣例我們使用 requests-toolbelt 來實現文件的流式上傳：

• 不同於 requests 全部讀到內存中上傳，requests-toolbelt 是邊讀邊上傳。
• 其本質還是 multipart/form-data 提交數據，所以服務端代碼不需要變化。

import requests
from requests_toolbelt import MultipartEncoder
m = MultipartEncoder(
fields={'name': 'hangge.com', "age": '100',
'file1': ('1.png', open('logo.png', 'rb'), 'image/png'),
'file2': ('2.png', open('logo.png', 'rb'), 'image/png')}
)
r = requests.post('http://www.hangge.com/upload.php', data=m,
headers={'Content-Type': m.content_type})
print(r.text)

3，監聽上傳進度

（1） requests-toolbelt 還提供了個監視器（ MultipartEncoderMonitor），該監視器接受一個回調函數，我們可以在回調中實時跟蹤進度。

import requests
from requests_toolbelt import MultipartEncoder, MultipartEncoderMonitor
def my_callback(monitor):
progress = (monitor.bytes_read / monitor.len) * 100
print("\r 文件上傳進度：%d%%(%d/%d)"
% (progress, monitor.bytes_read, monitor.len), end=" ")
e = MultipartEncoder(
fields={'name': 'hangge.com', "age": '100',
'file1': ('1.png', open('logo.png', 'rb'), 'image/png'),
'file2': ('2.png', open('logo.png', 'rb'), 'image/png')}
)
m = MultipartEncoderMonitor(e, my_callback)
r = requests.post('http://www.hangge.com/upload.php', data=m,
headers={'Content-Type': m.content_type})
print(r.text)

（2）運行效果如下，可以看到提交過程中會實時顯示進度：