PHP学习笔记之文件上传类代码实现

文件上传类代码示例：

/**
* Class FileUpload 文件上传类
* author: akon
* 使用方法：
*  $up = new FileUpload;
    $up->set('path','./uploads/')
      ->set('size',1)
      ->set('allowtype',array('gif','jpg','png'))
      ->set('israndname',true);
    if($up->upload('myfile')){
      print_r($up->getFileName());
    }else{
      print_r($up->getErrorMsg());
    }
*/
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 $key  成员属性名(不区分大小写)
    * @param $val  成员属性值
    * @return object  返回自己对象$this，可以用于连贯操作
    */
    public 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 $fileField  上传文件的表单名称
    * @return bool        如果上传成功则返回true
    */
    public function upload($fileField){
        $return = true;
        /*检查文件路径是否合法*/
        if( !$this->checkFilePath()){
            $this->errorMsg = $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->checkFilePath() && $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->errorMss = $this->getError();
            return $return;
        }
    }
    /**获取上传后的文件名称**/
    public function getFileName(){
        return $this->newFileName;
    }
    #-------------------------------------错误相关 start-------------------------------------#
    /**上传失败后，调用该方法则返回上传出错信息**/
    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/>";
    }

    #-------------------------------------错误相关 end-------------------------------------#

    #-------------------------------------设置相关 start-------------------------------------#
    /**
    * 设置和$_FILES相关的内容
    * @param string $name
    * @param string $tmp_name
    * @param int $size
    * @param int $error
    * @return bool
    */
    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;
    }
    /**
    * 为单个成员属性设置值
    * @param $key    成员属性
    * @param $val    成员属性值
    */
    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);
        }
    }

    #-------------------------------------设置相关 end-------------------------------------#

    #-------------------------------------检查相关 start-------------------------------------#
    /**检查上传的文件是否是合法的类型**/
    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;
        }
    }

    #-------------------------------------检查相关 end-------------------------------------#

单文件上传表单：

<form action="upload.php" method="post" enctype="multipart/form-data">
    <input type="hidden" name="MAX_FILE_SIZE" value="1000000">
    选择文件1：<input type="file" name="myfile">
    <input type="submit" value="上传文件">
</form>

多文件上传表单：

<form action="upload.php" method="post" enctype="multipart/form-data">
    <input type="hidden" name="MAX_FILE_SIZE" value="1000000">
    选择文件1：<input type="file" name="myfile[]">
    选择文件2：<input type="file" name="myfile[]">
    <input type="submit" value="上传文件">
</form>

文件上传处理php代码：

include "FileUpload.class.php";
$up = new FileUpload;
$up->set('path','./uploads/')
    ->set('size',1)
    ->set('allowtype',array('gif','jpg','png'))
    ->set('israndname',true);
if($up->upload('myfile')){
    print_r($up->getFileName());
}else{
    print_r($up->getErrorMsg());
}