首页
所有分类
TAGS
文字工具 EMOJI BIBLE
编程 PHP

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

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

一、需求分析

要球自定义文件上传类，即在使用非常简便的前提下，又可以完成以下几项功能：

①支持单个文件上传。

②支持多个文件上传。

③可以自己指定上传文件的保存位置，可以设置上传文件允许的大小和类型，可以由系统对上传文件重新命名，又可以设置保留上传文件的原名。

（说明：要求单个文件上传和多个文件上传要采用同样的操作方式，对上传进行的一些设置也要采用相同的方式）。

二、程序设计

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

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

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

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

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

<?php
  /** 
    file: fileupload.class.php 文件上传类FileUpload
    本类的实例对象用于处理上传文件，可以上传一个文件，也可同时处理多个文件上传
  */
  class FileUpload { 
    private $path = "./uploads";          //上传文件保存的路径
    private $allowtype = array('jpg','gif','png'); //设置限制上传文件的类型
    private $maxsize = 1000000;           //限制文件上传大小（字节）
    private $israndname = true;           //设置是否随机重命名文件， false不随机
 
    private $originName;              //源文件名
    private $tmpFileName;              //临时文件名
    private $fileType;               //文件类型(文件后缀)
    private $fileSize;               //文件大小
    private $newFileName;              //新文件名
    private $errorNum = 0;             //错误号
    private $errorMess="";             //错误报告消息
 
    /**
     * 用于设置成员属性（$path, $allowtype,$maxsize, $israndname）
     * 可以通过连贯操作一次设置多个属性值
     *@param  string $key  成员属性名(不区分大小写)
     *@param  mixed  $val  为成员属性设置的值
     *@return  object     返回自己对象$this，可以用于连贯操作
     */
    function set($key, $val){
      $key = strtolower($key); 
      if( array_key_exists( $key, get_class_vars(get_class($this) ) ) ){
        $this->setOption($key, $val);
      }
      return $this;
    }
 
    /**
     * 调用该方法上传文件
     * @param  string $fileFile  上传文件的表单名称 
     * @return bool        如果上传成功返回数true 
     */
 
    function upload($fileField) {
      $return = true;
      /* 检查文件路径是滞合法 */
      if( !$this->checkFilePath() ) {       
        $this->errorMess = $this->getError();
        return false;
      }
      /* 将文件上传的信息取出赋给变量 */
      $name = $_FILES[$fileField]['name'];
      $tmp_name = $_FILES[$fileField]['tmp_name'];
      $size = $_FILES[$fileField]['size'];
      $error = $_FILES[$fileField]['error'];
 
      /* 如果是多个文件上传则$file["name"]会是一个数组 */
      if(is_Array($name)){    
        $errors=array();
        /*多个文件上传则循环处理 ， 这个循环只有检查上传文件的作用，并没有真正上传 */
        for($i = 0; $i < count($name); $i++){ 
          /*设置文件信息 */
          if($this->setFiles($name[$i],$tmp_name[$i],$size[$i],$error[$i] )) {
            if(!$this->checkFileSize() || !$this->checkFileType()){
              $errors[] = $this->getError();
              $return=false; 
            }
          }else{
            $errors[] = $this->getError();
            $return=false;
          }
          /* 如果有问题，则重新初使化属性 */
          if(!$return)          
            $this->setFiles();
        }
 
        if($return){
          /* 存放所有上传后文件名的变量数组 */
          $fileNames = array();      
          /* 如果上传的多个文件都是合法的，则通过销魂循环向服务器上传文件 */
          for($i = 0; $i < count($name); $i++){ 
            if($this->setFiles($name[$i], $tmp_name[$i], $size[$i], $error[$i] )) {
              $this->setNewFileName(); 
              if(!$this->copyFile()){
                $errors[] = $this->getError();
                $return = false;
              }
              $fileNames[] = $this->newFileName;  
            }          
          }
          $this->newFileName = $fileNames;
        }
        $this->errorMess = $errors;
        return $return;
      /*上传单个文件处理方法*/
      } else {
        /* 设置文件信息 */
        if($this->setFiles($name,$tmp_name,$size,$error)) {
          /* 上传之前先检查一下大小和类型 */
          if($this->checkFileSize() && $this->checkFileType()){ 
            /* 为上传文件设置新文件名 */
            $this->setNewFileName(); 
            /* 上传文件  返回0为成功， 小于0都为错误 */
            if($this->copyFile()){ 
              return true;
            }else{
              $return=false;
            }
          }else{
            $return=false;
          }
        } else {
          $return=false; 
        }
        //如果$return为false, 则出错，将错误信息保存在属性errorMess中
        if(!$return)
          $this->errorMess=$this->getError();  
 
        return $return;
      }
    }
 
    /** 
     * 获取上传后的文件名称
     * @param  void   没有参数
     * @return string 上传后，新文件的名称， 如果是多文件上传返回数组
     */
    public function getFileName(){
      return $this->newFileName;
    }
 
    /**
     * 上传失败后，调用该方法则返回，上传出错信息
     * @param  void   没有参数
     * @return string  返回上传文件出错的信息报告，如果是多文件上传返回数组
     */
    public function getErrorMsg(){
      return $this->errorMess;
    }
 
    /* 设置上传出错信息 */
    private function getError() {
      $str = "上传文件<font color='red'>{$this->originName}</font>时出错 : ";
      switch ($this->errorNum) {
        case 4: $str .= "没有文件被上传"; break;
        case 3: $str .= "文件只有部分被上传"; break;
        case 2: $str .= "上传文件的大小超过了HTML表单中MAX_FILE_SIZE选项指定的值"; break;
        case 1: $str .= "上传的文件超过了php.ini中upload_max_filesize选项限制的值"; break;
        case -1: $str .= "未允许类型"; break;
        case -2: $str .= "文件过大,上传的文件不能超过{$this->maxsize}个字节"; break;
        case -3: $str .= "上传失败"; break;
        case -4: $str .= "建立存放上传文件目录失败，请重新指定上传目录"; break;
        case -5: $str .= "必须指定上传文件的路径"; break;
        default: $str .= "未知错误";
      }
      return $str.'<br>';
    }
 
    /* 设置和$_FILES有关的内容 */
    private function setFiles($name="", $tmp_name="", $size=0, $error=0) {
      $this->setOption('errorNum', $error);
      if($error)
        return false;
      $this->setOption('originName', $name);
      $this->setOption('tmpFileName',$tmp_name);
      $aryStr = explode(".", $name);
      $this->setOption('fileType', strtolower($aryStr[count($aryStr)-1]));
      $this->setOption('fileSize', $size);
      return true;
    }
 
    /* 为单个成员属性设置值 */
    private function setOption($key, $val) {
      $this->$key = $val;
    }
 
    /* 设置上传后的文件名称 */
    private function setNewFileName() {
      if ($this->israndname) {
        $this->setOption('newFileName', $this->proRandName());  
      } else{ 
        $this->setOption('newFileName', $this->originName);
      } 
    }
 
    /* 检查上传的文件是否是合法的类型 */
    private function checkFileType() {
      if (in_array(strtolower($this->fileType), $this->allowtype)) {
        return true;
      }else {
        $this->setOption('errorNum', -1);
        return false;
      }
    }
 
    /* 检查上传的文件是否是允许的大小 */
    private function checkFileSize() {
      if ($this->fileSize > $this->maxsize) {
        $this->setOption('errorNum', -2);
        return false;
      }else{
        return true;
      }
    }
 
    /* 检查是否有存放上传文件的目录 */
    private function checkFilePath() {
      if(empty($this->path)){
        $this->setOption('errorNum', -5);
        return false;
      }
      if (!file_exists($this->path) || !is_writable($this->path)) {
        if (!@mkdir($this->path, 0755)) {
          $this->setOption('errorNum', -4);
          return false;
        }
      }
      return true;
    }
 
    /* 设置随机文件名 */
    private function proRandName() {    
      $fileName = date('YmdHis')."_".rand(100,999);    
      return $fileName.'.'.$this->fileType; 
    }
 
    /* 复制上传文件到指定的位置 */
    private function copyFile() {
      if(!$this->errorNum) {
        $path = rtrim($this->path, '/').'/';
        $path .= $this->newFileName;
        if (@move_uploaded_file($this->tmpFileName, $path)) {
          return true;
        }else{
          $this->setOption('errorNum', -3);
          return false;
        }
      } else {
        return false;
      }
    }
  }

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

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

