简体中文(ZH-CN) English(EN) 繁体中文(ZH-TW) 日本語(JA) 한국어(KO) Melayu(MS) Français(FR) Deutsch(DE)
Home > List of blog posts > PHP 文件上传
Blogger Information
Blog 32
fans 0
comment 0
visits 27413
Special Recommendation
More>
Related recommendations
Popular Tutorials
More>
Related Tutorials
Popular Recommendations
Latest courses
Latest Downloads
More>
Web Effects
Website Source Code
Website Materials
Front End Template
PHP 文件上传
Yang_Sir
Original
861 people have browsed it
  • 上传的文件保存在临时文件夹中，如没有另外保存，脚本结束后就没了
  • 大文件上传，如50M以上的，除了php.ini还需要配置apache中httpd.conf文件里FcgidMaxRequestLen 的值，不然会出现Internal Server Error

基本概念

1.客户端上传

  • html中用户可以通过form表单上传文件，
  • form表单中input标签的type属性设置为file时，即规定输入内容作为文件处理。
  • 表单的上传方式必须是POST
  • enctype属性规定上传的内容类型，文件使用multipart/form-data类型
  • 文件上传的方式有单文件上传和多文件上传，
  • 多文件上传又分为三种类型：
  • 1.逐一上传，表单中每个input的name属性值不同
  • 2.批量上传，限定文件个数,每个input的name属性值相同为数组类型，每次可选 一个文件
  • 3.批量上传，不限定个数，input的name属性值为数组类型，并添加multiple属 性，可以同时选多个文件

2.服务器处理

  • PHP中以全局变量$_FILES记录上传的文件信息，
  • $_FILES二维键名为客户端form表单中的name属性值，其值是五个固定的文件信息
序号 键名 描述
1 name 文件在客户端的原始文件名(即存在用户电脑上的文件名)
2 type 文件的 MIME 类型, 由浏览器提供, PHP 并不检查它
3 tmp_name 文件被上传到服务器上之后,在临时目录中临时文件名
4 error 和该文件上传相关的错误代码
5 size 已上传文件的大小(单位为字节)

error错误信息描述:

序号 常量 值 描述
1 UPLOAD_ERR_OK 0 没有错误发生,文件上传成功
2 UPLOAD_ERR_INI_SIZE 1 文件超过php.ini中upload_max_filesize值
3 UPLOAD_ERR_FORM_SIZE 2 文件大小超过表单中MAX_FILE_SIZE指定的值
4 UPLOAD_ERR_PARTIAL 3 文件只有部分被上传
5 UPLOAD_ERR_NO_FILE 4 没有文件被上传
6 UPLOAD_ERR_NO_TMP_DIR 6 找不到临时文件夹
7 UPLOAD_ERR_CANT_WRITE 7 文件写入失败
  • 服务器接收文件后保存在临时文件中，通过move_uploaded_file()方法保存到指定位置

示例演示

1.创建上传页面

  • 创建4种不同上传方式的form表单
  1. <!DOCTYPE html>
  2. <html lang="en">
  3.   <head>
  4.     <meta charset="UTF-8" />
  5.     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  6.     <title>文件上传</title>
  7.   </head>
  8.   <style>
  9.     fieldset {
  10.       height: 100px;
  11.       padding: 20px 20px;
  12.     }
  13.   </style>
  15.   <body>
  16.     <form action="upload2.php" method="POST" enctype="multipart/form-data">
  17.       <fieldset>
  18.         <legend>单文件上传</legend>
  19.         <input type="hidden" name="MAX_FILE_SIZE" value="500000" />
  20.         <input type="file" name="my_pic" />
  21.         <button>上传</button>
  22.       </fieldset>
  23.     </form>
  24.     <br />
  25.     <form action="upload2.php" method="POST" enctype="multipart/form-data">
  26.       <fieldset>
  27.         <legend>多文件上传: 逐个上传</legend>
  28.         <input type="hidden" name="MAX_FILE_SIZE" value="300" />
  29.         <input type="file" name="my_pic1" />
  30.         <input type="file" name="my_pic2" />
  31.         <input type="file" name="my_pic3" />
  32.         <button>上传</button>
  33.       </fieldset>
  34.     </form>
  35.     <br />
  36.     <form action="upload2.php" method="POST" enctype="multipart/form-data">
  37.       <fieldset>
  38.         <legend>多文件上传: 批量上传（限文件数）</legend>
  39.         <input type="hidden" name="MAX_FILE_SIZE" value="3000000" />
  40.         <!-- 将name属性值能数组的形式提供 -->
  41.         <input type="file" name="my_pic[]" />
  42.         <input type="file" name="my_pic[]" />
  43.         <input type="file" name="my_pic[]" />
  44.         <button>上传</button>
  45.       </fieldset>
  46.     </form>
  47.     <br />
  48.     <form action="upload.php" method="POST" enctype="multipart/form-data">
  49.       <fieldset>
  50.         <legend>多文件上传: 批量上传（不限数）</legend>
  51.         <input type="hidden" name="MAX_FILE_SIZE" value="3000000" />
  52.         <!-- 将name属性值能数组的形式提供 -->
  53.         <input type="file" name="my_pic[]" multiple />
  54.         <button>上传</button>
  55.       </fieldset>
  56.     </form>
  57.   </body>
  58. </html>

效果图:

" class="reference-link">

" class="reference-link">

