上传文件

ThinkPHP5.0对文件上传的支持更加简单。

内置的上传只是上传到本地服务器，上传到远程或者第三方平台的话需要自己扩展。

假设表单代码如下：

  1. <form action="/index/index/upload" enctype="multipart/form-data" method="post">
  2. <input type="file" name="image" /> <br> 
  3. <input type="submit" value="上传" /> 
  4. </form>

然后在控制器中添加如下的代码：

  1. public function upload(){
  2.     // 获取表单上传文件 例如上传了001.jpg
  3.     $file = request()->file('image');
  5.     // 移动到框架应用根目录/public/uploads/ 目录下
  6.     if($file){
  7.         $info = $file->move(ROOT_PATH . 'public' . DS . 'uploads');
  8.         if($info){
  9.             // 成功上传后 获取上传信息
  10.             // 输出 jpg
  11.             echo $info->getExtension();
  12.             // 输出 20160820/42a79759f284b767dfcb2a0197904287.jpg
  13.             echo $info->getSaveName();
  14.             // 输出 42a79759f284b767dfcb2a0197904287.jpg
  15.             echo $info->getFilename(); 
  16.         }else{
  17.             // 上传失败获取错误信息
  18.             echo $file->getError();
  19.         }
  20.     }
  21. }

move方法成功的话返回的是一个\think\File对象，你可以对上传后的文件进行后续操作。

多文件上传

如果你使用的是多文件上传表单，例如：

  1. <form action="/index/index/upload" enctype="multipart/form-data" method="post">
  2. <input type="file" name="image[]" /> <br> 
  3. <input type="file" name="image[]" /> <br> 
  4. <input type="file" name="image[]" /> <br> 
  5. <input type="submit" value="上传" /> 
  6. </form>

控制器代码可以改成：

  1. public function upload(){
  2.     // 获取表单上传文件
  3.     $files = request()->file('image');
  4.     foreach($files as $file){
  5.         // 移动到框架应用根目录/public/uploads/ 目录下
  6.         $info = $file->move(ROOT_PATH . 'public' . DS . 'uploads');
  7.         if($info){
  8.             // 成功上传后 获取上传信息
  9.             // 输出 jpg
  10.             echo $info->getExtension(); 
  11.             // 输出 42a79759f284b767dfcb2a0197904287.jpg
  12.             echo $info->getFilename(); 
  13.         }else{
  14.             // 上传失败获取错误信息
  15.             echo $file->getError();
  16.         }    
  17.     }
  18. }

上传验证

支持对上传文件的验证，包括文件大小、文件类型和后缀：

  1. public function upload(){
  2.     // 获取表单上传文件 例如上传了001.jpg
  3.     $file = request()->file('image');
  4.     // 移动到框架应用根目录/public/uploads/ 目录下
  5.     $info = $file->validate(['size'=>15678,'ext'=>'jpg,png,gif'])->move(ROOT_PATH . 'public' . DS . 'uploads');
  6.     if($info){
  7.         // 成功上传后 获取上传信息
  8.         // 输出 jpg
  9.         echo $info->getExtension();
  10.         // 输出 20160820/42a79759f284b767dfcb2a0197904287.jpg
  11.         echo $info->getSaveName();
  12.         // 输出 42a79759f284b767dfcb2a0197904287.jpg
  13.         echo $info->getFilename(); 
  14.     }else{
  15.         // 上传失败获取错误信息
  16.         echo $file->getError();
  17.     }
  18. }
getSaveName方法返回的是图片的服务器文件地址，并不能直接用于图片的URL地址，尤其在windows平台上必须做转换才能正常显示图片。

如果上传文件验证不通过，则move方法返回false。

验证参数说明
size上传文件的最大字节
ext文件后缀，多个用逗号分割或者数组
type文件MIME类型，多个用逗号分割或者数组
还有一个额外的自动验证规则是，如果上传的文件后缀是图像文件后缀，则会检查该文件是否是一个合法的图像文件。

上传规则

默认情况下，会在上传目录下面生成以当前日期为子目录，以微秒时间的md5编码为文件名的文件，例如上面生成的文件名可能是：

  1. /home/www/upload/20160510/42a79759f284b767dfcb2a0197904287.jpg

我们可以指定上传文件的命名规则，使用rule方法即可，例如：

  1. // 获取表单上传文件 例如上传了001.jpg
  2. $file = request()->file('image');
  3. // 移动到服务器的上传目录 并且使用md5规则
  4. $file->rule('md5')->move('/home/www/upload/');

最终生成的文件名类似于：

  1. /home/www/upload/72/ef580909368d824e899f77c7c98388.jpg

系统默认提供了几种上传命名规则，包括：

规则描述
date根据日期和微秒数生成
md5对文件使用md5_file散列生成
sha1对文件使用sha1_file散列生成
其中md5和sha1规则会自动以散列值的前两个字符作为子目录，后面的散列值作为文件名。

如果需要使用自定义命名规则，可以在rule方法中传入函数或者方法，例如：

  1. // 获取表单上传文件 例如上传了001.jpg
  2. $file = request()->file('image');
  3. // 移动到服务器的上传目录 并且使用uniqid规则
  4. $file->rule('uniqid')->move('/home/www/upload/');

生成的文件名类似于：

  1. /home/www/upload/573d3b6d7abe2.jpg

如果你希望保留原文件名称，可以使用：

  1. // 获取表单上传文件 例如上传了001.jpg
  2. $file = request()->file('image');
  3. // 移动到服务器的上传目录 并且使用原文件名
  4. $file->move('/home/www/upload/','');

默认情况下，会覆盖服务器上传目录下的同名文件，如果不希望覆盖，可以使用：

  1. // 获取表单上传文件 例如上传了001.jpg
  2. $file = request()->file('image');
  3. // 移动到服务器的上传目录 并且设置不覆盖
  4. $file->move('/home/www/upload/',true,false);

获取文件hash散列值

可以获取上传文件的哈希散列值，例如：

  1. // 获取表单上传文件
  2. $file = request()->file('image');
  3. // 移动到服务器的上传目录 并且使用原文件名
  4. $upload = $file->move('/home/www/upload/');
  5. // 获取上传文件的hash散列值
  6. echo $upload->md5();
  7. echo $upload->sha1();

v5.0.1以上版本可以统一使用hash方法获取文件散列值

  1. // 获取表单上传文件
  2. $file = request()->file('image');
  3. // 移动到服务器的上传目录 并且使用原文件名
  4. $upload = $file->move('/home/www/upload/');
  5. // 获取上传文件的hash散列值
  6. echo $upload->hash('sha1');
  7. echo $upload->hash('md5');

返回对象

上传成功后返回的仍然是一个File对象，除了File对象自身的方法外，并且可以使用SplFileObject的属性和方法，便于进行后续的文件处理。