<form action="upload.php" method="post" enctype="multipart/form-data" >
    name: <input type="text" name="username" value="" /><br>
    <input type="hidden" name="MAX_FILE_SIZE" value="1000000" />
    up pic: <input type="file" name="pic[]" value=""><br>
    up pic: <input type="file" name="pic[]" value=""><br>
    up pic: <input type="file" name="pic[]" value=""><br>
    up pic: <input type="file" name="pic[]" value=""><br>
 
    <input type="submit" value="upload" /><br>
 
</form>

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

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

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

下载PHP文件上传类:

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

- Author -

junjie

声明：登载此文出于传递更多信息之目的，并不意味着赞同其观点或证实其描述。

PHP 相关文章推荐
如何从一个php文件向另一个地址post数据，不用表单和隐藏的变量的
Mar 06 PHP
PHPMailer邮件类利用smtp.163.com发送邮件方法
Sep 11 PHP
PHP与Java进行通信的实现方法
Oct 21 PHP
php解压文件代码实现php在线解压
Feb 13 PHP
PHP父类调用子类方法的代码例子
Apr 09 PHP
php解决抢购秒杀抽奖等大流量并发入库导致的库存负数的问题
Jun 19 PHP
smarty中js的调用方法示例
Oct 27 PHP
PHP CURL 内存泄露问题解决方法
Feb 12 PHP
基于php实现七牛抓取远程图片
Dec 01 PHP
PHP中number_format()函数的用法讲解
Apr 08 PHP
PHP优化之批量操作MySQL实例分析
Apr 23 PHP
php实现微信和支付宝支付的示例代码
Aug 11 PHP
php数组查找函数总结
Nov 18 #PHP
一个经典的PHP验证码类分享
Nov 18 #PHP
一个经典实用的PHP图像处理类分享
Nov 18 #PHP
PHP中一些可以替代正则表达式函数的字符串操作函数
Nov 17 #PHP
PHP向浏览器输出内容的4个函数总结
Nov 17 #PHP
PHP中使用匿名函数操作数据库的例子
Nov 17 #PHP
PHP中定义数组常量（array常量）的方法
Nov 17 #PHP
请假条(31) 活动总结(790) 主持词(345) 建议书(203) 决心书(42) 广告词(105) 责任书(145) 倡议书(159) 感谢信(72) 保证书(97)
You might like
PHP中创建并处理图象
2006/10/09 PHP
php file_get_contents函数轻松采集html数据
2010/04/22 PHP
PHP中uploaded_files函数使用方法详解
2011/03/09 PHP
逆序二维数组插入一元素的php代码
2012/06/08 PHP
解析用PHP实现var_export的详细介绍
2013/06/20 PHP
PHP实现设计模式中的抽象工厂模式详解
2014/10/11 PHP
php格式化日期实例分析
2014/11/12 PHP
PHP命令Command模式用法实例分析
2018/08/08 PHP
LazyForm jQuery plugin 定制您的CheckBox Radio和Select
2009/10/24 Javascript
用json方式实现在 js 中建立一个map
2014/05/02 Javascript
JS中的form.submit()不能提交表单的错误原因
2014/10/08 Javascript
js实例属性和原型属性示例详解
2014/11/23 Javascript
JS控制文本域只读或可写属性的方法
2016/06/24 Javascript
14 个折磨人的 JavaScript 面试题
2016/08/08 Javascript
Js调用Java方法并互相传参的简单实例
2016/08/11 Javascript
简单实现js菜单栏切换效果
2017/03/04 Javascript
jQuery插件HighCharts实现的2D对数饼图效果示例【附demo源码下载】
2017/03/09 Javascript
浅谈Node.js轻量级Web框架Express4.x使用指南
2017/05/03 Javascript
利用vue和element-ui设置表格内容分页的实例
2018/03/02 Javascript
详解webpack loader和plugin编写
2018/10/12 Javascript
用Vue.js在浏览器中实现裁剪图像功能
2019/06/18 Javascript
vue之组件内监控$store中定义变量的变化详解
2019/11/08 Javascript
ES6函数和数组用法实例分析
2020/05/23 Javascript
在Django框架中编写Contact表单的教程
2015/07/17 Python
利用Python如何批量更新服务器文件
2018/07/29 Python
基于python生成英文版词云图代码实例
2020/05/16 Python
用Python实现定时备份Mongodb数据并上传到FTP服务器
2021/01/27 Python
优秀毕业生求职推荐信范文
2013/11/21 职场文书
开业典礼主持词
2014/03/21 职场文书
公路绿化方案
2014/05/12 职场文书
文明生主要事迹
2014/05/25 职场文书
机械电子工程专业自荐书
2014/06/10 职场文书
质量保证书格式
2015/02/27 职场文书
签约仪式致辞
2015/07/30 职场文书
golang 实现对Map进行键值自定义排序
2021/04/28 Golang
php修改word的实例方法
2021/11/17 PHP