当前位置：Gxlcms > php框架 > 一个经典的PHP文件上传类分享

一个经典的PHP文件上传类分享

时间：2021-07-01 10:21:17 帮助过：34人阅读

文件上传是项目开发中比较常见的功能，但文件上传的过程比较繁琐，只要是有文件上传的地方就需要编写这些复杂的代码。为了能在每次开发中降低功能的编写难度，也为了能节省开发时间，通常我们都会将这些反复使用的一段代码封装到一个类中。帮助开发者在以后的开发中，通过编写几条简单代码就可以实现复杂的文件上传功能。对于基础薄弱的读者，只要会使用本类即可，而对一些喜欢挑战的朋友，可以尝试去读懂它，并能开发一个属于自己的文件上传类。

一、需求分析

　　要球自定义文件上传类，即在使用非常简便的前提下，又可以完成以下几项功能：
　　①支持单个文件上传。
　　②支持多个文件上传。
　　③可以自己指定上传文件的保存位置，可以设置上传文件允许的大小和类型，可以由系统对上传文件重新命名，又可以设置保留上传文件的原名。
　　（说明：要求单个文件上传和多个文件上传要采用同样的操作方式，对上传进行的一些设置也要采用相同的方式）。

二、程序设计

　　根据程序需求的要求，我们可以为文件上传类声明4个可见的成员属性，让用户在使用时还可以进行一些行为的设置。需要的成员属性如下表所示：

　　为避免属性的值被赋上一些非法值，需要将这些成员属性封装起来，在对象外面不能访问，再通过类中声明的set()方法为以上四个成员属性赋值。set()方法有两个参数，第一个参数就是成员属性名称（不区分大小写），第二个参数，就是前面参数中属性对应的值。set()方法调用完成以后，返回本对象($this)，所以除了可以单独为每个属性赋值以外，还可以进行连贯操作一起为多个属性赋值。本例中除了set()方法以外，最主要的是实现上传文件的功能，所以系统主要提供了以下一些公有方法，实现文件上传的操作，如下表所示：

