当前位置:Gxlcms > mysql > ThinkPHP3.2文件上传

ThinkPHP3.2文件上传

时间:2021-07-01 10:21:17 帮助过:60人阅读

上传表单 在ThinkPHP中使用上传功能无需进行特别处理。例如,下面是一个带有附件上传的表单提交: form action = __URL__/upload enctype = multipart/form-data method = post input type = text name = name / input type = file name = photo / input typ

上传表单

在ThinkPHP中使用上传功能无需进行特别处理。例如,下面是一个带有附件上传的表单提交:

注意,要使用上传功能 你的表单需要设置 enctype="multipart/form-data"

多文件上传支持

如果需要使用多个文件上传,只需要修改表单,把

  1. type='file'name='photo'>

改为

  1. type='file'name='photo1'>
  2. type='file'name='photo2'>
  3. type='file'name='photo3'>

或者

  1. type='file'name='photo[]'>
  2. type='file'name='photo[]'>
  3. type='file'name='photo[]'>

两种方式的多附件上传系统的文件上传类都可以自动识别。

上传操作

ThinkPHP文件上传操作使用Think\Upload类,假设前面的表单提交到当前控制器的upload方法,我们来看下upload方法的实现代码:

  1. publicfunction upload(){
  2. $upload =new \Think\Upload();// 实例化上传类
  3. $upload->maxSize =3145728;// 设置附件上传大小
  4. $upload->exts = array('jpg','gif','png','jpeg');// 设置附件上传类型
  5. $upload->rootPath ='./Uploads/';// 设置附件上传根目录
  6. $upload->savePath ='';// 设置附件上传(子)目录
  7. // 上传文件
  8. $info = $upload->upload();
  9. if(!$info){// 上传错误提示错误信息
  10. $this->error($upload->getError());
  11. }else{// 上传成功
  12. $this->success('上传成功!');
  13. }
  14. }

上传类对图片文件的上传安全做了支持,如果企图上传非法的图像文件,系统会提示 非法图像文件。 为了更好的使用上传功能,建议你的服务器开启finfo模块支持

上传参数

在上传操作之前,我们可以对上传的属性进行一些设置,Upload类支持的属性设置包括:

属性 描述
maxSize 文件上传的最大文件大小(以字节为单位),0为不限大小
rootPath 文件上传保存的根路径
savePath 文件上传的保存路径(相对于根路径)
saveName 上传文件的保存规则,支持数组和字符串方式定义
saveExt 上传文件的保存后缀,不设置的话使用原文件后缀
replace 存在同名文件是否是覆盖,默认为false
exts 允许上传的文件后缀(留空为不限制),使用数组或者逗号分隔的字符串设置,默认为空
mimes 允许上传的文件类型(留空为不限制),使用数组或者逗号分隔的字符串设置,默认为空
autoSub 自动使用子目录保存上传文件 默认为true
subName 子目录创建方式,采用数组或者字符串方式定义
hash 是否生成文件的hash编码 默认为true
callback 检测文件是否存在回调,如果存在返回文件信息数组

上面的属性可以通过两种方式传入:

实例化传入

我们可以在实例化的时候直接传入参数数组,例如:

  1. $config = array(
  2. 'maxSize'=>3145728,
  3. 'rootPath'=>'./Uploads/',
  4. 'savePath'=>'',
  5. 'saveName'=> array('uniqid',''),
  6. 'exts'=> array('jpg','gif','png','jpeg'),
  7. 'autoSub'=>true,
  8. 'subName'=> array('date','Ymd'),
  9. );
  10. $upload =new \Think\Upload($config);// 实例化上传类

关于saveName和subName的使用后面我们会有详细的描述。

动态赋值

支持在实例化后动态赋值上传参数,例如:

  1. $upload =new \Think\Upload();// 实例化上传类
  2. $upload->maxSize =3145728;
  3. $upload->rootPath ='./Uploads/';
  4. $upload->savePath ='';
  5. $upload->saveName = array('uniqid','');
  6. $upload->exts = array('jpg','gif','png','jpeg');
  7. $upload->autoSub =true;
  8. $upload->subName = array('date','Ymd');

上面的设置和实例化传入的效果是一致的。

上传文件信息

设置好上传的参数后,就可以调用Think\Upload类的upload方法进行附件上传,如果失败,返回false,并且用getError方法获取错误提示信息;如果上传成功,就返回成功上传的文件信息数组。

  1. $upload =new \Think\Upload();// 实例化上传类
  2. $upload->maxSize =3145728;// 设置附件上传大小
  3. $upload->exts = array('jpg','gif','png','jpeg');// 设置附件上传类型
  4. $upload->rootPath ='./Uploads/';// 设置附件上传根目录
  5. $upload->savePath ='';// 设置附件上传(子)目录
  6. // 上传文件
  7. $info = $upload->upload();
  8. if(!$info){// 上传错误提示错误信息
  9. $this->error($upload->getError());
  10. }else{// 上传成功 获取上传文件信息
  11. foreach($info as $file){
  12. echo $file['savepath'].$file['savename'];
  13. }
  14. }

每个文件信息又是一个记录了下面信息的数组,包括:

属性 描述
key 附件上传的表单名称
savepath 上传文件的保存路径
name 上传文件的原始名称
savename 上传文件的保存名称
size 上传文件的大小
type 上传文件的MIME类型
ext 上传文件的后缀类型
md5 上传文件的md5哈希验证字符串 仅当hash设置开启后有效
sha1 上传文件的sha1哈希验证字符串 仅当hash设置开启后有效

文件上传成功后,就可以使用这些文件信息来进行其他的数据操作,例如保存到当前数据表或者单独的附件数据表。

