bailangzhan/yii2-webuploader

yii2-webuploader组件

# yii2-webuploader

此扩展集成webuploader图片上传插件，旨在更好的处理 Yii2 framework 图片上传的前端问题，目前支持多图多字段多modal的混合上传。, _(*1)

Demo 演示

, _(*2)

安装

推荐使用composer进行安装, _(*3)

$ php composer.phar require bailangzhan/yii2-webuploader dev-master

使用

params.php或者params-local.php内增加webuploader和domain配置项, _(*4)

// 图片服务器的域名设置，拼接保存在数据库中的相对地址，可通过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,
        ],
    ],
],

视图文件, _(*5)

单图, _(*6)

field($model, 'file')->widget('manks\FileInput', [
]); 

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

多图, _(*7)

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,
        ],
    ]
]); 

控制器 controller的地址可以在params.php或者params-local.php中配置 Yii::$app->params['webuploader']['uploadUrl'], 也可以在 clientOptions中配置 server 项。控制器需要返回的数据格式如下, _(*8)

// 错误时
{"code": 1, "msg": "error"}

// 正确时， 其中 attachment 指的是保存在数据库中的路径，url 是该图片在web可访问的地址
{"code": 0, "url": "http://domain/图片地址", "attachment": "图片地址"}

注意

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

许可

yii2-webuploader is released under the MIT License. See the bundled LICENSE.md for details., _(*10)