使用PHP怎么編寫一個(gè)文件上傳類

使用PHP怎么編寫一個(gè)文件上傳類？相信很多沒有經(jīng)驗(yàn)的人對(duì)此束手無策，為此本文總結(jié)了問題出現(xiàn)的原因和解決方法，通過這篇文章希望你能解決這個(gè)問題。

php有什么用

php是一個(gè)嵌套的縮寫名稱，是英文超級(jí)文本預(yù)處理語言，它的語法混合了C、Java、Perl以及php自創(chuàng)新的語法，主要用來做網(wǎng)站開發(fā)，許多小型網(wǎng)站都用php開發(fā)，因?yàn)閜hp是開源的，從而使得php經(jīng)久不衰。

一、需求分析

　　要球自定義文件上傳類，即在使用非常簡(jiǎn)便的前提下，又可以完成以下幾項(xiàng)功能：
　?、僦С謫蝹€(gè)文件上傳。
　?、谥С侄鄠€(gè)文件上傳。
　?、劭梢宰约褐付ㄉ蟼魑募谋４嫖恢?，可以設(shè)置上傳文件允許的大小和類型，可以由系統(tǒng)對(duì)上傳文件重新命名，又可以設(shè)置保留上傳文件的原名。
　?。ㄕf明：要求單個(gè)文件上傳和多個(gè)文件上傳要采用同樣的操作方式，對(duì)上傳進(jìn)行的一些設(shè)置也要采用相同的方式）。

二、程序設(shè)計(jì)

　　根據(jù)程序需求的要求，我們可以為文件上傳類聲明4個(gè)可見的成員屬性，讓用戶在使用時(shí)還可以進(jìn)行一些行為的設(shè)置。需要的成員屬性如下表所示：

　　為避免屬性的值被賦上一些非法值，需要將這些成員屬性封裝起來，在對(duì)象外面不能訪問，再通過類中聲明的set()方法為以上四個(gè)成員屬性賦值。set()方法有兩個(gè)參數(shù)，第一個(gè)參數(shù)就是成員屬性名稱（不區(qū)分大小寫），第二個(gè)參數(shù)，就是前面參數(shù)中屬性對(duì)應(yīng)的值。set()方法調(diào)用完成以后，返回本對(duì)象($this)，所以除了可以單獨(dú)為每個(gè)屬性賦值以外，還可以進(jìn)行連貫操作一起為多個(gè)屬性賦值。本例中除了set()方法以外，最主要的是實(shí)現(xiàn)上傳文件的功能，所以系統(tǒng)主要提供了以下一些公有方法，實(shí)現(xiàn)文件上傳的操作，如下表所示：

　為避免屬性的值被賦上一些非法值，需要將這些成員屬性封裝起來，在對(duì)象外面不能訪問，再通過類中聲明的set()方法為以上四個(gè)成員屬性賦值。set()方法有兩個(gè)參數(shù)，第一個(gè)參數(shù)就是成員屬性名稱（不區(qū)分大小寫），第二個(gè)參數(shù)，就是前面參數(shù)中屬性對(duì)應(yīng)的值。set()方法調(diào)用完成以后，返回本對(duì)象($this)，所以除了可以單獨(dú)為每個(gè)屬性賦值以外，還可以進(jìn)行連貫操作一起為多個(gè)屬性賦值。本例中除了set()方法以外，最主要的是實(shí)現(xiàn)上傳文件的功能，所以系統(tǒng)主要提供了以下一些公有方法，實(shí)現(xiàn)文件上傳的操作，如下表所示：

