Detaillierte Erläuterung klassischer Beispiele für PHP-Multifunktions-Datei-Upload-Klassen

Datei-Upload ist eine häufige Funktion in der Projektentwicklung, aber der Prozess des Datei-Uploads ist relativ umständlich und diese komplexen Codes müssen überall dort geschrieben werden, wo ein Datei-Upload stattfindet. Um die Schwierigkeit beim Schreiben von Funktionen in jeder Entwicklung zu verringern und Entwicklungszeit zu sparen, kapseln wir diese wiederholt verwendeten Codeteile normalerweise in einer Klasse. Helfen Sie Entwicklern in der zukünftigen Entwicklung, komplexe Datei-Upload-Funktionen zu implementieren, indem Sie ein paar einfache Codes schreiben. Leser mit schwachen Grundlagen müssen nur in der Lage sein, diese Klasse zu nutzen. Wer Herausforderungen mag, kann versuchen, ihn zu verstehen und seine eigene Datei-Upload-Klasse zu entwickeln.

1. Anforderungsanalyse

Es ist notwendig, die Datei-Upload-Klasse anzupassen, die sehr einfach zu verwenden ist und die folgenden Funktionen ausführen kann:
　①Unterstützt das Hochladen einzelner Dateien.
　②Unterstützt das Hochladen mehrerer Dateien.
　③Sie können den Speicherort der hochgeladenen Datei selbst angeben, Sie können die für die hochgeladene Datei zulässige Größe und den zulässigen Typ festlegen, Sie können die hochgeladene Datei vom System umbenennen und Sie können auch den ursprünglichen Namen der hochgeladenen Datei festlegen beibehalten werden.
(Hinweis: Es ist erforderlich, dass beim Hochladen einzelner Dateien und beim Hochladen mehrerer Dateien dieselbe Vorgangsmethode verwendet wird, und einige Einstellungen für den Upload müssen ebenfalls dieselbe Methode verwenden.)

2. Programmierung

Gemäß den Anforderungen des Programms können wir 4 sichtbare Mitgliedsattribute für die Datei-Upload-Klasse deklarieren, damit Benutzer sie nutzen können kann auch einige Verhaltensweisen festlegen. Die erforderlichen Mitgliedsattribute sind in der folgenden Tabelle aufgeführt:

Um zu verhindern, dass den Attributwerten unzulässige Werte zugewiesen werden, müssen diese Mitgliedsattribute gekapselt werden Auf sie kann außerhalb des Objekts nicht zugegriffen werden. Weisen Sie dann den oben genannten vier Mitgliedsattributen über die in der Klasse deklarierte set()-Methode Werte zu. Die set()-Methode verfügt über zwei Parameter. Der erste Parameter ist der Name des Mitgliedsattributs (ohne Berücksichtigung der Groß-/Kleinschreibung) und der zweite Parameter ist der Wert, der dem Attribut im vorherigen Parameter entspricht. Nach dem Aufruf der set()-Methode wird das Objekt ($this) zurückgegeben. Daher können Sie nicht nur jedem Attribut einzeln Werte zuweisen, sondern auch aufeinanderfolgende Vorgänge ausführen, um mehreren Attributen gemeinsam Werte zuzuweisen. In diesem Beispiel besteht das Wichtigste neben der set()-Methode darin, die Funktion zum Hochladen von Dateien zu implementieren. Daher stellt das System hauptsächlich die folgenden öffentlichen Methoden zum Implementieren von Datei-Upload-Vorgängen bereit, wie in der folgenden Tabelle gezeigt:

Um zu verhindern, dass den Attributwerten einige illegale Werte zugewiesen werden, müssen diese Mitgliedsattribute gekapselt werden und können nicht außerhalb des Objekts und dann auf die oben genannten vier Mitglieder zugegriffen werden Attributen können über die in der Klasse deklarierte set()-Methode Werte zugewiesen werden. Die set()-Methode verfügt über zwei Parameter. Der erste Parameter ist der Name des Mitgliedsattributs (ohne Berücksichtigung der Groß-/Kleinschreibung) und der zweite Parameter ist der Wert, der dem Attribut im vorherigen Parameter entspricht. Nach dem Aufruf der set()-Methode wird das Objekt ($this) zurückgegeben. Daher können Sie nicht nur jedem Attribut einzeln Werte zuweisen, sondern auch aufeinanderfolgende Vorgänge ausführen, um mehreren Attributen gemeinsam Werte zuzuweisen. In diesem Beispiel besteht das Wichtigste neben der set()-Methode darin, die Funktion zum Hochladen von Dateien zu implementieren. Daher stellt das System hauptsächlich die folgenden öffentlichen Methoden zum Implementieren von Datei-Upload-Vorgängen bereit, wie in der folgenden Tabelle gezeigt:

