# 文件上传类
![未命名-1.png](http://www.phpgrace.com/statics/images/201804/1524192027702732.png "1524191315163168.png")
**功能描述**
完成文件上传工作,并实现以下功能:
~~~
1、文件扩展名、类型检查
2、文件大小检查
3、目录创建
4、命名规则定制
~~~
**部署说明**
~~~
将 uper.php 文件直接部署到 phpGrace/tools/ 文件夹下
~~~
**使用说明**
**1、实例化上传对象**
~~~
$uper = new phpGrace\tools\uper('file', 'upload', '2.png');
uper 类构造函数参数
1、文件域名称
2、上传文件保存文件夹位置
3、可选参数【上传后文件名,默认 null - 根据设置的规则命名】
~~~
**2、设置上传信息【不设置则按照默认规则】**
~~~
$uper->allowType = 'image/png,image/jpeg,image/pjpeg,image/x-png,image/gif'; //设置上传允许的类型
$uper->allowExeName = 'jpg,gif,png'; //允许上传文件的扩展名
$uper->allowSize = 1024允许上传文件的大小 [单位 K]
$uper->dirCreateRule = 'no'; //子文件夹创建规则 no - 不自动创建 | y - 年 | m - 月 | d - 日
$uper->renameRule = 3; //文件重命名规则 1: 不重命名 | 2: 随机重命名 | 3: _1 后缀形式重命名
~~~
**3、上传文件**
~~~
$uper->upload();
//上传成功返回上传文件的路径,失败返回false
~~~
**演示代码**
~~~
class indexController extends grace{
public function index(){
//提交比对
if(!empty($_FILES['file'])){
$uper = new phpGrace\tools\uper('file', 'upload', '2.png');
$uploadedFile = $uper->upload();
if($uploadedFile){
echo '上传文件路径 : '.$uploadedFile;
}else{
echo $uper->error;
}
}
}
}
//html表单
~~~
*****
[![](https://img.kancloud.cn/a7/9d/a79dfffe82146f0da6374cbf605f73a4_890x43.png)]( https://lanzous.com/icywvva)
官方下载地址:[http://static.phpgrace.com/tools/uper.php](http://static.phpgrace.com/tools/uper.php)
*****