分享一个PHP文件上传类

该类用于处理文件上传，可以上传一个文件，也可以上传多个文件。

包括的成员属性有：

 private $path            = "./uploads";              //上传文件保存的路径
 private $type            = array('jpg','gif','png'); //设置限制上传文件的类型
 private $maxSize      = 1000000;                  //限制文件上传大小（字节）
 private $isRandName = true;                        //设置是否随机重命名文件， false不随机
 private $isOverName  = false;                      //是否覆盖同名文件 false不覆盖 true覆盖
 private $errorNum      = 0;                           //错误号
 private $errorMsg       ="";                           //错误报告消息
 private $oldName;                                     //源文件名
 private $tmpFileName;                               //临时文件名
 private $fileType;                                      //文件类型(文件后缀)
 private $fileSize;                                       //文件大小
 private $newFileName;                               //新文件名

包含的方法有：

　　1、构造函数，用户初始化成员属性

 /**
  * 初始化成员属性 用于设置($path, $type, $maxSize, $isRandName)
  * @param [string] $key [成员属性名]
  * @param [type] $value [为成员属性设置的值]
  * @param array $option [成员初始值]
  */
 public function __construct($option = array()){
     foreach ($option as $key => $value) {
         if (!in_array($key, get_class_vars(get_class($this)))) {
             continue;
         }
         $this->setOption($key, $value);
     }
 }        

　　2、获取文件名称

 /**
  * 获取上传后的文件名称
  * @param  void   没有参数
  * @return string 上传后，新文件的名称， 如果是多文件上传返回数组
  */
 public function getFileName(){
     return $this->newFileName;
 }

　　3、返回错误信息

 /**
  * 上传失败后，调用该方法则返回，上传出错信息
  * @param  void   没有参数
  * @return string  返回上传文件出错的信息报告，如果是多文件上传返回数组
  */
 public function getErrorMsg(){
     return $this->errorMsg;
 }

　　4、设置$_FILES相关内容

 /* 设置和$_FILES有关的内容 */
 private function setFiles($name = "", $tmp_name = "", $size = 0, $error = 0) {
     $this->setOption('errorNum', $error);
     if($error){
         return false;
     }

     $this->setOption('oldName', $name);
     $this->setOption('tmpFileName', $tmp_name);
     $aryStr = explode(".", $name);
     $this->setOption('fileType', strtolower($aryStr[count($aryStr) - 1]));
     $this->setOption('fileSize', $size);
     return true;
 }

　　5、设置成员属性值

 /* 为单个成员属性设置值 */
 private function setOption($key, $val) {
     $this->$key = $val;
 }

　　6、设置上传后文件名

 /* 设置上传后的文件名称 */
 private function setNewFileName() {
     if ($this->isRandName) {
         $this->setOption('newFileName', $this->proRandName());
     } else{
         $this->setOption('newFileName', $this->oldName);
     }
 }

　　7、检查文件是否合法

 /* 检查上传的文件是否是合法的类型 */
 private function checkFileType() {
     if (in_array(strtolower($this->fileType), $this->type)) {
         return true;
     }else {
         $this->setOption('errorNum', -1);
         return false;
     }
 }

　　8、检查文件是否重名

 /*检查上传文件是否重名*/
 private function checkFileName(){
     $path = $this->path.'\\'.$this->newFileName;
     if (file_exists($path) && $this->isOverName != true) {
         $this->setOption('errorNum', -6);
         return false;
     }else{
         return true;
     }
 }

　　9、检查文件大小是否符合

 /* 检查上传的文件是否是允许的大小 */
 private function checkFileSize() {
     if ($this->fileSize > $this->maxSize) {
         $this->setOption('errorNum', -2);
         return false;
     }else{
         return true;
     }
 }

　　10、检查是否存在上传目录

 /* 检查是否有存放上传文件的目录 */
 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;
 }

　　11、设置随机文件名

 /* 设置随机文件名 */
 private function setRandName() {
     $fileName = date('YmdHis')."_".rand(10, 999);
     return $fileName.'.'.$this->fileType;
 }

　　12、移动上传文件到指定位置　　

 /* 移动上传文件到指定的位置 */
 private function moveFile() {
     if(!$this->errorNum) {
         $path = rtrim($this->path, '/').'/'.$this->newFileName;
         if (@move_uploaded_file($this->tmpFileName, $path)) {
             return true;
         }else{
             $this->setOption('errorNum', -3);
             return false;
         }
     } else {
         return false;
     }
 }

　　13、设置错误提示信息

 /* 设置上传出错信息 */
 private function getError() {
     $str = "上传文件<font color='red'>{$this->oldName}</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;
         case -6: $str .= "文件不能同名"; break;
         default: $str .= "未知错误";break;
     }
     return $str.'<br>';
 }

　　14、通过upload()方法上传文件

 /**
  * 调用该方法上传文件
  * @param  [type] $fileField [上传文件表单名称]
  * @return [type]            [上传成功返回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() || !$this->checkFileName()){
                     $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->moveFile()){
                         $errors[] = $this->getError();
                         $return = false;
                     }
                     $fileNames[] = $this->newFileName;
                 }
             }
             $this->newFileName = $fileNames;
         }
         $this->errorMsg = $errors;
         return $return;
         /*上传单个文件处理方法*/
     } else {
         /* 设置文件信息 */
         if($this->setFiles($name, $tmp_name, $size, $error)) {
             /* 上传之前先检查一下大小和类型 */
             if($this->checkFileSize() && $this->checkFileType() && $this->checkFileName()){
                 /* 为上传文件设置新文件名 */
                 $this->setNewFileName();
                 /* 上传文件  返回0为成功， 小于0都为错误 */
                 if($this->moveFile()){
                     return true;
                 }else{
                     $return = false;
                 }
             }else{
                 $return = false;
             }
         } else {
             $return = false;
         }
         //如果$return为false, 则出错，将错误信息保存在属性errorMsg中
         if(!$return){
             $this->errorMsg=$this->getError();
         }
         return $return;
     }
 }