這篇文章主要介紹了yii2多圖上傳組件的使用教程,在使用過程中有許多注意要點,下面小編給大家分享到腳本之家平台,需要的朋友可以參考下
最近在使用yii2開發一個表單頁面的時候,有多圖上傳的需求,稍微找了找這方面的組件,基本都安利fileInput這個組件,於是就嘗試著使用這個庫來完成後端表單頁面的多圖上傳功能。使用的過程中發現還是有不少小細節需要注意的,於是記錄一下使用的過程。
yii2-widget-fileinput 這個函式庫的github位址在這裡,安裝的部分就很常規了,按文件走就可以了。
我們來看官方文件展示的幾個常規操作:
use kartik\widgets\FileInput // or 'use kartikile\FileInput' if you have only installed yii2-widget-fileinput in isolation // 使用ActiveForm 和 model绑定的单张图片示例 echo $form->field($model, 'avatar')->widget(FileInput::classname(), [ 'options' => ['accept' => 'image/*'], ]); // 多图上传示例 echo '<label class="control-label">Add Attachments</label>'; echo FileInput::widget([ 'model' => $model, 'attribute' => 'attachment_1[]', 'options' => ['multiple' => true] ]); // 不绑定model的使用方法 echo '<label class="control-label">Upload Document</label>'; echo FileInput::widget([ 'name' => 'attachment_3', ]); // 不可点击的示例 echo '<label class="control-label">Select Attachment</label>'; echo FileInput::widget([ 'name' => 'attachment_4', 'disabled' => true ]);
而這些都是常規操作,我們來設想一下,我們要完成淘寶的商品添加,有個商品表,有著一對多關係的若干張圖片,這時候就需要用到多圖上傳功能了。而且我們也希望上傳圖片是異步的,那麼我們可以這麼配置我們的fileInput元件
<?= $form->field($model, 'image[]')->label($label)->widget(FileInput::classname(), [ // 'name' => 'ImgSelect', 'language' => 'zh-CN', 'options' => ['multiple' => true, 'accept' => 'image/*'], 'pluginOptions' => [ 'initialPreview' => $initialPreview, 'initialPreviewConfig' => $initialPreviewConfig, 'allowedPreviewTypes' => ['image'], 'allowedFileExtensions' => ['jpg', 'gif', 'png'], 'previewFileType' => 'image', 'overwriteInitial' => false, 'browseLabel' => '选择图片', 'msgFilesTooMany' => "选择上传的图片数量({n}) 超过允许的最大图片数{m}!", 'maxFileCount' => 5,//允许上传最多的图片5张 'maxFileSize' => 2048,//限制图片最大200kB 'uploadUrl' => Url::to(['/upload/image']), //'uploadExtraData' => ['testid' => 'listimg'], 'uploadAsync' => true,//配置异步上传还是同步上传 ], 'pluginEvents' => [ 'filepredelete' => "function(event, key) { return (!confirm('确认要删除')); }", 'fileuploaded' => 'function(event, data, previewId, index) { $(event.currentTarget.closest("form")).append(data.response.imgfile); }', 'filedeleted' => 'function(event, key) { $(event.currentTarget.closest("form")).find("#"+key).remove(); return; }', ] ]); ?>
我們在控制器配置好圖片瀏覽的配置,傳入進來。程式碼裡的關鍵點我已經加上了配置,我們可以看到,這時異步上傳的url已經配置到了upload/image 這個控制器裡,而我們也在刪除,上傳等操作完成時加上了js的回調。
如上所述,我們羅列了一些都是元件 FileInput的基本屬性和設置,如有所需,可查看文件看屬性的詳細說明。
看下上傳圖片的控制器裡,我們是怎麼寫actionImage 這個函數的
#/** * 上传图片到临时目录 * @return string * @throws \yii\base\Exception */ public function actionImage() { if (Yii::$app->request->isPost) { $res = []; $initialPreview = []; $initialPreviewConfig = []; $images = UploadedFile::getInstancesByName("UploadImage[image]"); if (count($images) > 0) { foreach ($images as $key => $image) { if ($image->size > 2048 * 1024) { $res = ['error' => '图片最大不可超过2M']; return json_encode($res); } if (!in_array(strtolower($image->extension), array('gif', 'jpg', 'jpeg', 'png'))) { $res = ['error' => '请上传标准图片文件, 支持gif,jpg,png和jpeg.']; return json_encode($res); } $dir = '/uploads/temp/'; //生成唯一uuid用来保存到服务器上图片名称 $pickey = ToolExtend::genuuid(); $filename = $pickey . '.' . $image->getExtension(); //如果文件夹不存在,则新建文件夹 if (!file_exists(Yii::getAlias('@backend') . '/web' . $dir)) { FileHelper::createDirectory(Yii::getAlias('@backend') . '/web' . $dir, 777); } $filepath = realpath(Yii::getAlias('@backend') . '/web' . $dir) . '/'; $file = $filepath . $filename; if ($image->saveAs($file)) { $imgpath = $dir . $filename; /*Image::thumbnail($file, 100, 100) ->save($file . '_100x100.jpg', ['quality' => 80]); */ // array_push($initialPreview, "<img src='" . $imgpath . "' class='file-preview-image' alt='" . $filename . "' title='" . $filename . "'>"); $config = [ 'caption' => $filename, 'width' => '120px', 'url' => '../upload/delete', // server delete action 'key' => $pickey, 'extra' => ['filename' => $filename] ]; array_push($initialPreviewConfig, $config); $res = [ "initialPreview" => $initialPreview, "initialPreviewConfig" => $initialPreviewConfig, "imgfile" => "<input name='image[]' id='" . $pickey . "' type='hidden' value='" . $imgpath . "'/>", 'filename' => $filename, 'imagePath' => $imgpath, ]; } } } return json_encode($res); } }
到此,多圖上傳的工作我們也就完美的實現了。
為了實現圖片的刪除效果,這裡可以先上傳兩張圖片。你可以單張上傳也可以多張上傳。
上傳成功後你可以刷新目前頁面,因為一開始我們就在controller中實現了圖片的預覽工作,所以理應會展示我們已經上傳的兩張圖片。
至於刪除函數就不講了,只要在瀏覽裡配置上刪除的url,也是一樣的操作咯。
總結
以上所述是小編給大家介紹的yii2多圖上傳組件的使用教程,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回覆大家的。在此也非常感謝大家對腳本之家網站的支持!
以上是yii2多圖上傳元件的使用教程php實例的詳細內容。更多資訊請關注PHP中文網其他相關文章!