在PHP程式開發中,檔案上傳是一個使用非常普遍的功能,也是PHP程式員的必備技能之一。值得高興的是,在PHP中實現檔案上傳功能要比在Java、C#等語言中簡單得多。
要使用PHP實現檔案上傳功能,我們先來編寫兩個php檔案:index.php和upload.php。其中,index.php頁面用於提交檔案上傳的表單請求,upload.php頁面用於接收上傳的檔案並進行相應處理。
首先,我們來編寫一個簡單的index.php檔案,由於其中涉及的主要是html代碼,比較簡單,因此不再贅述,index.php頁面的詳細代碼如下:
<?php//設定編碼為UTF-8,以避免中文亂碼header('Content-Type:text/html;charset=utf-8');?><!DOCTYPE html><html><head> <title>檔案上傳表單頁面</title></head><body><form action="upload.php" method="post" enctype="multipart/form-data">檔案1:<input name="upload_file1" type="file" /><br/>檔案2:<input name="upload_file2" type="file" /><br/><input type="submit" value="上傳" /></form></body></html>
值得注意的是,由於在HTTP協議設計之初,它並不支援檔案上傳功能,form表單的encrypt屬性的預設值為application/x-www-form-urlencoded,它只能用於提交一般的表單請求。如果提交的表單中包含需要上傳的檔案,我們需要將enctype的屬性值改為multipart/form-data才能實現檔案上傳功能。此外,method的屬性值必須為post。
接著,我們繼續編寫upload.php檔案的代碼。
<?php//設定編碼為UTF-8,以避免中文亂碼header('Content-Type:text/html;charset=utf-8');$first_file = $_FILES['upload_file1']; //擷取檔案1的資訊$second_file = $_FILES['upload_file2']; //擷取檔案2的資訊$upload_dir = 'D:/upload/'; //儲存上傳檔案的目錄//處理上傳的檔案1if ($first_file['error'] == UPLOAD_ERR_OK){ //上傳檔案1在伺服器上的臨時存放路徑 $temp_name = $first_file['tmp_name']; //上傳檔案1在用戶端電腦上的真實名稱 $file_name = $first_file['name']; //移動臨時檔案夾中的檔案1到存放上傳檔案的目錄,並重新命名為真實名稱 move_uploaded_file($temp_name, $upload_dir.$file_name); echo '[檔案1]上傳成功!<br/>';}else{ echo '[檔案1]上傳失敗!<br/>';}//處理上傳的檔案2if ($second_file['error'] == UPLOAD_ERR_OK){ //上傳檔案2在伺服器上的臨時存放路徑 $temp_name = $second_file['tmp_name']; //上傳檔案2在用戶端電腦上的真實名稱 $file_name = $second_file['name']; //移動臨時檔案夾中的檔案2到存放上傳檔案的目錄,並重新命名為真實名稱 move_uploaded_file($temp_name, $upload_dir.$file_name); echo '[檔案2]上傳成功!<br/>';}else { echo '[檔案2]上傳失敗!<br/>';}?>
在PHP中,當瀏覽器用戶端提交過來的表單請求中包含上傳的檔案時,PHP會將上傳的檔案先暫時存放在臨時目錄中(在Windows作業系統中,預設的臨時目錄一般為C:/Windows/Temp),然後將上傳檔案的相關資訊存放在超全域變數$_FILES中。因此,我們只需要通過$_FILES數組擷取上傳的檔案資訊,然後對其進行相應的處理操作即可。下面,我們來看看通過瀏覽器上傳A.gif和B.gif兩個圖片檔案時,使用print_r()函數輸出超全域變數$_FILES的詳細資料:
Array ( [upload_file1] => Array ( [name] => A.gif (用戶端上傳時的真實檔案名稱) [type] => image/gif (檔案的類型) [tmp_name] => C:\Windows\Temp\php9803.tmp (檔案上傳到PHP伺服器後臨時存放的路徑) [error] => 0 (錯誤資訊,0表示沒有錯誤) [size] => 87123 (檔案大小,單位為位元組) ) [upload_file2] => Array ( [name] => B.gif [type] => image/gif [tmp_name] => C:\Windows\Temp\php9813.tmp [error] => 0 [size] => 93111 ))
在上面的例子中,我們上傳的兩個檔案參數名分別為upload_file1和upload_file2。現在,我們讓表單中的多個檔案以相同的參數名upload_file,將剛才上傳的兩個檔案以參數數組形式再次提交上傳。此時,我們需要將index.php頁面中的兩個file檔案域修改為如下html代碼:
此外,我們還需要對upload.php頁面進行相應的修改:
<?php//設定編碼為UTF-8,以避免中文亂碼header('Content-Type:text/html;charset=utf-8');$fileArray = $_FILES['upload_file'];//擷取多個檔案的資訊,注意:這裡的鍵名不包含[]$upload_dir = 'D:/upload/'; //儲存上傳檔案的目錄foreach ( $fileArray['error'] as $key => $error) { if ( $error == UPLOAD_ERR_OK ) { //PHP常量UPLOAD_ERR_OK=0,表示上傳沒有出錯 $temp_name = $fileArray['tmp_name'][$key]; $file_name = $fileArray['name'][$key]; move_uploaded_file($temp_name, $upload_dir.$file_name); echo '上傳[檔案'.$key.']成功!<br/>'; }else { echo '上傳[檔案'.$key.']失敗!<br/>'; }}?>
同樣的,我們使用print_r()函數來查看上面例子中的超全域變數$_FILES的詳細資料:
Array ( [upload_file] => Array ( [name] => Array ( [0] => A.gif [1] => B.gif ) [type] => Array ( [0] => image/gif [1] => image/gif ) [tmp_name] => Array ( [0] => C:\Windows\Temp\php87B9.tmp [1] => C:\Windows\Temp\php87BA.tmp ) [error] => Array ( [0] => 0 [1] => 0 ) [size] => Array ( [0] => 87123 [1] => 93111 ) ))
備忘1:在PHP的預設配置下,上傳的檔案大小超出一定的範圍將會出錯,請參文末提到的如何修改PHP上傳檔案的大小限制問題的解決方案。
備忘2:上述處理檔案上傳的PHP代碼只是一個簡單的入門樣本,並不能直接作為正式代碼使用,因為還有許多需要額外注意的安全因素沒有考慮,例如:檔案的類型、檔案的大小以及上傳檔案的名稱重複等。
備忘3:如果上傳的檔案名稱中包含中文,可能引起檔案名稱亂碼問題。此時,需要使用函數iconv()來轉換檔名稱的編碼。
前面我們瞭解了如何使用PHP實現檔案上傳和多檔案上傳。不過,在PHP的預設配置情況下,當上傳的檔案大小超出一定的限制時,我們將得到如下的錯誤提示資訊:
Warning: POST Content-Length of 625523488 bytes exceeds the limit of 8388608 bytes in Unknown on line 0上述錯誤資訊的大致意思是,我們使用POST請求提交的資料大小超過了伺服器的最大限制數(8388608位元組=8MB)。出現上述錯誤的原因是,在PHP的設定檔php.ini中,預設存在如下配置資訊(在php.ini中,行首的分號";"表示當前行是注釋,不會生效):;指令碼解析輸入資料(類似 POST 和 GET)允許的最大時間,單位是秒。 它從接收所有資料到開始執行指令碼進行測量的。 max_input_time = 60;允許用戶端單個POST請求發送的最大資料post_max_size = 8M;是否開啟檔案上傳功能file_uploads = On;檔案上傳的臨時存放目錄(如果不指定,使用系統預設的臨時目錄);upload_tmp_dir =;允許單個請求上傳的最大檔案大小upload_max_filesize = 2M;允許單個POST請求同時上傳的最大檔案數量max_file_uploads = 20
從上面的配置資訊中我們可以看出,PHP的預設配置資訊就是導致PHP檔案上傳時提示檔案大小超出限制的「罪魁禍首」。筆者已經在上述配置資訊中給出了各個指令選項對應的中文注釋資訊,大家可以根據自己的實際需求情況對php.ini設定檔進行相應的修改。