脦脛录镁脡脧麓芦 · tp5文档

# 文件上传本篇主要介绍如何使用`ThinkPHP5`进行文件上传及验证。 - - [控制器定义](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/179236#u63A7u5236u5668u5B9Au4E49) - [上传文件验证](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/179236#u4E0Au4F20u6587u4EF6u9A8Cu8BC1) - [文件保存规则](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/179236#u6587u4EF6u4FDDu5B58u89C4u5219) - [多文件上传](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/179236#u591Au6587u4EF6u4E0Au4F20) - [后续文件操作](http://ihavenolimitations.xyz/thinkphp/thinkphp5_quickstart/179236#u540Eu7EEDu6587u4EF6u64CDu4F5C) ## 控制器定义 > 文件上传使用ThinkPHP5内置的`think\File`类库，该类库可以轻松实现文件上传到本地服务器，如果需要上传到其它服务器或者平台，则需要后续调用其它类库或者接口。首先来创建一个Upload控制器如下： ``` <pre class="calibre18"> ``` <?phpnamespace app\index\controller; use think\Request; class Upload extends \think\Controller{ // 文件上传表单public function index(){ return $this->fetch(); } // 文件上传提交public function up(Request $request){ // 获取表单上传文件$file = $request->file('file'); if (empty($file)) { $this->error('请选择上传文件'); } // 移动到框架应用根目录/public/uploads/ 目录下$info = $file->move(ROOT_PATH . 'public' . DS . 'uploads'); if ($info) { $this->success('文件上传成功：' . $info->getRealPath()); } else { // 上传失败获取错误信息$this->error($file->getError()); } } } ``` ``` 然后创建模板文件（`application/index/view/upload/index.html`）: ``` <pre class="calibre18"> ``` <!doctype html><html><head><meta charset="UTF-8"><title>文件上传示例</title><style>body { font-family:"Microsoft Yahei","Helvetica Neue",Helvetica,Arial,sans-serif; font-size:16px; padding:5px; }.form{ padding: 15px; font-size: 16px; }.form .text { padding: 3px; margin:2px 10px; width: 240px; height: 24px; line-height: 28px; border: 1px solid #D4D4D4; }.form .btn{ margin:6px; padding: 6px; width: 120px; font-size: 16px; border: 1px solid #D4D4D4; cursor: pointer; background:#eee; }.form .file{ margin:6px; padding: 6px; width: 220px; font-size: 16px; border: 1px solid #D4D4D4; cursor: pointer; background:#eee; }a{ color: #868686; cursor: pointer; }a:hover{ text-decoration: underline; } h2{ color: #4288ce; font-weight: 400; padding: 6px 0; margin: 6px 0 0; font-size: 28px; border-bottom: 1px solid #eee; }div{ margin:8px; }.info{ padding: 12px 0; border-bottom: 1px solid #eee; }.copyright{ margin-top: 24px; padding: 12px 0; border-top: 1px solid #eee; }</style></head><body><h2>文件上传示例</h2><FORM method="post" enctype="multipart/form-data" class="form" action="{:url('up')}"> 选择文件：<INPUT type="file" class="file" name="file"><br/><INPUT type="submit" class="btn" value=" 提交 "></FORM><div class="copyright"><a title="官方网站" href="http://www.thinkphp.cn">ThinkPHP</a><span>V5</span><span>{ 十年磨一剑-为API开发设计的高性能框架 }</span></div></body></html> ``` ``` 访问下面的URL地址： ``` <pre class="calibre18"> ``` http: //tp5.com/index/upload ``` ``` ![](https://img.kancloud.cn/ce/31/ce3161d1487d32532cff6af5505f3e1e_766x368.png) 如果没有选择任何文件点击提交的话，会显示： ![](https://img.kancloud.cn/23/fc/23fcea7b9f7a8b6fa836daebd8d36fc8_652x344.png) 选择文件后点击提交： ![](https://img.kancloud.cn/ed/82/ed82d381fdac150a1ca1710849d9777c_755x368.png) ![](https://img.kancloud.cn/0c/5d/0c5d787b74b375a9ee5e4a2d55e9e247_2110x443.png) 默认的上传文件会按照当前的日期自动保存 ## 上传文件验证可以在上传之前调用`validate`方法设置验证规则，例如： ``` <pre class="calibre18"> ``` // 文件上传提交public function up(Request $request){ // 获取表单上传文件$file = $request->file('file'); if (empty($file)) { $this->error('请选择上传文件'); } // 移动到框架应用根目录/public/uploads/ 目录下$info = $file->validate(['ext' => 'jpg,png'])->move(ROOT_PATH . 'public' . DS . 'uploads'); if ($info) { $this->success('文件上传成功：' . $info->getRealPath()); } else { // 上传失败获取错误信息$this->error($file->getError()); } } ``` ``` `validate`方法设置了允许上传的文件后缀是jpg和png，当我们选择一个gif格式的文件后，会提示： ![](https://img.kancloud.cn/71/fd/71fdbee2d76ecc099f509da23f5cb479_664x346.png) `validate`方法支持的验证规则包括：验证规则说明参数类型 size 上传文件最大字节大小 integer ext 允许上传的文件后缀数组或者字符串 type 允许上传的文件类型数组或者字符串如果上传的文件后缀是图像格式的话，系统会自动检测是否为合法的图像文件，例如，我们创建一个hello.jpg文件，并且写入下列文本内容 ``` <pre class="calibre18"> ``` Hello，ThinkPHP5！ ``` ``` 当我们上传该文件并且提交后显示： ![](https://img.kancloud.cn/e4/2c/e42c1280e5428ae518a6a487133632b7_687x336.png) > 注意：文件上传验证用到了`exif`扩展，如果没有开启请自行开启。如果你统一使用验证类`think\Validate`对表单进行验证，也可以直接使用控制器类`think\Controller`的`validate`方法进行上传文件验证，修改控制器up方法的代码为： ``` <pre class="calibre18"> ``` // 文件上传提交public function up(Request $request){ // 获取表单上传文件$file = $request->file('file'); // 上传文件验证$result = $this->validate(['file' => $file], ['file'=>'require|image'],['file.require' => '请选择上传文件', 'file.image' => '非法图像文件']); if(true !== $result){ $this->error($result); } // 移动到框架应用根目录/public/uploads/ 目录下$info = $file->move(ROOT_PATH . 'public' . DS . 'uploads'); if ($info) { $this->success('文件上传成功：' . $info->getRealPath()); } else { // 上传失败获取错误信息$this->error($file->getError()); } } ``` ``` 关键的代码是这行： ``` <pre class="calibre18"> ``` // 上传文件验证$result = $this->validate(['file' => $file], ['file'=>'require|image'],['file.require' => '请选择上传文件', 'file.image' => '非法图像文件']); ``` ``` 由于设置了`require`验证规则（表示必须上传文件），所以如果没有选择任何文件直接提交的话，页面会提示： ![](https://img.kancloud.cn/23/fc/23fcea7b9f7a8b6fa836daebd8d36fc8_652x344.png) `image`验证规则表示上传的必须是一个图像文件，如果选择上传了一个文本文件，页面会提示： ![](https://img.kancloud.cn/e4/2c/e42c1280e5428ae518a6a487133632b7_687x336.png) 如果需要上传一个100\*100的`PNG`图像文件，可以这样进行验证： ``` <pre class="calibre18"> ``` // 上传文件验证$result = $this->validate(['file' => $file], ['file'=>'require|image:100,100,png'],['file.require' => '请选择上传文件', 'file.image' => '必须是100*100的PNG格式文件']); ``` ``` 更多的上传文件验证规则还包括：验证规则说明 file 验证是否为File对象 image 验证是否为图像File对象 image:width,height\[,type\] 验证图像文件的类型和宽高 fileExt:zip,doc,... 验证文件后缀 fileMime:image/png,... 验证文件类型 fileSize:1024 验证文件大小## 文件保存规则可以在上传之前调用`rule`方法设置上传文件的保存规则。 ``` <pre class="calibre18"> ``` // 文件上传提交public function up(Request $request){ // 获取表单上传文件$file = $request->file('file'); if (empty($file)) { $this->error('请选择上传文件'); } // 移动到框架应用根目录/public/uploads/ 目录下$info = $file->rule('md5')->move(ROOT_PATH . 'public' . DS . 'uploads'); if ($info) { $this->success('文件上传成功：' . $info->getRealPath()); } else { // 上传失败获取错误信息$this->error($file->getError()); } } ``` ``` ![](https://img.kancloud.cn/d7/73/d773392e52c76e74a8f84c496c9bf00b_1878x449.png) 系统默认提供了几种上传命名规则，包括：规则描述 date 根据日期和微秒数生成（默认规则） md5 对文件使用md5\_file散列生成 sha1 对文件使用sha1\_file散列生成> 其中md5和sha1规则会自动以散列值的前两个字符作为子目录，后面的散列值作为文件名。如果需要自定义上传文件的保存规则，可以使用： ``` <pre class="calibre18"> ``` // 移动到框架应用根目录/public/uploads/ 目录下 $info = $file->rule('uniqid')->move(ROOT_PATH . 'public' . DS . 'uploads'); ``` ``` 这里使用了`uniqid`函数来生成唯一的ID命名上传文件，如果必要，还可以支持使用闭包定义规则，例如： ``` <pre class="calibre18"> ``` // 移动到框架应用根目录/public/uploads/ 目录下$info = $file->rule(function ($file) { // 使用自定义的文件保存规则return $file->getInfo('type') . uniqid(); })->move(ROOT_PATH . 'public' . DS . 'uploads'); ``` ``` ![](https://img.kancloud.cn/2c/03/2c0365dfb97675352192f3bd8c583e54_1966x346.png) 如果希望指定某个文件的保存文件名，还可以直接使用： ``` <pre class="calibre18"> ``` // 移动到框架应用根目录/public/uploads/ 目录下 $info = $file->move(ROOT_PATH . 'public' . DS . 'uploads','test'); ``` ``` ![](https://img.kancloud.cn/79/da/79daee05a518766867466711b9c4f5e9_1369x353.png) 如果希望保持上传文件的原文件名保存，则可以使用 ``` <pre class="calibre18"> ``` // 移动到框架应用根目录/public/uploads/ 目录下 $info = $file->move(ROOT_PATH . 'public' . DS . 'uploads',''); ``` ``` 默认情况下，会覆盖服务器上传目录下的同名文件，如果不希望覆盖，可以使用： ``` <pre class="calibre18"> ``` // 移动到服务器的上传目录并且设置不覆盖$file->move(ROOT_PATH . 'public' . DS . 'uploads',true,false); ``` ``` 如果要获取上传的保存文件名，可以调用返回对象的`getSaveName`方法： ``` <pre class="calibre18"> ``` $info = $file->rule('md5')->move(ROOT_PATH . 'public' . DS . 'uploads'); if ($info) { echo $info->getSaveName(); } else { $this->error($file->getError()); } ``` ``` ## 多文件上传如果你使用的是多文件上传表单，例如： ``` <pre class="calibre18"> ``` <FORM method="post" enctype="multipart/form-data" class="form" action="{:url('up')}"> <input type="file" name="image[]" /> <input type="file" name="image[]" /> <input type="file" name="image[]" /> <INPUT type="submit" class="btn" value=" 提交 "> </FORM> ``` ``` 控制器代码可以改成： ``` <pre class="calibre18"> ``` public function up(Request $request){ // 获取表单上传文件$files = $request->file('image'); $item = []; foreach($files as $file){ // 移动到框架应用根目录/public/uploads/ 目录下$info = $file->move(ROOT_PATH . 'public' . DS . 'uploads'); if($info){ $item[] = $info->getRealPath(); }else{ // 上传失败获取错误信息$this->error($file->getError()); } } $this->success('文件上传成功'.implode(' ',$item)); } ``` ``` ## 后续文件操作上传成功后返回的是`File`对象，除了可以使用`SplFileObject`的属性和方法之外，还可以使用File类自身提供的下列方法，便于进行后续的文件处理（例如对图像文件进行剪裁处理或者移动到远程服务器）。方法描述 getSaveName 获取保存的文件名（包含动态生成的目录） getInfo 获取上传文件信息 getMime 获取文件的MIME信息 md5 获取文件的md5散列值 sha1 获取文件的sha1散列值下面是一个简单的FTP文件移动的处理例子。 ``` <pre class="calibre18"> ``` public function up(Request $request){ // 获取表单上传文件$file = $request->file('file'); // 上传文件$info = $file->move(ROOT_PATH . 'public' . DS . 'uploads'); if ($info) { // 移动文件到FTP服务器$link = ftp_connect('212.45.5.78'); ftp_login($link, 'root', 'password'); /* 移动文件 */$path = ftp_pwd($link) . '/uploads/'; if (!ftp_put($link, $path.$info->getFilename(), $info->getRealPath(), FTP_BINARY)) { $this->error('文件上传保存错误！'); } } else { // 上传失败获取错误信息$this->error($file->getError()); } } ``` ``` 还可以对上传的文件进行处理，后面我们还会讲到对上传图像文件进行额外的图像处理。