Explication détaillée des exemples de classes de téléchargement de fichiers multifonctions PHP classiques

Le

Le téléchargement de fichiers est une fonction courante dans le développement de projets, mais le processus de téléchargement de fichiers est relativement lourd et ces codes complexes doivent être écrits partout où il y a un téléchargement de fichier. Afin de réduire la difficulté d'écrire des fonctions dans chaque développement et de gagner du temps de développement, nous encapsulons généralement ces morceaux de code utilisés à plusieurs reprises dans une classe. Aidez les développeurs lors de développements futurs à implémenter des fonctions de téléchargement de fichiers complexes en écrivant quelques codes simples. Pour les lecteurs ayant des bases faibles, il leur suffit de pouvoir utiliser ce cours. Pour ceux qui aiment les défis, ils peuvent essayer de le comprendre et développer leur propre Classe de téléchargement de fichiers.

1. Analyse des exigences

Il est nécessaire de personnaliser la classe de téléchargement de fichiers, qui est très simple à utiliser et peut compléter les fonctions suivantes :
　①Prend en charge le téléchargement d'un seul fichier.
　②Prise en charge de plusieurs téléchargements de fichiers.
　③Vous pouvez spécifier vous-même l'emplacement de stockage du fichier téléchargé, vous pouvez définir la taille et le type autorisés pour le fichier téléchargé, vous pouvez renommer le fichier téléchargé par le système et vous pouvez également définir le nom d'origine du fichier téléchargé. à retenir.
(Remarque : il est nécessaire que le téléchargement d'un seul fichier et le téléchargement de plusieurs fichiers utilisent la même méthode de fonctionnement, et certains paramètres de téléchargement doivent également utiliser la même méthode).

2. Programmation

Selon les exigences du programme, nous pouvons déclarer 4 attributs de membre visibles pour la classe de téléchargement de fichiers, afin que les utilisateurs puissent vous peut également définir certains comportements. Les attributs de membre requis sont présentés dans le tableau suivant :

Afin d'éviter que les valeurs d'attribut ne se voient attribuer des valeurs illégales, ces attributs de membre doivent être encapsulés. et n'est pas accessible en dehors de l'objet. Attribuez ensuite des valeurs aux quatre attributs membres ci-dessus via la méthode set() déclarée dans la classe. La méthode set() a deux paramètres. Le premier paramètre est le nom de l'attribut membre (non sensible à la casse) et le deuxième paramètre est la valeur correspondant à l'attribut dans le paramètre précédent. Une fois la méthode set() appelée, l'objet ($this) est renvoyé. Par conséquent, en plus d'attribuer des valeurs à chaque attribut individuellement, vous pouvez également effectuer des opérations consécutives pour attribuer des valeurs à plusieurs attributs ensemble. Dans cet exemple, en plus de la méthode set(), le plus important est d'implémenter la fonction de téléchargement de fichiers, le système fournit donc principalement les méthodes publiques suivantes pour implémenter les opérations de téléchargement de fichiers, comme indiqué dans le tableau suivant :

Afin d'éviter que les valeurs d'attribut ne se voient attribuer des valeurs illégales, ces attributs de membre doivent être encapsulés et ne sont pas accessibles en dehors de l'objet, puis les quatre membres ci-dessus les attributs peuvent se voir attribuer des valeurs via la méthode set() déclarée dans la classe. La méthode set() a deux paramètres. Le premier paramètre est le nom de l'attribut membre (non sensible à la casse) et le deuxième paramètre est la valeur correspondant à l'attribut dans le paramètre précédent. Une fois la méthode set() appelée, l'objet ($this) est renvoyé. Par conséquent, en plus d'attribuer des valeurs à chaque attribut individuellement, vous pouvez également effectuer des opérations consécutives pour attribuer des valeurs à plusieurs attributs ensemble. Dans cet exemple, en plus de la méthode set(), le plus important est d'implémenter la fonction de téléchargement de fichiers, le système fournit donc principalement les méthodes publiques suivantes pour implémenter les opérations de téléchargement de fichiers, comme indiqué dans le tableau suivant :

<?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. Processus d'application de la classe de téléchargement de fichiers

La classe de téléchargement de fichiers FileUpload dans cet exemple prend en charge le téléchargement de fichiers uniques et le téléchargement de plusieurs fichiers sur le serveur. aucune différence dans les méthodes de traitement Oui, mais lors de la rédaction d'une offre de téléchargement, plusieurs téléchargements de fichiers doivent être transmis au serveur dans un tableau. Le formulaire de téléchargement de fichier unique est le suivant :

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

Les formulaires ci-dessus pointent tous l'emplacement de soumission vers le même fichier upload.php, il n'est donc pas difficile de voir que les téléchargements de fichiers uniques et multiples sont traités dans de la même manière. Le code upload.php est le suivant :

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

'; } ?>

Dans le fichier upload.php, vous devez d'abord charger le fichier fileupload.class.php où se trouve le fichier upload FileUpload. Instanciez ensuite un objet de la classe de téléchargement de fichier, puis téléchargez le fichier en appelant la méthode upload(). Si le téléchargement réussit, vous pouvez obtenir le nom du fichier téléchargé via la méthode getFileName(). obtenez également l'erreur via la méthode getErrorMsg() Report. Si vous devez modifier certains comportements de téléchargement, vous pouvez terminer la configuration de certains attributs en appelant la méthode set(). La méthode set() peut être utilisée seule pour définir la valeur d'un attribut. Si vous devez modifier les valeurs de plusieurs attributs, vous pouvez appeler la méthode set() en continu pour la définir, ou vous pouvez définir plusieurs attributs à chaque fois. en même temps en fonctionnement continu.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!