클래식 PHP 다기능 파일 업로드 클래스 예제에 대한 자세한 설명

파일 업로드는 프로젝트 개발에서 흔히 사용되는 기능이지만, 파일 업로드 과정이 상대적으로 번거롭고 파일이 업로드되는 곳마다 이러한 복잡한 코드를 작성해야 합니다. 각 개발에서 함수 작성의 어려움을 줄이고 개발 시간을 절약하기 위해 일반적으로 반복적으로 사용되는 코드 조각을 클래스로 캡슐화합니다. 몇 가지 간단한 코드를 작성하여 향후 개발에서 개발자가 복잡한 파일 업로드 기능을 구현할 수 있도록 도와주세요. 기초가 약한 독자의 경우 이 클래스만 사용할 수 있으면 됩니다. 도전을 좋아하는 독자는 이를 이해하고 자신만의 파일 업로드 클래스를 개발해 볼 수 있습니다.

1. 요구사항 분석

매우 사용하기 쉽다는 전제하에 다음 기능을 완료할 수 있는 파일 업로드 클래스를 사용자 정의해야 합니다.
　①단일 파일 업로드를 지원합니다.
　②여러 파일 업로드를 지원합니다.
　 ③업로드한 파일의 저장 위치를 ​​직접 지정할 수 있고, 업로드한 파일에 허용되는 크기와 유형을 설정할 수 있으며, 업로드된 파일의 이름을 시스템에서 변경할 수 있으며, 업로드한 파일의 원본 이름을 다음과 같이 설정할 수도 있습니다. 유지됩니다.
　(참고: 단일 파일 업로드와 다중 파일 업로드에는 동일한 작업 방법을 사용해야 하며 업로드에 대한 일부 설정도 동일한 방식으로 수행되어야 합니다).

2. 프로그래밍

프로그램 요구 사항에 따라 파일 업로드 클래스에 대해 표시되는 4개의 멤버 속성을 선언할 수 있으므로 사용자는 이를 사용할 때 일부 동작을 설정할 수도 있습니다. 필수 멤버 속성은 다음 표와 같습니다.

　속성 값에 일부 잘못된 값이 할당되는 것을 방지하려면 이러한 멤버 속성을 캡슐화해야 하며 개체 외부에서 액세스할 수 없습니다. 클래스에 선언된 set() 메소드를 통해 위의 4가지 멤버 속성에 값을 할당합니다. set() 메소드에는 두 개의 매개변수가 있습니다. 첫 번째 매개변수는 구성원 속성의 이름(대소문자 구분 안 함)이고 두 번째 매개변수는 이전 매개변수의 속성에 해당하는 값입니다. set() 메소드가 호출된 후 객체($this)가 반환되므로 각 속성에 개별적으로 값을 할당하는 것 외에도 연속적인 작업을 수행하여 여러 속성에 값을 할당할 수도 있습니다. 이 예에서는 set() 메소드 외에 가장 중요한 것은 파일 업로드 기능을 구현하는 것이므로 시스템은 다음 표와 같이 파일 업로드 작업을 구현하기 위해 주로 다음과 같은 공개 메소드를 제공합니다.

속성을 방지하려면 일부 잘못된 값이 할당되어야 합니다. 이러한 멤버 속성은 캡슐화되어야 하며 객체 외부에서 액세스할 수 없습니다. 그런 다음 위의 네 가지 멤버 속성에 선언된 set() 메서드를 통해 값이 할당됩니다. 수업. set() 메소드에는 두 개의 매개변수가 있습니다. 첫 번째 매개변수는 구성원 속성의 이름(대소문자 구분 안 함)이고 두 번째 매개변수는 이전 매개변수의 속성에 해당하는 값입니다. set() 메소드가 호출된 후 객체($this)가 반환되므로 각 속성에 개별적으로 값을 할당하는 것 외에도 연속적인 작업을 수행하여 여러 속성에 값을 할당할 수도 있습니다. 이 예에서는 set() 메소드 외에 가장 중요한 것은 파일 업로드 기능을 구현하는 것이므로 시스템은 다음 표와 같이 파일 업로드 작업을 구현하기 위해 주로 다음 공개 메소드를 제공합니다.

<?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. 파일 업로드 클래스 신청 절차

이번 예시의 파일 업로드 클래스 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 파일을 가리키므로 단일 파일 업로드와 다중 파일 업로드가 동일한 방식으로 처리되는 것을 보면 어렵지 않습니다. .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 &#39;<pre class="brush:php;toolbar:false">&#39;;
        //获取上传后文件名子
        var_dump($up->getFileName());
        echo &#39;

';       } else {         echo '

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

';     } ?>

upload.php 파일에서 먼저 파일 업로드 FileUpload 클래스가 있는 fileupload.class.php 파일을 로드해야 합니다. 그런 다음 파일 업로드 클래스의 객체를 인스턴스화한 다음 upload() 메서드를 호출하여 파일을 업로드합니다. 업로드가 성공하면 getFileName() 메서드를 통해 업로드된 파일 이름을 가져올 수 있습니다. 또한 getErrorMsg() 메소드를 통해 오류를 가져옵니다. 일부 업로드 동작을 변경해야 하는 경우 set() 메서드를 호출하여 일부 속성 설정을 완료할 수 있습니다. set() 메소드를 단독으로 사용하여 여러 속성의 값을 변경할 수 있으며, set() 메소드를 연속적으로 호출하여 설정할 수도 있고, 한 번에 여러 속성을 설정할 수도 있습니다. 동시에 연속 작업을 수행합니다.

위 내용은 클래식 PHP 다기능 파일 업로드 클래스 예제에 대한 자세한 설명의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!