<?php
  /** 
    file: fileupload.class.php 文件上传类FileUpload
    本类的实例对象用于处理上传文件，可以上传一个文件，也可同时处理多个文件上传
  */
  class FileUpload { 
    private $path = "./uploads";          //上传文件保存的路径
    private $allowtype = array(&#39;jpg&#39;,&#39;gif&#39;,&#39;png&#39;); //设置限制上传文件的类型
    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][&#39;name&#39;];
      $tmp_name = $_FILES[$fileField][&#39;tmp_name&#39;];
      $size = $_FILES[$fileField][&#39;size&#39;];
      $error = $_FILES[$fileField][&#39;error&#39;];
 
      /* 如果是多个文件上传则$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=&#39;red&#39;>{$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.&#39;<br>&#39;;
    }
 
    /* 设置和$_FILES有关的内容 */
    private function setFiles($name="", $tmp_name="", $size=0, $error=0) {
      $this->setOption(&#39;errorNum&#39;, $error);
      if($error)
        return false;
      $this->setOption(&#39;originName&#39;, $name);
      $this->setOption(&#39;tmpFileName&#39;,$tmp_name);
      $aryStr = explode(".", $name);
      $this->setOption(&#39;fileType&#39;, strtolower($aryStr[count($aryStr)-1]));
      $this->setOption(&#39;fileSize&#39;, $size);
      return true;
    }
 
    /* 为单个成员属性设置值 */
    private function setOption($key, $val) {
      $this->$key = $val;
    }
 
    /* 设置上传后的文件名称 */
    private function setNewFileName() {
      if ($this->israndname) {
        $this->setOption(&#39;newFileName&#39;, $this->proRandName());  
      } else{ 
        $this->setOption(&#39;newFileName&#39;, $this->originName);
      } 
    }
 
    /* 检查上传的文件是否是合法的类型 */
    private function checkFileType() {
      if (in_array(strtolower($this->fileType), $this->allowtype)) {
        return true;
      }else {
        $this->setOption(&#39;errorNum&#39;, -1);
        return false;
      }
    }
 
    /* 检查上传的文件是否是允许的大小 */
    private function checkFileSize() {
      if ($this->fileSize > $this->maxsize) {
        $this->setOption(&#39;errorNum&#39;, -2);
        return false;
      }else{
        return true;
      }
    }
 
    /* 检查是否有存放上传文件的目录 */
    private function checkFilePath() {
      if(empty($this->path)){
        $this->setOption(&#39;errorNum&#39;, -5);
        return false;
      }
      if (!file_exists($this->path) || !is_writable($this->path)) {
        if (!@mkdir($this->path, 0755)) {
          $this->setOption(&#39;errorNum&#39;, -4);
          return false;
        }
      }
      return true;
    }
 
    /* 设置随机文件名 */
    private function proRandName() {    
      $fileName = date(&#39;YmdHis&#39;)."_".rand(100,999);    
      return $fileName.&#39;.&#39;.$this->fileType; 
    }
 
    /* 复制上传文件到指定的位置 */
    private function copyFile() {
      if(!$this->errorNum) {
        $path = rtrim($this->path, &#39;/&#39;).&#39;/&#39;;
        $path .= $this->newFileName;
        if (@move_uploaded_file($this->tmpFileName, $path)) {
          return true;
        }else{
          $this->setOption(&#39;errorNum&#39;, -3);
          return false;
        }
      } else {
        return false;
      }
    }
  }

4. Anwendungsprozess der Datei-Upload-Klasse

Die Datei-Upload-Klasse FileUpload unterstützt in diesem Beispiel das Hochladen einzelner Dateien und mehrerer Dateien gleichzeitig Kein Unterschied in den Verarbeitungsmethoden. Ja, aber beim Schreiben eines Upload-Gebots müssen mehrere Datei-Uploads in einem Array an den Server übergeben werden. Das Formular zum Hochladen einzelner Dateien lautet wie folgt:

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

Die oben genannten Formulare verweisen alle auf den Übermittlungsort auf dieselbe Datei upload.php, sodass es nicht schwer zu erkennen ist, dass einzelne und mehrere Datei-Uploads verarbeitet werden Auf die gleiche Weise. Der upload.php-Code lautet wie folgt:

<?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 &#39;<pre class="brush:php;toolbar:false">&#39;;
        //获取上传后文件名子
        var_dump($up->getFileName());
        echo &#39;

'; } else { echo '

';
        //获取上传失败以后的错误提示
        var_dump($up->getErrorMsg());
        echo '

'; } ?>

In der Datei upload.php müssen Sie zunächst die Datei fileupload.class.php laden, in der sich die Datei-Upload-Klasse FileUpload befindet. Instanziieren Sie dann ein Objekt der Datei-Upload-Klasse und laden Sie die Datei hoch, indem Sie die Methode upload() aufrufen. Wenn der Upload erfolgreich ist, können Sie den Namen der hochgeladenen Datei über die Methode getFileName() abrufen Erhalten Sie den Fehler auch über die Methode getErrorMsg(). Wenn Sie einige Upload-Verhaltensweisen ändern müssen, können Sie die Einstellung einiger Attribute abschließen, indem Sie die Methode set() aufrufen. Die set()-Methode kann alleine verwendet werden, um den Wert eines Attributs festzulegen. Wenn Sie die Werte mehrerer Attribute ändern müssen, können Sie die set()-Methode kontinuierlich aufrufen, um sie festzulegen, oder Sie können mehrere Attribute gleichzeitig festlegen gleichzeitig im Dauerbetrieb.

Das obige ist der detaillierte Inhalt vonDetaillierte Erläuterung klassischer Beispiele für PHP-Multifunktions-Datei-Upload-Klassen. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!