在前面給大家寫個有關文件上傳的文章,包括最基本的yii2文件上傳、異步上傳到又拍雲以及百度編輯器圖片上傳的問題,貌似不說點多圖上傳的就不完美。
今天介紹一款多圖上傳的插件 FileInput,至於為什麼選中了TA作為我們上傳的插件,一來這貨跟Yii2有一腿,用起來方便;二來嘛,用這個插件不僅添加的時候好操作,修改的時候也可以直接通過異步的方式將圖片悄無聲息的刪掉;最值得一提的是,界面效果融合了bootstrap,清爽簡潔美觀,看起來舒服。
說重點,看具體步驟
首先還是先安裝組件
復制代碼 代碼如下:
composer require kartik-v/yii2-widget-fileinput "@dev"
先做一個必要的說明:假設我們有一張商品表,一張商品圖片表,商品圖片表只對商品id和圖片地址進行存儲
看基本使用
use kartik\file\FileInput; // 非ActiveForm的表單 echo '<label class="control-label">圖片</label>'; echo FileInput::widget([ 'model' => $model, 'attribute' => 'image[]', 'options' => ['multiple' => true] ]); //使用ActiveForm的表單 echo $form->field($model, 'image[]')->widget(FileInput::classname(), [ 'options' => ['multiple' => true], ]);
上面上傳多圖,只需要設置multiple=true即可,記得選擇圖片的時候多選。
如此一來,圖片選擇好了直接提交表單就好,文件上傳的程序需要自行處理,如果你還沒有實現,可以參考文件上傳的基本操作。
多圖上傳的唯一麻煩就是,修改的時候怎麼才方便?不著急,FileInput都幫我們解決了!
我們看編輯的時候圖片的展示以及如何異步的刪除單個或者多個圖片!
// 視圖文件 use kartik\file\FileInput; <?php $form = ActiveForm::begin([ 'options' => ['enctype'=>'multipart/form-data'], ]); ?> <?php echo $form->field($model, 'banner_url[]')->label('banner圖')->widget(FileInput::classname(), [ 'options' => ['multiple' => true], 'pluginOptions' => [ // 需要預覽的文件格式 'previewFileType' => 'image', // 預覽的文件 'initialPreview' => ['圖片1', '圖片2', '圖片3'], // 需要展示的圖片設置,比如圖片的寬度等 'initialPreviewConfig' => ['width' => '120px'], // 是否展示預覽圖 'initialPreviewAsData' => true, // 異步上傳的接口地址設置 'uploadUrl' => Url::toRoute(['/goods/async-image']), // 異步上傳需要攜帶的其他參數,比如商品id等 'uploadExtraData' => [ 'goods_id' => $id, ], 'uploadAsync' => true, // 最少上傳的文件個數限制 'minFileCount' => 1, // 最多上傳的文件個數限制 'maxFileCount' => 10, // 是否顯示移除按鈕,指input上面的移除按鈕,非具體圖片上的移除按鈕 'showRemove' => true, // 是否顯示上傳按鈕,指input上面的上傳按鈕,非具體圖片上的上傳按鈕 'showUpload' => true, //是否顯示[選擇]按鈕,指input上面的[選擇]按鈕,非具體圖片上的上傳按鈕 'showBrowse' => true, // 展示圖片區域是否可點擊選擇多文件 'browseOnZoneClick' => true, // 如果要設置具體圖片上的移除、上傳和展示按鈕,需要設置該選項 'fileActionSettings' => [ // 設置具體圖片的查看屬性為false,默認為true 'showZoom' => false, // 設置具體圖片的上傳屬性為true,默認為true 'showUpload' => true, // 設置具體圖片的移除屬性為true,默認為true 'showRemove' => true, ], ], // 一些事件行為 'pluginEvents' => [ // 上傳成功後的回調方法,需要的可查看data後再做具體操作,一般不需要設置 "fileuploaded" => "function (event, data, id, index) { console.log(data); }", ], ]); ?> <?php ActiveForm::end(); ?>
如上所述,基本上都是組件 FileInput的基本屬性和設置,我們這裡也僅僅羅列了一些常用的屬性介紹,如有所需,可查看文檔看屬性的詳細說明。
按照如上所配置,我們預覽下效果圖
感覺上效果很是可以,在開始寫php代碼實現之前,我們先在controller中實現 initialPreview和 initialPreviewConfig的配置
假設上面的視圖文件是用戶展示商品圖片的詳情頁,當前controller是指渲染視圖文件的controller,則需要在controller中獲取商品關聯的圖片,用於展示或者說用於商品圖片的刪除\新增操作。
// 假設商品的圖片是 $relationBanners,$id是商品的id // $relationBanners的數據結構如: /** * Array *( * [0] => Array * ( * [id] => 1484314 * [goods_id] => 1173376 * [banner_url] => ./uploads/20160617/146612713857635322241f2.png * ) * *) */ $relationBanners = Banner::find()->where(['goods_id' => $id])->asArray()->all(); // 對商品banner圖進行處理 $p1 = $p2 = []; if ($relationBanners) { foreach ($relationBanners as $k => $v) { $p1[$k] = $v['banner_url']; $p2[$k] = [ 'url' => Url::toRoute('/banner/delete'), 'key' => $v['id'], ]; } } $model = new Banner; return $this->render('banner', [ 'model' => $model, 'p1' => $p1, 'p2' => $p2, 'id' => $id ]);
你可以看到p1是圖片地址的集合,這裡用於賦值給initialPreview
p2是一組url和key的集合,這裡用於賦值給initialPreviewConfig
其中url是移除圖片的請求地址
key是每個圖片對應的id
此時我們視圖文件中的pluginOptions應該是這樣的
'pluginOptions' => [ // other code 'initialPreview' => $p1, 'initialPreviewConfig' => $p2, // other code ],
注意設置initialPreviewAsData為true哦,不然等會創建圖片後,預覽圖不會顯示。
我們在一開始配置文件中配置了uploadUrl,該參數是異步上傳的圖片地址。
現在看上傳界面應該是光禿禿的,我們選擇一張圖片後效果如上圖2所示,
需要提醒的是,每張小圖片上的上傳是上傳對應的小圖片,input框(右下角)的上傳和移除都是針對所有的圖片的操作,一張也是上傳,十張也是上傳,我們這裡只對多圖上傳的操作做一個必要的說明。
圖片上傳的地址以及上傳需要的額外參數(如商品id)我們都准備好了,額外的參數配置項是uploadExtraData,具體見上面視圖文件中的配置。
接著我們看 /goods/async-image 異步上傳的程序實現
public function actionAsyncImage () { // 商品ID $id = Yii::$app->request->post('goods_id'); $p1 = $p2 = []; if (empty($_FILES['Banner']['name']) || empty($_FILES['Banner']['name']['banner_url']) || !$id) { echo '{}'; return; } for ($i = 0; $i < count($_FILES['Banner']['name']['banner_url']); $i++) { $url = '/banner/delete'; $imageUrl = ''; //調用圖片接口上傳後返回圖片地址 // 圖片入庫操作,此處不可以批量直接入庫,因為後面我們還要把key返回 便於圖片的刪除 $model = new Banner; $model->goods_id = $id; $model->banner_url = $imageUrl; $key = 0; if ($model->save(false)) { $key = $model->id; } // $pathinfo = pathinfo($imageUrl); // $caption = $pathinfo['basename']; // $size = $_FILES['Banner']['size']['banner_url'][$i]; $p1[$i] = $imageUrl; $p2[$i] = ['url' => $url, 'key' => $key]; } echo json_encode([ 'initialPreview' => $p1, 'initialPreviewConfig' => $p2, 'append' => true, ]); return; }
到此,單圖和多圖上傳的工作我們也就完成了。
為了實現圖片的刪除效果,這裡可以先上傳兩張圖片。你可以單張上傳也可以多張上傳。
上傳成功後你可以刷新當前頁面,因為一開始我們就在controller中實現了圖片的預覽工作,所以理應會展示我們已經上傳的兩張圖片。
按照我們的配置,現在的預覽圖應該是這樣的。
不說廢話,我們看圖片刪除的程序(/banner/delete)實現
public function actionDelete () { if ($id = Yii::$app->request->post('key')) { $model = $this->findModel($id); $model->delete(); } Yii::$app->response->format = \yii\web\Response::FORMAT_JSON; return ['success' => true]; }
需要提醒的是,key就是我們配置 initialPreviewConfig項時指定的key,你可以參考controller中的key,也可以參考異步上傳成功後p2的key.
到此,yii2中多圖上傳的組件使用以及程序代碼我們都給出了具體的實現。
以上所述是小編給大家介紹的Yii2組件之多圖上傳插件FileInput的詳細使用教程的全部敘述,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回復大家的。在此也非常感謝大家對幫客之家網站的支持!