一個PHP檔案上傳類分享_php執行個體

這篇文章主要介紹了一個經典的 PHP檔案上傳類分享,本文詳細全面的講解了 PHP檔案上傳相關的需求分析及功能實現,並同時分享了 PHP代碼,需要的朋友可以參考下本篇文章

檔案上傳是項目開發中比較常見的功能，但檔案上傳的過程比較繁瑣，只要是有檔案上傳的地方就需要編寫這些複雜的代碼。為了能在每次開發中降低功能的編寫難度，也為了能節省開發時間，通常我們都會將這些反覆使用的一段代碼封裝到一個類中。協助開發人員在以後的開發中，通過編寫幾條簡單代碼就可以實現複雜的檔案上傳功能。對於基礎薄弱的讀者，只要會使用本類即可，而對一些喜歡挑戰的朋友，可以嘗試去讀懂它，並能開發一個屬於自己的檔案上傳類。

一、需求分析

　　要球自訂檔案上傳類，即在使用非常簡便的前提下，又可以完成以下幾項功能：
　　①支援單個檔案上傳。
　　②支援多個檔案上傳。
　　③可以自己指定上傳檔案的儲存位置，可以設定上傳檔案允許的大小和類型，可以由系統對上傳檔案重新命名，又可以設定保留上傳檔案的原名。
　　（說明：要求單個檔案上傳和多個檔案上傳要採用同樣的操作方式，對上傳進行的一些設定也要採用相同的方式）。

二、程式設計

　　根據程式需求的要求，我們可以為檔案上傳類聲明4個可見的成員屬性，讓使用者在使用時還可以進行一些行為的設定。需要的成員屬性如下表所示：

　　為避免屬性的值被賦上一些非法值，需要將這些成員屬性封裝起來，在對象外面不能訪問，再通過類中聲明的set()方法為以上四個成員屬性賦值。set()方法有兩個參數，第一個參數就是成員屬性名稱（不區分大小寫），第二個參數，就是前面參數中屬性對應的值。set()方法調用完成以後，返回本對象($this)，所以除了可以單獨為每個屬性賦值以外，還可以進行連貫操作一起為多個屬性賦值。本例中除了set()方法以外，最主要的是實現上傳檔案的功能，所以系統主要提供了以下一些公有方法，實現檔案上傳的操作，如下表所示：

　為避免屬性的值被賦上一些非法值，需要將這些成員屬性封裝起來，在對象外面不能訪問，再通過類中聲明的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檔案上傳解析

php實現檔案上傳的範例程式碼分享