在PHP程序開發中,文件上傳是一個使用非常普遍的功能,也是PHP程序員的必備技能之一。值得高興的是,在PHP中實現文件上傳功能要比在Java、C#等語言中簡單得多。下面我們結合具體的代碼實例來詳細介紹如何通過PHP實現文件上傳和多文件上傳功能。
要使用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/'; //保存上傳文件的目錄//處理上傳的文件1 if ($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/>'; } //處理上傳的文件2 if ($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配置文件進行相應的修改。
以上就是本文的全部內容,幫助大家實現php文件上傳功能。