PHP实现文件上传和多文件上传

在PHP程序开发中,文件上传是一个使用非常普遍的功能,也是PHP程序员的必备技能之一。值得高兴的是,在PHP中实现文件上传功能要比在Java、C#等语言中简单得多,下面我们结合具体的代码实例来详细介绍如何通过PHP实现文件上传和多文件上传功能。

要使用PHP实现文件上传功能,我们先来编写两个php文件:index.php和upload.php。其中,index.php页面用于提交文件上传的表单请求,upload.php页面用于接收上传的文件并进行相应处理。

首先,我们来编写一个简单的index.php文件,由于其中涉及的主要是html代码,比较简单,因此不再赘述,index.php页面的详细代码如下:

  1. <?php
  2. //设置编码为UTF-8,以避免中文乱码
  3. header('Content-Type:text/html;charset=utf-8');
  4. ?>
  5. <!DOCTYPE html>
  6. <html>
  7. <head>
  8. <title>文件上传表单页面</title>
  9. </head>
  10. <body>
  11. <form action="upload.php" method="post" enctype="multipart/form-data">
  12. 文件1:<input name="upload_file1" type="file" /><br/>
  13. 文件2:<input name="upload_file2" type="file" /><br/>
  14. <input type="submit" value="上传" />
  15. </form>
  16. </body>
  17. </html>

值得注意的是,由于在HTTP协议设计之初,它并不支持文件上传功能,form表单的encrypt属性的默认值为application/x-www-form-urlencoded,它只能用于提交一般的表单请求。如果提交的表单中包含需要上传的文件,我们需要将enctype的属性值改为multipart/form-data才能实现文件上传功能。此外,method的属性值必须为post。

接着,我们继续编写upload.php文件的代码。

  1. <?php
  2. //设置编码为UTF-8,以避免中文乱码
  3. header('Content-Type:text/html;charset=utf-8');
  4. $first_file = $_FILES['upload_file1']; //获取文件1的信息
  5. $second_file = $_FILES['upload_file2']; //获取文件2的信息$upload_dir = 'D:/upload/'; //保存上传文件的目录//处理上传的文件1
  6. if ($first_file['error'] == UPLOAD_ERR_OK){
  7. //上传文件1在服务器上的临时存放路径
  8. $temp_name = $first_file['tmp_name'];
  9. //上传文件1在客户端计算机上的真实名称
  10. $file_name = $first_file['name'];
  11. //移动临时文件夹中的文件1到存放上传文件的目录,并重命名为真实名称
  12. move_uploaded_file($temp_name, $upload_dir.$file_name);
  13. echo '[文件1]上传成功!<br/>';
  14. }else{
  15. echo '[文件1]上传失败!<br/>';
  16. }
  17. //处理上传的文件2
  18. if ($second_file['error'] == UPLOAD_ERR_OK){
  19. //上传文件2在服务器上的临时存放路径
  20. $temp_name = $second_file['tmp_name'];
  21. //上传文件2在客户端计算机上的真实名称
  22. $file_name = $second_file['name'];
  23. //移动临时文件夹中的文件2到存放上传文件的目录,并重命名为真实名称
  24. move_uploaded_file($temp_name, $upload_dir.$file_name);
  25. echo '[文件2]上传成功!<br/>';
  26. }else {
  27. echo '[文件2]上传失败!<br/>';
  28. }
  29. ?>

在PHP中,当浏览器客户端提交过来的表单请求中包含上传的文件时,PHP会将上传的文件先暂时存放在临时目录中(在Windows操作系统中,默认的临时目录一般为C:/Windows/Temp),然后将上传文件的相关信息存放在超全局变量$_FILES中。因此,我们只需要通过$_FILES数组获取上传的文件信息,然后对其进行相应的处理操作即可。下面,我们来看看通过浏览器上传A.gif和B.gif两个图片文件时,使用print_r()函数输出超全局变量$_FILES的详细信息:

  1. Array ( [upload_file1] => Array (
  2. [name] => A.gif (客户端上传时的真实文件名称)
  3. [type] => image/gif (文件的类型)
  4. [tmp_name] => C:\Windows\Temp\php9803.tmp (文件上传到PHP服务器后临时存放的路径)
  5. [error] => 0 (错误信息,0表示没有错误)
  6. [size] => 87123 (文件大小,单位为字节)
  7. )
  8. [upload_file2] => Array (
  9. [name] => B.gif
  10. [type] => image/gif
  11. [tmp_name] => C:\Windows\Temp\php9813.tmp
  12. [error] => 0
  13. [size] => 93111
  14. )
  15. )

在上面的例子中,我们上传的两个文件参数名分别为upload_file1和upload_file2。现在,我们让表单中的多个文件以相同的参数名upload_file,将刚才上传的两个文件以参数数组形式再次提交上传。此时,我们需要将index.php页面中的两个file文件域修改为如下html代码:

文件1:<input name="upload_file[]" type="file" /><br/>

文件2:<input name="upload_file[]" type="file" /><br/>

此外,我们还需要对upload.php页面进行相应的修改:

  1. <?php
  2. //设置编码为UTF-8,以避免中文乱码
  3. header('Content-Type:text/html;charset=utf-8');
  4. $fileArray = $_FILES['upload_file'];//获取多个文件的信息,注意:这里的键名不包含[]
  5. $upload_dir = 'D:/upload/'; //保存上传文件的目录
  6. foreach ( $fileArray['error'] as $key => $error) {
  7. if ( $error == UPLOAD_ERR_OK ) { //PHP常量UPLOAD_ERR_OK=0,表示上传没有出错
  8. $temp_name = $fileArray['tmp_name'][$key];
  9. $file_name = $fileArray['name'][$key];
  10. move_uploaded_file($temp_name, $upload_dir.$file_name);
  11. echo '上传[文件'.$key.']成功!<br/>';
  12. }else {
  13. echo '上传[文件'.$key.']失败!<br/>';
  14. }
  15. }
  16. ?>

同样的,我们使用print_r()函数来查看上面例子中的超全局变量$_FILES的详细信息:

  1. Array (
  2. [upload_file] => Array (
  3. [name] => Array (
  4. [0] => A.gif
  5. [1] => B.gif
  6. )
  7. [type] => Array (
  8. [0] => image/gif
  9. [1] => image/gif
  10. )
  11. [tmp_name] => Array (
  12. [0] => C:\Windows\Temp\php87B9.tmp
  13. [1] => C:\Windows\Temp\php87BA.tmp
  14. )
  15. [error] => Array (
  16. [0] => 0
  17. [1] => 0
  18. )
  19. [size] => Array (
  20. [0] => 87123
  21. [1] => 93111
  22. )
  23. )
  24. )

备注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配置文件进行相应的修改。