<?php
  /** 
    file: fileupload.class.php 文件上傳類FileUpload
    本類的實(shí)例對(duì)象用于處理上傳文件，可以上傳一個(gè)文件，也可同時(shí)處理多個(gè)文件上傳
  */
  class FileUpload { 
    private $path = "./uploads";          //上傳文件保存的路徑
    private $allowtype = array('jpg','gif','png'); //設(shè)置限制上傳文件的類型
    private $maxsize = 1000000;           //限制文件上傳大?。ㄗ止?jié)）
    private $israndname = true;           //設(shè)置是否隨機(jī)重命名文件， false不隨機(jī)
 
    private $originName;              //源文件名
    private $tmpFileName;              //臨時(shí)文件名
    private $fileType;               //文件類型(文件后綴)
    private $fileSize;               //文件大小
    private $newFileName;              //新文件名
    private $errorNum = 0;             //錯(cuò)誤號(hào)
    private $errorMess="";             //錯(cuò)誤報(bào)告消息
 
    /**
     * 用于設(shè)置成員屬性（$path, $allowtype,$maxsize, $israndname）
     * 可以通過連貫操作一次設(shè)置多個(gè)屬性值
     *@param  string $key  成員屬性名(不區(qū)分大小寫)
     *@param  mixed  $val  為成員屬性設(shè)置的值
     *@return  object     返回自己對(duì)象$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;
    }
 
    /**
     * 調(diào)用該方法上傳文件
     * @param  string $fileFile  上傳文件的表單名稱 
     * @return bool        如果上傳成功返回?cái)?shù)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'];
 
      /* 如果是多個(gè)文件上傳則$file["name"]會(huì)是一個(gè)數(shù)組 */
      if(is_Array($name)){    
        $errors=array();
        /*多個(gè)文件上傳則循環(huán)處理 ， 這個(gè)循環(huán)只有檢查上傳文件的作用，并沒有真正上傳 */
        for($i = 0; $i < count($name); $i++){ 
          /*設(shè)置文件信息 */
          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){
          /* 存放所有上傳后文件名的變量數(shù)組 */
          $fileNames = array();      
          /* 如果上傳的多個(gè)文件都是合法的，則通過銷魂循環(huán)向服務(wù)器上傳文件 */
          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;
      /*上傳單個(gè)文件處理方法*/
      } else {
        /* 設(shè)置文件信息 */
        if($this->setFiles($name,$tmp_name,$size,$error)) {
          /* 上傳之前先檢查一下大小和類型 */
          if($this->checkFileSize() && $this->checkFileType()){ 
            /* 為上傳文件設(shè)置新文件名 */
            $this->setNewFileName(); 
            /* 上傳文件  返回0為成功， 小于0都為錯(cuò)誤 */
            if($this->copyFile()){ 
              return true;
            }else{
              $return=false;
            }
          }else{
            $return=false;
          }
        } else {
          $return=false; 
        }
        //如果$return為false, 則出錯(cuò)，將錯(cuò)誤信息保存在屬性errorMess中
        if(!$return)
          $this->errorMess=$this->getError();  
 
        return $return;
      }
    }
 
    /** 
     * 獲取上傳后的文件名稱
     * @param  void   沒有參數(shù)
     * @return string 上傳后，新文件的名稱， 如果是多文件上傳返回?cái)?shù)組
     */
    public function getFileName(){
      return $this->newFileName;
    }
 
    /**
     * 上傳失敗后，調(diào)用該方法則返回，上傳出錯(cuò)信息
     * @param  void   沒有參數(shù)
     * @return string  返回上傳文件出錯(cuò)的信息報(bào)告，如果是多文件上傳返回?cái)?shù)組
     */
    public function getErrorMsg(){
      return $this->errorMess;
    }
 
    /* 設(shè)置上傳出錯(cuò)信息 */
    private function getError() {
      $str = "上傳文件<font color='red'>{$this->originName}</font>時(shí)出錯(cuò) : ";
      switch ($this->errorNum) {
        case 4: $str .= "沒有文件被上傳"; break;
        case 3: $str .= "文件只有部分被上傳"; break;
        case 2: $str .= "上傳文件的大小超過了HTML表單中MAX_FILE_SIZE選項(xiàng)指定的值"; break;
        case 1: $str .= "上傳的文件超過了php.ini中upload_max_filesize選項(xiàng)限制的值"; break;
        case -1: $str .= "未允許類型"; break;
        case -2: $str .= "文件過大,上傳的文件不能超過{$this->maxsize}個(gè)字節(jié)"; break;
        case -3: $str .= "上傳失敗"; break;
        case -4: $str .= "建立存放上傳文件目錄失敗，請(qǐng)重新指定上傳目錄"; break;
        case -5: $str .= "必須指定上傳文件的路徑"; break;
        default: $str .= "未知錯(cuò)誤";
      }
      return $str.'<br>';
    }
 
    /* 設(shè)置和$_FILES有關(guān)的內(nèi)容 */
    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;
    }
 
    /* 為單個(gè)成員屬性設(shè)置值 */
    private function setOption($key, $val) {
      $this->$key = $val;
    }
 
    /* 設(shè)置上傳后的文件名稱 */
    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;
    }
 
    /* 設(shè)置隨機(jī)文件名 */
    private function proRandName() {    
      $fileName = date('YmdHis')."_".rand(100,999);    
      return $fileName.'.'.$this->fileType; 
    }
 
    /* 復(fù)制上傳文件到指定的位置 */
    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;
      }
    }
  }