　为避免属性的值被赋上一些非法值，需要将这些成员属性封装起来，在对象外面不能访问，再通过类中声明的set()方法为以上四个成员属性赋值。set()方法有两个参数，第一个参数就是成员属性名称（不区分大小写），第二个参数，就是前面参数中属性对应的值。set()方法调用完成以后，返回本对象($this)，所以除了可以单独为每个属性赋值以外，还可以进行连贯操作一起为多个属性赋值。本例中除了set()方法以外，最主要的是实现上传文件的功能，所以系统主要提供了以下一些公有方法，实现文件上传的操作，如下表所示：

  1. <?php
  2.   /** 
  3.     file: fileupload.class.php 文件上传类FileUpload
  4.     本类的实例对象用于处理上传文件，可以上传一个文件，也可同时处理多个文件上传
  5.   */
  6.   class FileUpload { 
  7.     private $path = "./uploads";          //上传文件保存的路径
  8.     private $allowtype = array('jpg','gif','png'); //设置限制上传文件的类型
  9.     private $maxsize = 1000000;           //限制文件上传大小（字节）
  10.     private $israndname = true;           //设置是否随机重命名文件， false不随机
  11.  
  12.     private $originName;              //源文件名
  13.     private $tmpFileName;              //临时文件名
  14.     private $fileType;               //文件类型(文件后缀)
  15.     private $fileSize;               //文件大小
  16.     private $newFileName;              //新文件名
  17.     private $errorNum = 0;             //错误号
  18.     private $errorMess="";             //错误报告消息
  19.  
  20.     /**
  21.      * 用于设置成员属性（$path, $allowtype,$maxsize, $israndname）
  22.      * 可以通过连贯操作一次设置多个属性值
  23.      *@param  string $key  成员属性名(不区分大小写)
  24.      *@param  mixed  $val  为成员属性设置的值
  25.      *@return  object     返回自己对象$this，可以用于连贯操作
  26.      */
  27.     function set($key, $val){
  28.       $key = strtolower($key); 
  29.       if( array_key_exists( $key, get_class_vars(get_class($this) ) ) ){
  30.         $this->setOption($key, $val);
  31.       }
  32.       return $this;
  33.     }
  34.  
  35.     /**
  36.      * 调用该方法上传文件
  37.      * @param  string $fileFile  上传文件的表单名称 
  38.      * @return bool        如果上传成功返回数true 
  39.      */
  40.  
  41.     function upload($fileField) {
  42.       $return = true;
  43.       /* 检查文件路径是滞合法 */
  44.       if( !$this->checkFilePath() ) {       
  45.         $this->errorMess = $this->getError();
  46.         return false;
  47.       }
  48.       /* 将文件上传的信息取出赋给变量 */
  49.       $name = $_FILES[$fileField]['name'];
  50.       $tmp_name = $_FILES[$fileField]['tmp_name'];
  51.       $size = $_FILES[$fileField]['size'];
  52.       $error = $_FILES[$fileField]['error'];
  53.  
  54.       /* 如果是多个文件上传则$file["name"]会是一个数组 */
  55.       if(is_Array($name)){    
  56.         $errors=array();
  57.         /*多个文件上传则循环处理 ， 这个循环只有检查上传文件的作用，并没有真正上传 */
  58.         for($i = 0; $i < count($name); $i++){ 
  59.           /*设置文件信息 */
  60.           if($this->setFiles($name[$i],$tmp_name[$i],$size[$i],$error[$i] )) {
  61.             if(!$this->checkFileSize() || !$this->checkFileType()){
  62.               $errors[] = $this->getError();
  63.               $return=false; 
  64.             }
  65.           }else{
  66.             $errors[] = $this->getError();
  67.             $return=false;
  68.           }
  69.           /* 如果有问题，则重新初使化属性 */
  70.           if(!$return)          
  71.             $this->setFiles();
  72.         }
  73.  
  74.         if($return){
  75.           /* 存放所有上传后文件名的变量数组 */
  76.           $fileNames = array();      
  77.           /* 如果上传的多个文件都是合法的，则通过销魂循环向服务器上传文件 */
  78.           for($i = 0; $i < count($name); $i++){ 
  79.             if($this->setFiles($name[$i], $tmp_name[$i], $size[$i], $error[$i] )) {
  80.               $this->setNewFileName(); 
  81.               if(!$this->copyFile()){
  82.                 $errors[] = $this->getError();
  83.                 $return = false;
  84.               }
  85.               $fileNames[] = $this->newFileName;  
  86.             }          
  87.           }
  88.           $this->newFileName = $fileNames;
  89.         }
  90.         $this->errorMess = $errors;
  91.         return $return;
  92.       /*上传单个文件处理方法*/
  93.       } else {
  94.         /* 设置文件信息 */
  95.         if($this->setFiles($name,$tmp_name,$size,$error)) {
  96.           /* 上传之前先检查一下大小和类型 */
  97.           if($this->checkFileSize() && $this->checkFileType()){ 
  98.             /* 为上传文件设置新文件名 */
  99.             $this->setNewFileName(); 
  100.             /* 上传文件  返回0为成功， 小于0都为错误 */
  101.             if($this->copyFile()){ 
  102.               return true;
  103.             }else{
  104.               $return=false;
  105.             }
  106.           }else{
  107.             $return=false;
  108.           }
  109.         } else {
  110.           $return=false; 
  111.         }
  112.         //如果$return为false, 则出错，将错误信息保存在属性errorMess中
  113.         if(!$return)
  114.           $this->errorMess=$this->getError();  
  115.  
  116.         return $return;
  117.       }
  118.     }
  119.  
  120.     /** 
  121.      * 获取上传后的文件名称
  122.      * @param  void   没有参数
  123.      * @return string 上传后，新文件的名称， 如果是多文件上传返回数组
  124.      */
  125.     public function getFileName(){
  126.       return $this->newFileName;
  127.     }
  128.  
  129.     /**
  130.      * 上传失败后，调用该方法则返回，上传出错信息
  131.      * @param  void   没有参数
  132.      * @return string  返回上传文件出错的信息报告，如果是多文件上传返回数组
  133.      */
  134.     public function getErrorMsg(){
  135.       return $this->errorMess;
  136.     }
  137.  
  138.     /* 设置上传出错信息 */
  139.     private function getError() {
  140.       $str = "上传文件<font color='red'>{$this->originName}</font>时出错 : ";
  141.       switch ($this->errorNum) {
  142.         case 4: $str .= "没有文件被上传"; break;
  143.         case 3: $str .= "文件只有部分被上传"; break;
  144.         case 2: $str .= "上传文件的大小超过了HTML表单中MAX_FILE_SIZE选项指定的值"; break;
  145.         case 1: $str .= "上传的文件超过了php.ini中upload_max_filesize选项限制的值"; break;
  146.         case -1: $str .= "未允许类型"; break;
  147.         case -2: $str .= "文件过大,上传的文件不能超过{$this->maxsize}个字节"; break;
  148.         case -3: $str .= "上传失败"; break;
  149.         case -4: $str .= "建立存放上传文件目录失败，请重新指定上传目录"; break;
  150.         case -5: $str .= "必须指定上传文件的路径"; break;
  151.         default: $str .= "未知错误";
  152.       }
  153.       return $str.'<br>';
  154.     }
  155.  
  156.     /* 设置和$_FILES有关的内容 */
  157.     private function setFiles($name="", $tmp_name="", $size=0, $error=0) {
  158.       $this->setOption('errorNum', $error);
  159.       if($error)
  160.         return false;
  161.       $this->setOption('originName', $name);
  162.       $this->setOption('tmpFileName',$tmp_name);
  163.       $aryStr = explode(".", $name);
  164.       $this->setOption('fileType', strtolower($aryStr[count($aryStr)-1]));
  165.       $this->setOption('fileSize', $size);
  166.       return true;
  167.     }
  168.  
  169.     /* 为单个成员属性设置值 */
  170.     private function setOption($key, $val) {
  171.       $this->$key = $val;
  172.     }
  173.  
  174.     /* 设置上传后的文件名称 */
  175.     private function setNewFileName() {
  176.       if ($this->israndname) {
  177.         $this->setOption('newFileName', $this->proRandName());  
  178.       } else{ 
  179.         $this->setOption('newFileName', $this->originName);
  180.       } 
  181.     }
  182.  
  183.     /* 检查上传的文件是否是合法的类型 */
  184.     private function checkFileType() {
  185.       if (in_array(strtolower($this->fileType), $this->allowtype)) {
  186.         return true;
  187.       }else {
  188.         $this->setOption('errorNum', -1);
  189.         return false;
  190.       }
  191.     }
  192.  
  193.     /* 检查上传的文件是否是允许的大小 */
  194.     private function checkFileSize() {
  195.       if ($this->fileSize > $this->maxsize) {
  196.         $this->setOption('errorNum', -2);
  197.         return false;
  198.       }else{
  199.         return true;
  200.       }
  201.     }
  202.  
  203.     /* 检查是否有存放上传文件的目录 */
  204.     private function checkFilePath() {
  205.       if(empty($this->path)){
  206.         $this->setOption('errorNum', -5);
  207.         return false;
  208.       }
  209.       if (!file_exists($this->path) || !is_writable($this->path)) {
  210.         if (!@mkdir($this->path, 0755)) {
  211.           $this->setOption('errorNum', -4);
  212.           return false;
  213.         }
  214.       }
  215.       return true;
  216.     }
  217.  
  218.     /* 设置随机文件名 */
  219.     private function proRandName() {    
  220.       $fileName = date('YmdHis')."_".rand(100,999);    
  221.       return $fileName.'.'.$this->fileType; 
  222.     }
  223.  
  224.     /* 复制上传文件到指定的位置 */
  225.     private function copyFile() {
  226.       if(!$this->errorNum) {
  227.         $path = rtrim($this->path, '/').'/';
  228.         $path .= $this->newFileName;
  229.         if (@move_uploaded_file($this->tmpFileName, $path)) {
  230.           return true;
  231.         }else{
  232.           $this->setOption('errorNum', -3);
  233.           return false;
  234.         }
  235.       } else {
  236.         return false;
  237.       }
  238.     }
  239.   }