2.创建PHP上传文件处理类

  • 通过构造函数把多文件上传的文件信息保存到二维数组中
  • self::$files保存上传成功的文件信息，self::$files_err保存上传失败的文件信息
  • 然后可以通过saveFile()方法保存上传成功的文件到指定位置
  1. <?php
  2. class Upload
  3. {
  4.     public static $path='uploads/';//设置文件保存位置
  5.     public static $rename=0;//设置是否重命名,0 否，其它值 是
  6.     public static $files = array();//保存成功上传的文件
  7.     public static $files_err = array();//保存上传失败的文件信息
  8.     public static $result = array("success"=>[],"error"=>[]);//记录保存结果
  9.     public static $error_code = '';//错误码
  10.     public static $specify_type=array();//指定上传文件的格式
  11.     const ERR_MESSAGE = ['没有错误发生,文件上传成功','文件超过`php.ini`中`upload_max_filesize`值','文件大小超过表单中`MAX_FILE_SIZE`指定的值',
  12.     '文件只有部分被上传','没有文件被上传','', '找不到临时文件夹','文件写入失败','文件格式错误'];
  14.     /**
  15.      * 获取所有上传的文件信息，转为二维数组
  16.      * $files，$files_err，分开保存上传成功和失败的文件
  17.      */
  18.     public function __construct()
  19.     {
  20.         foreach($_FILES as $key=>$val){
  21.             //name如果是数组，循环获取数据,转为二维数组
  22.             if(is_array($val['name'])){
  23.                 $count = count($val['name']);
  24.                 for($i=0;$i<$count;$i++){
  25.                     //判断是否以POST方式上传了文件
  26.                     if($val['error'][$i]===0&&is_uploaded_file($val['tmp_name'][$i])){
  27.                         self::$files[]=array(
  28.                             'name'=>$val['name'][$i],
  29.                             'type'=>$val['type'][$i],
  30.                             'tmp_name'=>$val['tmp_name'][$i],
  31.                             'error'=>$val['error'][$i],
  32.                             'size'=>$val['size'][$i]   
  33.                         );
  34.                     }else{
  35.                         self::$files_err[]=array(
  36.                             'name'=>$val['name'][$i],
  37.                             'type'=>$val['type'][$i],
  38.                             'tmp_name'=>$val['tmp_name'][$i],
  39.                             'error'=>$val['error'][$i],
  40.                             'size'=>$val['size'][$i]   
  41.                         );
  42.                     }
  43.                 }
  44.             }else{
  45.                 //如果不是数组，直接获取数据
  46.                 if($val['error']===0&&is_uploaded_file($val['tmp_name']))
  47.                 {
  48.                     self::$files[]=$val;
  49.                 }else{
  50.                     self::$files_err[]=$val;
  51.                 }
  53.             }
  54.         }
  55.     }
  57.     /**
  58.      * 保存上传成功的文件，用户选择路径、是否重命名、限定文件类型
  59.      * $rename 重命名：0 否 ； 其它 是
  60.      */
  61.     public function saveFile(string $path='uploads/',int $rename=0,array $specify_type=[]):array 
  62.     {
  63.         self::$path=$path;
  64.         self::$rename=$rename;
  65.         self::$specify_type=$specify_type;
  66.         foreach(self::$files as $val){
  67.             $filename = $this->rename($val['name'],$rename);//重命名
  68.             if(!empty($specify_type)){
  69.                 //如果不属于指定的类型，保存错误信息，跳出本次循环
  70.                 if(!in_array($val['type'],$specify_type)){
  71.                     self::$result['error'][] =  $val['name'].":文件类型不符";
  72.                     continue;
  73.                 }
  74.             }
  75.             if(move_uploaded_file($val['tmp_name'], self::$path.$filename)){
  76.                 self::$result['success'][] = $val['name'].':'.self::$path.$filename;
  77.             }else{
  78.                 self::$result['error'][] = $val['name'].":保存失败";
  79.             }
  80.         }
  81.         return self::$result;
  82.     }
  84.     /**
  85.      * 按规则生成文件名
  86.      * $type : 0 否，其它 是
  87.      */
  88.     public function rename(string $filename,int $type=0):string{
  89.         $suffix = strrchr($filename,'.');//后缀
  90.         $finalname = $filename;
  92.         //如果文件名存在，又不重新命名,就在原文件名后加(1)
  93.         if(file_exists(self::$path.$filename)&&$type===0){
  94.             $finalname = basename($filename,strrchr($filename,'.')).'(1)'.$suffix;
  95.         }elseif($type!==0){
  96.             $finalname = date('Ymd',time()).rand(1000,9999).$suffix;
  97.         }
  99.         if(file_exists(self::$path.$finalname)){//再次检测名称是否已存在（重新生成）
  100.             $finalname = $this->rename($filename,$type);
  101.         }
  102.         return $finalname;
  103.     }
  104. }
  106. $upload = new Upload;
  107. print_r($upload::$files);//上传成功的文件
  108. print_r($upload::$files_err);//上传失败的文件
  109. print_r($upload->saveFile('uploads',1,['text/plain','image/jpeg']));

3.演示截图

上传文件：

打印结果：

Correcting teacher：天蓬老师天蓬老师

Correction status：qualified

Teacher's comments：这应该是有史以来最完整的文件上传方案
Statement of this Website
The copyright of this blog article belongs to the blogger. Please specify the address when reprinting! If there is any infringement or violation of the law, please contact admin@php.cn Report processing!
All comments Speak rationally on civilized internet, please comply with News Comment Service Agreement
0 comments
Author's latest blog post
About us Disclaimer Sitemap
php.cn：Public welfare online PHP training，Help PHP learners grow quickly！