在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/'; //保存上传文件的目录//处理上传的文件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程式碼:
#檔案1:90052c15727de8d50c15a4399d6160fa076402276aae5dbec7f672f8f4e5cc81
檔案2:a146556286116ba7938f6ab5f879a934076402276aae5dbec7f672f8f4e5cc81
此外,我們還需要對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檔案上傳及多檔案上傳實例詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章!