四、文件上传类的应用过程

　　本例的文件上传类FileUpload，即支持单文件上传，也支持多个文件一起向服务器上传，在处理方式上没有区别的，只不过在编写上传标单时，多个文件上传一定要以数组方式传递给服务器。单个文件上传表单如下所示：

  1. <form action="upload.php" method="post" enctype="multipart/form-data" >
  2.     name: <input type="text" name="username" value="" /><br>
  3.     <input type="hidden" name="MAX_FILE_SIZE" value="1000000" />
  4.     up pic: <input type="file" name="pic[]" value=""><br>
  5.     up pic: <input type="file" name="pic[]" value=""><br>
  6.     up pic: <input type="file" name="pic[]" value=""><br>
  7.     up pic: <input type="file" name="pic[]" value=""><br>
  8.  
  9.     <input type="submit" value="upload" /><br>
  10.  
  11. </form>

　　上面表单，都将提交的位置指向了同一个文件upload.php，所以不难看出单个和多个文件上传是一样的处理方式，upload.php代码如下所示：

  1. <?php
  2.     //包含一个文件上传类中的上传类
  3.     include "fileupload.class.php";
  4.  
  5.     $up = new fileupload;
  6.     //设置属性(上传的位置， 大小， 类型， 名是是否要随机生成)
  7.     $up -> set("path", "./images/");
  8.     $up -> set("maxsize", 2000000);
  9.     $up -> set("allowtype", array("gif", "png", "jpg","jpeg"));
  10.     $up -> set("israndname", false);
  11.  
  12.     //使用对象中的upload方法， 就可以上传文件， 方法需要传一个上传表单的名子 pic, 如果成功返回true, 失败返回false
  13.     if($up -> upload("pic")) {
  14.         echo '<pre>';
  15.         //获取上传后文件名子
  16.         var_dump($up->getFileName());
  17.         echo '</pre>';
  18.  
  19.     } else {
  20.         echo '<pre>';
  21.         //获取上传失败以后的错误提示
  22.         var_dump($up->getErrorMsg());
  23.         echo '</pre>';
  24.     }
  25. ?>

　　在upload.php文件中，首先必须加载文件上传FileUpload类所在的文件fileupload.class.php。再就是实例化文件上传类的对象，然后通过调用upload()方法上传文件，如果上传成功，可以通过getFileName()方法获取上传后的文件名称，如果上传失败，还可以通过getErrorMsg()方法获取错误报告。如果需要改变上传的一些行为，可以通过调用set()方法来完成一些属性的设置。set()方法可以单独使用设置一个属性的值，如果需要改变多个属性的值，可以连续调用set()方法进行设置，也可以连贯操作同时设置多个属性。

下载PHP文件上传类:

文件上传类.rar

人气教程排行

本站所有资源全部来源于网络，若本站发布的内容侵害到您的隐私或者利益，请联系我们删除！