四、文件上傳類的應(yīng)用過程

　　本例的文件上傳類FileUpload，即支持單文件上傳，也支持多個(gè)文件一起向服務(wù)器上傳，在處理方式上沒有區(qū)別的，只不過在編寫上傳標(biāo)單時(shí)，多個(gè)文件上傳一定要以數(shù)組方式傳遞給服務(wù)器。單個(gè)文件上傳表單如下所示：

<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>

　　上面表單，都將提交的位置指向了同一個(gè)文件upload.php，所以不難看出單個(gè)和多個(gè)文件上傳是一樣的處理方式，upload.php代碼如下所示：

<?php
    //包含一個(gè)文件上傳類中的上傳類
    include "fileupload.class.php";
 
    $up = new fileupload;
    //設(shè)置屬性(上傳的位置， 大小， 類型， 名是是否要隨機(jī)生成)
    $up -> set("path", "./images/");
    $up -> set("maxsize", 2000000);
    $up -> set("allowtype", array("gif", "png", "jpg","jpeg"));
    $up -> set("israndname", false);
 
    //使用對(duì)象中的upload方法， 就可以上傳文件， 方法需要傳一個(gè)上傳表單的名子 pic, 如果成功返回true, 失敗返回false
    if($up -> upload("pic")) {
        echo '<pre>';
        //獲取上傳后文件名子
        var_dump($up->getFileName());
        echo '</pre>';
 
    } else {
        echo '<pre>';
        //獲取上傳失敗以后的錯(cuò)誤提示
        var_dump($up->getErrorMsg());
        echo '</pre>';
    }
?>

　　在upload.php文件中，首先必須加載文件上傳FileUpload類所在的文件fileupload.class.php。再就是實(shí)例化文件上傳類的對(duì)象，然后通過調(diào)用upload()方法上傳文件，如果上傳成功，可以通過getFileName()方法獲取上傳后的文件名稱，如果上傳失敗，還可以通過getErrorMsg()方法獲取錯(cuò)誤報(bào)告。如果需要改變上傳的一些行為，可以通過調(diào)用set()方法來完成一些屬性的設(shè)置。set()方法可以單獨(dú)使用設(shè)置一個(gè)屬性的值，如果需要改變多個(gè)屬性的值，可以連續(xù)調(diào)用set()方法進(jìn)行設(shè)置，也可以連貫操作同時(shí)設(shè)置多個(gè)屬性。

看完上述內(nèi)容，你們掌握使用PHP怎么編寫一個(gè)文件上傳類的方法了嗎？如果還想學(xué)到更多技能或想了解更多相關(guān)內(nèi)容，歡迎關(guān)注億速云行業(yè)資訊頻道，感謝各位的閱讀！