PHP封装的多文件上传类实例与用法详解

/**//*

 * @(#)UploadFile.php

 *

 * 可同时处理用户多个上传文件。效验文件有效性后存储至指定目录。

 * 可返回上传文件的相关有用信息供其它程序使用。（如文件名、类型、大小、保存路径）

 * 使用方法请见本类底部（UploadFile类使用注释）信息。

 *

 */

classUploadFile {

 var$user_post_file=array();//用户上传的文件

 var$save_file_path; //存放用户上传文件的路径

 var$max_file_size;  //文件最大尺寸

 var$last_error;  //记录最后一次出错信息

 //默认允许用户上传的文件类型

 var$allow_type=array('gif','jpg','png','zip','rar','txt','doc','pdf');

 var$final_file_path;//最终保存的文件名

 var$save_info=array();//返回一组有用信息，用于提示用户。

 /**//**

 * 构造函数，用与初始化相关信息，用户待上传文件、存储路径等

 *

 * @param Array $file 用户上传的文件

 * @param String $path 存储用户上传文件的路径

 * @param Integer $size 允许用户上传文件的大小(字节)

 * @param Array $type  此数组中存放允计用户上传的文件类型

 */

 functionUploadFile($file,$path,$size= 2097152,$type='') {

 $this->user_post_file =$file;

 $this->save_file_path =$path;

 $this->max_file_size =$size;//如果用户不填写文件大小，则默认为2M.

 if($type!='')

  $this->allow_type =$type;

 }

 /**//**

 * 存储用户上传文件，检验合法性通过后，存储至指定位置。

 * @access public

 * @return int  值为0时上传失败，非0表示上传成功的个数。

 */

 functionupload() {

 for($i= 0;$iuser_post_file['name']);$i++) {

  //如果当前文件上传功能，则执行下一步。

  if($this->user_post_file['error'][$i] == 0) {

  //取当前文件名、临时文件名、大小、扩展名，后面将用到。

  $name=$this->user_post_file['name'][$i];

  $tmpname=$this->user_post_file['tmp_name'][$i];

  $size=$this->user_post_file['size'][$i];

  $mime_type=$this->user_post_file['type'][$i];

  $type=$this->getFileExt($this->user_post_file['name'][$i]);

  //检测当前上传文件大小是否合法。

  if(!$this->checkSize($size)) {

   $this->last_error ="The file size is too big. File name is: ".$name;

   $this->halt($this->last_error);

   continue;

  }

  //检测当前上传文件扩展名是否合法。

  if(!$this->checkType($type)) {

   $this->last_error ="Unallowable file type: .".$type." File name is: ".$name;

   $this->halt($this->last_error);

   continue;

  }

  //检测当前上传文件是否非法提交。

  if(!is_uploaded_file($tmpname)) {

   $this->last_error ="Invalid post file method. File name is: ".$name;

   $this->halt($this->last_error);

   continue;

  }

  //移动文件后，重命名文件用。

  $basename=$this->getBaseName($name,".".$type);

  //移动后的文件名

  $saveas=$basename."-".time().".".$type;

  //组合新文件名再存到指定目录下，格式：存储路径 + 文件名 + 时间 + 扩展名

  $this->final_file_path =$this->save_file_path."/".$saveas;

  if(!move_uploaded_file($tmpname,$this->final_file_path)) {

   $this->last_error =$this->user_post_file['error'][$i];

   $this->halt($this->last_error);

   continue;

  }

  //存储当前文件的有关信息，以便其它程序调用。

  $this->save_info[] =array("name"=>$name,"type"=>$type,

      "mime_type"=>$mime_type,

               "size"=>$size,"saveas"=>$saveas,

               "path"=>$this->final_file_path);

  }

 }

 returncount($this->save_info);//返回上传成功的文件数目

 }

 /**//**

 * 返回一些有用的信息，以便用于其它地方。

 * @access public

 * @return Array 返回最终保存的路径

 */

 functiongetSaveInfo() {

 return$this->save_info;

 }

 /**//**

 * 检测用户提交文件大小是否合法

 * @param Integer $size 用户上传文件的大小

 * @access private

 * @return boolean 如果为true说明大小合法，反之不合法

 */

 functioncheckSize($size) {

 if($size>$this->max_file_size) {

  returnfalse;

 }

 else{

  returntrue;

 }

 }

 /**//**

 * 检测用户提交文件类型是否合法

 * @access private

 * @return boolean 如果为true说明类型合法，反之不合法

 */

 functioncheckType($extension) {

 foreach($this->allow_typeas$type) {

  if(strcasecmp($extension,$type) == 0)

  returntrue;

 }

 returnfalse;

 }

 /**//**

 * 显示出错信息

 * @param $msg  要显示的出错信息

 * @access private

 */

 functionhalt($msg) {

 printf(" %s
n",$msg);

 }

 /**//**

 * 取文件扩展名

 * @param String $filename 给定要取扩展名的文件

 * @access private

 * @return String   返回给定文件扩展名

 */

 functiongetFileExt($filename) {

 $stuff=pathinfo($filename);

 return$stuff['extension'];

 }

 /**//**

 * 取给定文件文件名，不包括扩展名。

 * eg: getBaseName("j:/hexuzhong.jpg"); //返回 hexuzhong

 *

 * @param String $filename 给定要取文件名的文件

 * @access private

 * @return String 返回文件名

 */

 functiongetBaseName($filename,$type) {

 $basename=basename($filename,$type);

 return$basename;

 }

}

/**//******************** UploadFile类使用注释

//注意，上传组件name属性不管是一个还是多个都要使用数组形式，如：

//如果用户点击了上传按钮。

if ($_POST['action'] == "上传") {

 //设置允许用户上传的文件类型。

 $type = array('gif', 'jpg', 'png', 'zip', 'rar');

 //实例化上传类，第一个参数为用户上传的文件组、第二个参数为存储路径、

 //第三个参数为文件最大大小。如果不填则默认为2M

 //第四个参数为充许用户上传的类型数组。如果不填则默认为gif, jpg, png, zip, rar, txt, doc, pdf

 $upload = new UploadFile($_FILES['user_upload_file'], 'j:/tmp', 100000, $type);

 //上传用户文件，返回int值，为上传成功的文件个数。

 $num = $upload->upload();

 if ($num != 0) {

 echo "上传成功
";

 //取得文件的有关信息，文件名、类型、大小、路径。用print_r()打印出来。

 print_r($upload->getSaveInfo());

 //格式为： Array

 //  (

 //  [0] => Array(

 //    [name] => example.txt

 //    [type] => txt

 //    [size] => 526

 //    [path] => j:/tmp/example-1108898806.txt

 //    )

 //  )

 echo $num."个文件上传成功";

 }

 else {

 echo "上传失败
";

 }

}

*/

?>