PHP封装一个通用好用的文件上传处理类

封装一个文件上传类完成基本功能如下：

1.可上传多个或单个文件

2.上传成功返回一个或多个文件名

3.上传失败则返回每个失败文件的错误信息

上传类中的基本功能：

1.构造参数，用户可以自定义配置参数，不限大小写，不限个数，不限顺序

2.检测：保存路径、文件类型、文件大小、文件名是否为随机文件名等

3.错误消息：如果在判断过程中出现错误，则生成错误号并返回错误消息

上传类如下：

<?php
/**
* 通用文件上传类
*/
class FileUpload
{
private $filepath;	//指定上传文件保存的路径
private $allowtype=array('gif','jpg','png','jpeg');//默认允许上传文件的类型
private $maxsize=5000;	//默认允许上传文件的最大长度
private $israndname=true;	//是否使用随机文件名，false则使用原文件名

private $originName; 	//原文件名
private $tmpFileName; 	//临时文件名
private $fileType;		//文件类型
private $fileSize;		//文件大小
private $newFileName; 	//新文件名
private $errorNum=0; 	//错误号
private $errorMsg=''; 	//错误消息

//初始化文件上传
//1.指定上传路径 2.限制类型 3.限制大小 4.是否使用随机文件名
//使用可变数组来实现构造函数的重载【重载】
//优点：
//用户可以自定义参数的个数和顺序
//用户在输入关联键值错误的情况下仍然可以使用默认参数，不影响代码执行
//不区分键名的大小写
function __construct($options=array()){
//如果使用$this->filepath=$filepath的常规构造函数初始化：参数个数顺序用户无法自定义，用户输入错误时代码无法执行
//根据类的对象获取类的属性的数组：get_class_vars(get_class($this));

//判断用户给定的数组中的key是存在于类的属性中，如果存在，则给属性重新赋值
foreach ($options as $key => $val) {
$key = strtolower($key);//将用户给定的key转为小写 比较
if (!array_key_exists($key, get_class_vars(get_class($this)))) {
continue;
}
$this->SetOptions($key,$val);
}
}

//上传文件
public function UploadFile($fileField){
//检查用户设置的上传文件的保存路径
if(!$this->CheckFilePath()){
$this->errorMsg=$this->SetErrorMsg();
return false;
}

//取得上传文件的信息
$name = $_FILES[$fileField]['name'];
$tmp_name = $_FILES[$fileField]['tmp_name'];
$size = $_FILES[$fileField]['size'];
$error = $_FILES[$fileField]['error'];

//判断 是否为多文件上传
//一个文件上传出错，则全部失败，全部正确则全部上传
$result=true;//申明变量$result用于判断上传过程中是否有错

//如果是多文件上传
if(is_array($name)){

//定义错误信息数组，存储出错信息
$errors = array();

//循环读取文件信息并保存文件
for ($i=0; $i < count($name); $i++) {
//循环遍历文件信息，判断类型和大小
if ($this->SetFileInfo($name[$i],$tmp_name[$i],$size[$i],$error[$i])) {
//检查文件大小和类型
if(!$this->CheckFileType()||!$this->CheckFileSize()){
//将出错信息储存到数组$errors中
$errors[]=$this->SetErrorMsg();
$result = false;
}
} else {
$errors[]=$this->SetErrorMsg();
$result = false;
}

//将文件属性初始化，以免出错的文件信息被保留
if(!$result){
$this->SetFileInfo();
}
}

//如果检查上传的所有文件都没有问题了，则保存所有文件
if ($result) {

//定义一个数组变量$fileNames，用于存储上传成功后的图片文件名
$fileNames = array();

//循环文件信息，保存文件
for ($i=0; $i < count($name); $i++) {
if ($this->SetFileInfo($name[$i],$tmp_name[$i],$size[$i],$error[$i])) {
$this->SetFileName();
if (!$this->CopyFile()) {
$errors=$this->SetErrorMsg();
$result=false;
} else {
$fileNames[]=$this->newFileName;
}
}
}

//将新文件名数组赋值给类的属性newFileName
$this->newFileName=$fileNames;
}

$this->errorMsg = $errors;
return $result;

}else{//如果是单个文件上传
if($this->SetFileInfo($name,$tmp_name,$size,$error)){
//检查文件大小和类型
if($this->CheckFileType()&&$this->CheckFileSize()){
//获取文件名
$this->SetFileName();
//保存文件
if($this->CopyFile())
{
return true;
}else{
$result=false;
}
}
else{
$result=false;
}
}else{
$result=false;
}
if(!$result){
$this->errorMsg= SetErrorMsg();
}
return $result;

}
}

//获取文件名
public function GetNewFileName(){
return $this->newFileName;
}

//获取错误信息
public function GetError(){
return $this->errorMsg;
}

//初始化文件信息
private function SetFileInfo($name='',$tmp_name='',$size=0,$error=0)
{
$this->SetOptions('errorNum',$error);
if($error){
return false;
}
$this->SetOptions('originName',$name);
$this->SetOptions('tmpFileName',$tmp_name);
$this->SetOptions('fileSize',$size);

$arrStr = explode('.', $name);
$this->SetOptions('fileType',strtolower($arrStr[count($arrStr)-1]));

return true;
}

//获取上传后的文件名
private function SetFileName()
{
if($this->israndname){
$fileName =@date('YmdHis').rand(100,999);
$fileName =  $fileName.'.'.$this->fileType;
$this->SetOptions("newFileName",$fileName);
}else{
$this->SetOptions('newFileName',$this->originName);
}
}

//上传失败时，获取失败消息
private function SetErrorMsg()
{
$msg='上传文件<font color="red">'.$this->originName.'</font>时出错：';
switch ($this->errorNum) {
case 4:$msg.="没有文件被上传";break;
case 3:$msg.="文件只有部分被上传";break;
case 2:$msg.="文件的大小超过了 HTML 表单中 MAX_FILE_SIZE 选项指定的值";break;
case 1:$msg.="文件超过了 php.ini 中 upload_max_filesize 选项限制的值";break;
case -1:$msg.="未允许的文件类型";break;
case -2:$msg.="文件过大，上传文件不能超过{$this->maxSize}个字节";break;
case -3:$msg.="上传失败";break;
case -4:$msg.="建立存放文件目录失败，请重新指定上传目录";break;
case -5:$msg.="必须指定上传文件的路径";break;
default:$msg.="未知错误";
}
return $msg.'<br>';
}

//设置属性
private function SetOptions($key,$val){
$this->$key=$val;
}

//检查文件的保存路径
private function CheckFilePath(){
//如果用户没有指定文件的保存路径
if(empty($this->filepath)){
$this->SetOptions('errorNum',-5);
return false;
}

//如果用户设置的文件目录不存在或不可写
if(!file_exists($this->filepath)||!is_writable($this->filepath)){
//尝试创建目录，如果不成功，则设置错误信息
if(!@mkdir($this->filepath,0755)){
$this->SetOptions('errorNum',-4);
return false;
}
}

return true;
}

//检查上传的文件类型
private function CheckFileType(){
if(in_array(strtolower($this->fileType),$this->allowtype)){
return true;
}else{
$this->SetOptions("errorNum",-1);
return false;
}
}

//检查上传的文件大小
private function CheckFileSize(){
if($this->fileSize>$this->maxsize){
$this->SetOptions('errorNum',-2);
return false;
}else{
return true;
}
}

//保存文件 移动成功返回true,否则返回false
private function CopyFile(){
if (!$this->errorNum) {
$newPath=rtrim($this->filepath,'/').'/';
$newPath.=$this->newFileName;

if(@move_uploaded_file($this->tmpFileName, $newPath)){
return true;
}else{
$this->SetOptions('errorNum',-3);
return false;
}
} else {
return false;
}
}

}
?>

HTML 上传页面

PHP接收文件处理页面

上传失败：

上传成功：

注：本文参考于兄弟边PHP教程制作