图片上传几乎是应用必备,前面也针对 kartik 的 fileinput 做了一篇详细的说明,不过很多人反馈各种问题,下面针对 webuploader 的使用单独写了一个组件。该组件可以更好的处理 Yii2 在图片上传过程中带来的一系列问题,目前支持多图多字段多modal的混合上传。
介绍之前我们先演示下效果。
安装
推荐使用composer进行安装
$ php composer.phar require bailangzhan/yii2-webuploader dev-master
使用
params.php或者params-local.php内增加webuploader和domain配置项
// 图片服务器的域名设置,拼接保存在数据库中的相对地址,可通过web进行展示'domain' => 'http://blog.m/','webuploader' => [ // 后端处理图片的地址,value 是相对的地址 'uploadUrl' => 'blog/upload', // 多文件分隔符 'delimiter' => ',', // 基本配置 'baseConfig' => [ 'defaultImage' => 'http://img1.imgtn.bdimg.com/it/u=2056478505,162569476&fm=26&gp=0.jpg', 'disableGlobalDnd' => true, 'accept' => [ 'title' => 'Images', 'extensions' => 'gif,jpg,jpeg,bmp,png', 'mimeTypes' => 'image/*', ], 'pick' => [ 'multiple' => false, ], ],],
webuploader['baseConfig'] 参考 webuploader官方的参数说明
视图文件
单图
<?php echo $form->field($model, 'file')->widget('manks\FileInput', [ ]); ?>
多图
<?php echo $form->field($model, 'file2')->widget('manks\FileInput', [ 'clientOptions' => [ 'pick' => [ 'multiple' => true, ], // 'server' => Url::to('upload/u2'), // 'accept' => [ // 'extensions' => 'png', // ], ],]); ?>
控制器 controller的地址可以在params.php或者params-local.php中配置 Yii::$app->params['webuploader']['uploadUrl'], 也可以在 clientOptions中配置 server 项。控制器需要返回的数据格式如下
// 错误时{"code": 1, "msg": "error"}// 正确时, 其中 attachment 指的是保存在数据库中的路径,url 是该图片在web可访问的地址{"code": 0, "url": "http://domain/图片地址", "attachment": "图片地址"}
clientOptions同样参考 webuploader官方的参数说明
注意
- 如果是修改的多图片操作,务必保证 $model->file = 'src1,src2,src3,...'; 或者 $model->file = ['src1', 'src2'. 'src3', ...];
-------------------------------------------------------------------------------------------------------
yii2 -图片上传之webUploader的使用
1、安装
推荐使用composer进行安装
$ composer require bailangzhan/yii2-webuploader dev-master
如果composer安装有问题还可以手动安装,方法如下:
1、 将整个文件夹复制到vendor目录下:/vendor/yii2-webuploader
2、 修改配置文件 extension 给webuploader设置别名
配置文件路径:/vendor/yiisoft/extensions.php
在文件array最后加入:
'yii2-webuploader'=>
array(
'name' =>'yii2-webuploader',
'version' => '9999999-dev',
'alias' =>
array (
'@manks' => $vendorDir.'/yii2-webuploader',
),
),
然后就可以配置使用了;
2、配置
params.php或者params-local.php内增加webuploader和domain配置项
-
/* 图片上传插件webuploader + */
-
'webuploader' => [
-
// 后端处理图片的action,value是相对的地址
-
'uploadUrl' =>
'blog/upload',
-
// 多文件分隔符
-
'delimiter' =>
',',
-
// 基本配置
-
'baseConfig' => [
-
'defaultImage' =>
'http://img1.imgtn.bdimg.com/it/u=2056478505,162569476&fm=26&gp=0.jpg',
-
'disableGlobalDnd' =>
true,
-
'accept' => [
-
'title' =>
'Images',
-
'extensions' =>
'gif,jpg,jpeg,bmp,png',
-
'mimeTypes' =>
'image/*',
-
],
-
'pick' => [
-
'multiple' =>
false,
-
],
-
],
-
],
-
'domain' =>
'http://admin.yii2test.com',
// 访问图片的域名拼接
-
'imageUploadRelativePath' =>
'./uploads/images/',
// 图片默认上传的目录
-
'imageUploadSuccessPath' =>
'/uploads/images/',
// 图片上传成功后,路径前缀
-
/* 图片上传插件webuploader - */
webuploader['baseConfig'] 参考 webuploader官方的参数说明
3、使用
view中:
单图
-
<?php
-
echo $form->field($model,
'image')->widget(
'manks\FileInput', []
-
);
?>
多图
-
<?php
-
echo $form->field($model,
'image')->widget(
'manks\FileInput', [
-
//多个图片上传需添加以下参数
-
'clientOptions' => [
-
'pick' => [
-
'multiple' =>
true,
-
],
-
],
-
]);
?>
控制器controller的地址可以在params.php或者params-local.php中配置Yii::$app->params['webuploader']['uploadUrl'],也可以在clientOptions中配置server项。控制器需要返回的数据格式如下
// 错误时
{"code": 1, "msg": "error"}
// 正确时,其中 attachment 指的是保存在数据库中的路径,url 是该图片在web可访问的地址
{"code": 0, "url": "http://domain/图片地址", "attachment": "图片地址"}
clientOptions同样参考 webuploader官方的参数说明
注意:如果是修改的多图片操作,务必保证 $model->file = 'src1,src2,src3,...'; 或者 $model->file = ['src1', 'src2'. 'src3', ...];
controller中:
首先假设webuploader是按照前面所配置的,控制器就是blog/upload,先看下BlogController的实现
-
use
common\
components\
Upload;
-
use
yii\
web\
Response;
-
//webUploader上传
-
public
function actionUpload()
-
{
-
try {
-
Yii::$app->response->format = Response::FORMAT_JSON;
-
$model =
new Upload();
-
$info = $model->upImage();
-
if ($info && is_array($info)) {
-
return $info;
-
}
else {
-
return [
'code' =>
1,
'msg' =>
'error'];
-
}
-
}
catch (\
Exception $e) {
-
return [
'code' =>
1,
'msg' => $e->getMessage()];
-
}
-
}
当然,你的common/components目录下还没有Upload.php,其代码参考如下
-
<?php
-
namespace
common\
components;
-
use
Yii;
-
use
yii\
base\
Model;
-
use
yii\
web\
UploadedFile;
-
use
yii\
base\
Exception;
-
use
yii\
helpers\
FileHelper;
-
/**
-
* 文件上传处理
-
*/
-
class Upload extends Model
-
{
-
public $file;
-
private $_appendRules;
-
public
function init ()
-
{
-
parent::init();
-
$extensions = Yii::$app->params[
'webuploader'][
'baseConfig'][
'accept'][
'extensions'];
-
$this->_appendRules = [
-
[[
'file'],
'file',
'extensions' => $extensions],
-
];
-
}
-
public
function rules()
-
{
-
$baseRules = [];
-
return array_merge($baseRules,
$this->_appendRules);
-
}
-
/**
-
*
-
*/
-
public
function upImage ()
-
{
-
$model =
new
static;
-
$model->file = UploadedFile::getInstanceByName(
'file');
-
if (!$model->file) {
-
return
false;
-
}
-
$relativePath = $successPath =
'';
-
if ($model->validate()) {
-
$relativePath = Yii::$app->params[
'imageUploadRelativePath'];
-
$successPath = Yii::$app->params[
'imageUploadSuccessPath'];
-
$fileName = $model->file->baseName .
'.' . $model->file->extension;
-
if (!is_dir($relativePath)) {
-
FileHelper::createDirectory($relativePath);
-
}
-
$model->file->saveAs($relativePath . $fileName);
-
return [
-
'code' =>
0,
-
'url' => Yii::$app->params[
'domain'] . $successPath . $fileName,
-
'attachment' => $successPath . $fileName
-
];
-
}
else {
-
$errors = $model->errors;
-
return [
-
'code' =>
1,
-
'msg' => current($errors)[
0]
-
];
-
}
-
}
-
}
对于原form对应的AR模型来看,我们假设file和file2字段分别是单图和多图字段,那么在数据库保存的时候,$model->file="src";$model->file2="src1,src2,src3,...";
AR模型对应的rules我们可以这样写
-
public
function rules()
-
{
-
return [
-
[[
'file',
'file2'],
'required'],
-
[[
'file',
'file2'],
'safe'],
-
[[
'file'],
'string',
'max' =>
255],
-
];
-
}
即保证file和file2必填且file限制255个字符。
此外,数据入库之前,你还需要对file2进行拆分处理
is_array($this->file2) && $this->file2 && $this->file2 = implode(',', $this->file2);
完结
转:https://blog.csdn.net/wlzx120/article/details/78126678 http://www.manks.top/document/yii2-webuploader.html