例如,下面表示把上传信息保存到数据表的字段:

  1. $model = M('Photo');
  2. // 取得成功上传的文件信息
  3. $info = $upload->upload();
  4. // 保存当前数据对象
  5. $data['photo']= $info[0]['savename'];
  6. $data['create_time']= NOW_TIME;
  7. $model->add($data);

单文件上传

upload方法支持多文件上传,有时候,我们只需要上传一个文件,就可以使用Upload类提供的uploadOne方法上传单个文件,例如:

  1. publicfunction upload(){
  2. $upload =new \Think\Upload();// 实例化上传类
  3. $upload->maxSize =3145728;// 设置附件上传大小
  4. $upload->exts = array('jpg','gif','png','jpeg');// 设置附件上传类型
  5. $upload->rootPath ='./Uploads/';// 设置附件上传根目录
  6. // 上传单个文件
  7. $info = $upload->uploadOne($_FILES['photo1']);
  8. if(!$info){// 上传错误提示错误信息
  9. $this->error($upload->getError());
  10. }else{// 上传成功 获取上传文件信息
  11. echo $info['savepath'].$info['savename'];
  12. }
  13. }

uploadOne方法上传成功后返回的文件信息和upload方法的区别是只有单个文件信息的一维数组。

上传文件的命名规则

上传文件的命名规则(saveName)用于确保文件不会产生冲突或者覆盖的情况。命名规则的定义可以根据你的业务逻辑来调整,不是固定的。例如, 如果你采用时间戳的方式来定义命名规范,那么在同时上传多个文件的时候可能产生冲突(因为同一秒内可以上传多个文件),因此你需要根据你的业务需求来设置 合适的上传命名规则。这里顺便来说下saveName参数的具体用法。

一、采用函数方式

如果传入的字符串是一个函数名,那么表示采用函数动态生成上传文件名(不包括文件后缀),例如:

  1. // 采用时间戳命名
  2. $upload->saveName ='time';
  3. // 采用GUID序列命名
  4. $upload->saveName ='com_create_guid';

也可以采用用户自定义函数

  1. // 采用自定义函数命名
  2. $upload->saveName ='myfun';

默认的命名规则设置是采用uniqid函数生成一个唯一的字符串序列。

saveName的值支持数组和字符串两种方式,如果是只有一个参数或者没有参数的函数,直接使用字符串设置即可,如果需要传入额外的参数,可以使用数组方式,例如:

  1. // 采用date函数生成命名规则 传入Y-m-d参数
  2. $upload->saveName = array('date','Y-m-d');
  3. // 如果有多个参数需要传入的话 可以使用数组
  4. $upload->saveName = array('myFun',array('__FILE__','val1','val2'));

如果需要使用上传的原始文件名,可以采用__FILE__传入,所以上面的定义规则,最终的结果是 myFun('上传文件名','val1','val2')执行的结果。

二、直接设置上传文件名

如果传入的参数不是一个函数名,那么就会直接当做是上传文件名,例如:

  1. $upload->saveName = time().'_'.mt_rand();

表示上传的文件命名采用时间戳加一个随机数的组合字符串方式。

当然,如果觉得有必要,你还可以固定设置一个上传文件的命名规则,用于固定保存某个上传文件。

  1. $upload->saveName ='ThinkPHP';

三、保持上传文件名不变

如果你想保持上传的文件名不变,那么只需要设置命名规范为空即可,例如:

  1. $upload->saveName ='';

一般来说不建议保持不变,因为会导致相同的文件名上传后被覆盖的情况。

子目录保存

saveName只是用于设置文件的保存规则,不涉及到目录,如果希望对上传的文件分子目录保存,可以设置autoSubsubName参数来完成,例如:

  1. // 开启子目录保存 并以日期(格式为Ymd)为子目录
  2. $upload->autoSub =true;
  3. $upload->subName = array('date','Ymd');

可以使用自定义函数来保存,例如:

  1. // 开启子目录保存 并调用自定义函数get_user_id生成子目录
  2. $upload->autoSub =true;
  3. $upload->subName ='get_user_id';

和saveName参数一样,subName的定义可以采用数组和字符串的方式。

注意:如果get_user_id函数未定义的话,会直接以get_user_id字符串作为子目录的名称保存。

子目录保存和文件命名规则可以结合使用。

上传驱动

上传类可以支持不同的环境,通过相应的上传驱动来解决,默认情况下使用本地(Local)上传驱动,当然,你还可以设置当前默认的上传驱动类型,例如:

  1. 'FILE_UPLOAD_TYPE'=>'Ftp',
  2. 'UPLOAD_TYPE_CONFIG'=> array(
  3. 'host'=>'192.168.1.200',//服务器
  4. 'port'=>21,//端口
  5. 'timeout'=>90,//超时时间
  6. 'username'=>'ftp_user',//用户名
  7. 'password'=>'ftp_pwd',//密码 ),

表示当前使用Ftp作为上传类的驱动,上传的文件会通过FTP传到指定的远程服务器。

也可以在实例化上传类的时候指定,例如:

  1. $config = array(
  2. 'maxSize'=3145728,
  3. 'rootPath'='./Uploads/',
  4. 'savePath'='',
  5. 'saveName'= array('uniqid',''),
  6. 'exts'= array('jpg','gif','png','jpeg'),
  7. 'autoSub'=true,
  8. 'subName'= array('date','Ymd'),
  9. );
  10. $ftpConfig = array(
  11. 'host'=>'192.168.1.200',//服务器
  12. 'port'=>21,//端口
  13. 'timeout'=>90,//超时时间
  14. 'username'=>'ftp_user',//用户名
  15. 'password'=>'ftp_pwd',//密码 );
  16. $upload =new \Think\Upload($config,'Ftp',$ftpConfig);// 实例化上传类

人气教程排行