README

==========================

此扩展集成了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,
		],
	],
],

视图文件

单图

<?php 
// ActiveForm
echo $form->field($model, 'file')->widget('manks\FileInput', [
]); 

// 非 ActiveForm
echo '<label class="control-label">图片</label>';
echo \manks\FileInput::widget([
    'model' => $model,
    'attribute' => 'file',
]);
?>

多图

<?php 
// ActiveForm
echo $form->field($model, 'file2')->widget('manks\FileInput', [
	'clientOptions' => [
		'pick' => [
			'multiple' => true,
		],
		// 'server' => Url::to('upload/u2'),
		// 'accept' => [
		// 	'extensions' => 'png',
		// ],
	],
]); ?>

// 非ActiveForm
echo '<label class="control-label">图片</label>';
echo \manks\FileInput::widget([
	'model' => $model,
	'attribute' => 'file',
	'clientOptions' => [
		'pick' => [
			'multiple' => true,
		],
	]
]); 

控制器的地址可以在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": "图片地址"}

注意

如果是修改的多图片操作，务必保证 $model->file = 'src1,src2,src3,...'; 或者 $model->file = ['src1', 'src2', 'src3', ...];

许可

yii2-webuploader 采用MIT许可发布。详细信息请见附带的 LICENSE.md 文件。