PHP 文件上传类 FileUpload 高洛峰老师 细说PHP

/*
 *文件名为FileUpload.class.php
 *将与文件上传相关的成员属性和成员方法声明在一起
 */
    class FileUpload{
            private $filePath;                                  //保存上传文件将被保存的目的路径
            private $fileField;                                 //保存从$_FILES[$fileField]中获取上传文件信息
            private $originName;                           //保存上传文件的源文件明年
            private $tmpFileName;                       //保存上传文件的临时文件名
            private $fileType;                                //保存上传文件的类型
            private $fileSize;                                  //保存上传文件的大小
            private $newFileName;                       //保存上传文件的新文件名
            //用于保存上传文件允许的文件类型(保存文件后缀名数组)
            private $allowType = array('txt','html','php','js','css','jpg','gif','png','doc','swf','rar','zip');
            private $maxSize = 1000000000;          //允许文件上传的最大长度,默认为1MB
            private $isUserDefName = false;          //文件上传后，是否采用用户自定文件名
            private $userDefName;                         //保存用户自定义的上传文件mingc
            private $isRandName = false;              //上传文件是否使用随机文件名称
            private $randName;                             //保存系统随机命名的上传文件名称
            private $errorNum = 0;                        //保存系统自定义的错误号,默认值为0
            private $isCoverModer = true;            //上传文件是否覆盖原有的文件,默认值为TRUE
            
            /*
             * 构造方法，创建上传文件对象时为部分成员属性列表赋初值
             * 参数options：提供一个数组,数组下标为成员属性名称,元素值为属性设置的值
             */
            function __construct($options=array()){
                                $this->setOptions($options);                    //调用内容方法为上传文件的属性列表赋值
            }
            
            /*
             * 在对象外部调用该法处理上传文件
             * 参数filefield提供全局变量数组$_FILES是的第二维数组
             * 返回值 如果文件上传成功返回TRUE，如果失败则返回FALSE
             */
            function uploadFile($filefield){
                            $this->setOption('errorNum',0);                    //为错误位设置初值
                            $this->setOption('fileField',$filefield);          //通过参数设置成员属性fileField的值
                            $this->setFiles();                                             //调用成员方法设置文件信息
                            $this->checkValid();                                        //判断上传文件是否有效
                            $this->checkFilePath();                                   //检查保存上传文件的路径是否正确
                            $this->setNewFileName();                              //将上传文件设置为新文件名
                            if($this->errorNum <0)                                   //检查上传文件是否出错
                                return $this->errorNum;                            //如果出错退出函数并返回错误号 
                            return $this->copyFile();                                 //将上传文件移动到指定位置  
            }
            
            /*
             * 为成员属性列表赋初值
             *  参数options：提供一个数组,数组下标为成员属性名称,元素值为属性设置的值
             */
            
            private function setOptions($options = array()){
                        foreach($options as $key => $val){//遍历参数数组
                            //检查数组的下标是否和成员属性同名
                            if(!in_array($key, array('filePath','fileField','originName','allowType','maxSize','isUserDefName','userDefName','isRandName','randName'))){
                                continue;//如果数组中没有正确的下标则退出循环
                            }
                            $this->setOption($key,$val);//将数组中的值赋给对应数组下标的成员属性
                        }
            }
            
            /*
             * 从$_FILES数组中取值，赋给对应的成员属性
             */
            private function setFiles(){
                if($this->getFileErrorFromFILES()!=0){//检查上传文件是否出现错误
                    $this->setOption('errorNum',-1);//如果有错误则设置错误标号为-1
                    return $this->errorNum;                //退出函数不向下执行
                }
                //调用对象内部函数为保存上传文件源名的成员属性赋值
                $this->setOption('originName',$this->getFileNameFromFILES());
                
                //保存上传文件临时文件名的成员属性赋值
                $this->setOption('tmpFileName',$this->getTmpFileNameFromFILES());
                
                //类型
                $this->setOption('fileType',$this->getFileTypeFromFILES());
                
                //大小
                $this->setOption('fileSize',$this->getFileSizeFromFILES());                
            }
            
            /*
             *为指定的成员属性赋值
             *参数key:提供保存成员属性名的变量
             *参数val:提供将要为成员属性赋的值
             */
            private function setOpiton($key,$val){
                    $this->$key = $val; //为成员属性赋值
            }
            
            /*
             * 为上传文件设置新的文件名称
             */
            private function setNewFileName(){
                //如果不允许随机文件名并且不允许用户自定义文件名，则新文件件名为上传文件源名
                if($this->isRandName==false && $this->isUserDefName==false){
                    $this->setOption('newFileName', $this->originName);
                }elseif($this->isRandName==ture && $this->isUserDefName==false){
                    $this->setOption('newFileName',$this->proRandName().'.'.$this->fileType);
                }elseif($this->isRandName==false && $this->isUserDefName==true){
                    $this->setOption('newFileName',$this->userDefName);
                }else{
                    $this->setOption('errorNum',-4);//以上条件都不成立 设置错误为-4
                }
            }
            
            /*
             * 检查上传是否有效
             */
            private function checkValid(){
                $this->checkFileSize();//检查上传文件大小是否超出范围
                $this->checkFileType();//检查上传文件类型是否为允许的类型
            }
            
            /*
             * 检查上传文件类型是否为允许的类型
             */
            private function checkFileType(){
                if(!in_array($this->fileType, $this->allowType)){
                    $this->setOption('errorNum',-2);
                        return $this->errorNum;
                }
            }

            /*
             * 检查上传文件大小是否超出范围
             */
            private function checkFileSize(){
                if($this->fileSize > $this->maxSize){
                    $this->setOption('errorNum',-3);
                    return $this->errorNum;
                }
            }
            
            /*
             * 检查保存上传文件的路径是否有效
             */
            private function checkFilePath(){
               if(!file_exists($this->filePath)){
                    if($this->isCoverModer){
                            $this->makePath();
                    }else{
                            $this->setOption('errorNum',-6);
                    }
                }
            }
            
            /*
             * 随机产生上传文件的新文件名称
             */
            private function  proRandName(){
                $tmpStr = 'abcdefghijklmnopqrstuvwxyz0123456789';
                $str = "";
                $len =strlen($tmpStr);
                for($i=0;$i<8;$i++){
                    $num = rand(0,$len);
                    $str .=$tmpStr[$num];                    
                }
                return $str;
            }
            
            /*
             * 创建保存上传文件的路径
             */
            private function makePath(){
                if(!@mkdir($this->filePath,0755)){
                    $this->setOption('errorNum',-7);
                }
            }
            
            /*
             * 将上传文件从临时目录中复制到指定的新位置
             */
            private function copyFile(){
                $filePath = $this->filePath;
                
                if($filePath[strlen($filePath)-1] != '/'){
                    $filePath .='/';
                }
                
                $filePath .= $this->newFileName;
                if(!@move_uploaded_file($this->tmpFileName, $filePath)){
                    $this->setOption('errorNum',-5);
                }
                return $this->errorNum;                
            }
            
            /*
             * 从全局变量数组$_FILES中获取上传文件的错误标号
             */
            private function getFileErrorFromFILES(){
                return $this->filedField['error'];
            }
            
            /*
             * 获取文件的后缀名
             */
            private function getFileTypeFromFILES(){
                $str =$this->fileField['name'];
                $aryStr = split("./", $str);
                $ret = strtolower($aryStr[count($aryStr)-1]);
                return $ret;
            }
            
            /*
             * 从全局变量数组$_FILES中获取上传文件的名称
             */
            private  function getFileNameFromFILES(){
                return $this->fileField['name'];
            }
            
            /*
             * 获取临时文件名称
             */
            private  function getTmpFileNameFromFILES(){
                return $this->fileField['tmp_name'];
            }
            
            /*
             *获取文件大小
             */
            private function getFileSizeFromFILES(){
                return $this->fileField['size'];
            }
            
            /*
             * 根据错误标号返回对应的错误信息
             */
            public function getErrorMsg(){
                $str ="上传文件出错:";
                switch ($this->errorNum){
                    case -1:
                        $str .= "未知错误";
                        break;
                    case -2:
                        $str .= "未允许类型";
                        break;           
                    case -3:
                        $str .= "文件过大";
                        break;
                    case -4:
                        $str .= "产生文件名出错";
                        break;
                    case -5:
                        $str .= "上传失败";
                        break;
                    case -6:
                        $str .= "目录不存在";
                        break;
                    case -7:
                        $str .= "建立目录失败";
                        break;
                }
                return $str;
            }                 
    }