moxuandi/yii2-webuploader

WebUploader是由Baidu WebFE(FEX)团队开发的一个简单的以HTML5为主,FLASH为辅的现代文件上传组件。

Installs: 204

Dependents: 0

Suggesters: 0

Security: 0

Stars: 3

Watchers: 0

Forks: 0

Open Issues: 2

Type:yii2-extension

v2.2.0.1 2020-01-10 02:04 UTC

This package is auto-updated.

Last update: 2024-09-10 12:50:52 UTC


README

WebUploader是由Baidu WebFE(FEX)团队开发的一个简单的以HTML5为主,FLASH为辅的现代文件上传组件。 在现代的浏览器里面能充分发挥HTML5的优势,同时又不摒弃主流IE浏览器,沿用原来的FLASH运行时,兼容IE6+,iOS 6+, android 4+。 两套运行时,同样的调用方式,可供用户任意选用。 采用大文件分片并发上传,极大的提高了文件上传效率。

提示: 一个页面中只能调用一次该插件, 否则会冲突!

安装:

使用 composer 下载:

# 2.2.x(yii >= 2.0.24):
composer require moxuandi/yii2-webuploader:"~2.2.0"

# 2.x(yii >= 2.0.16):
composer require moxuandi/yii2-webuploader:"~2.1.0"

# 1.x(非重要Bug, 不再更新):
composer require moxuandi/yii2-webuploader:"~1.0"

# 旧版归档(不再更新):
composer require moxuandi/yii2-webuploader:"~0.1"

# 开发版:
composer require moxuandi/yii2-webuploader:"dev-master"

使用:

Controller中添加:

public function actions()
{
    return [
        'WebUpload' => [
            'class' => 'moxuandi\webuploader\UploaderAction',
            // 可选参数, 参考 UploaderAction::$_config
            'config' => [
                'allowFiles' => ['.png', '.jpg', '.jpeg', '.gif', '.bmp'],  // 上传图片格式显示
                'pathFormat' => '/uploads/image/{yyyy}{mm}{dd}/{hh}{ii}{ss}_{rand:6}',  // 上传保存路径, 可以自定义保存路径和文件名格式

                // 如果`uploads`目录与当前应用的入口文件不在同一个目录, 必须做如下配置:
                'rootPath' => dirname(dirname(Yii::$app->request->scriptFile)),
                'rootUrl' => 'http://image.advanced.ccc',
            ],
        ],
    ];
}

View中添加:

1. 简单调用:
$form->field($model, 'images')->widget('moxuandi\webuploader\MultiImage');

2. 带参数调用:
$form->field($model, 'images')->widget('moxuandi\webuploader\MultiImage', [
    'config'=>[
        'fileNumLimit' => 2,
        'fileSizeLimit' => 30*1024*1024,
        'fileSingleSizeLimit' => 2*1024*1024
    ]
]);

3. 不带 $model 调用:
\moxuandi\webuploader\MultiImage::widget([
    'name' => 'images',
    'value' => $model->images,
    'config'=>[
        'fileNumLimit' => 2,
        'fileSizeLimit' => 30*1024*1024,
        'fileSingleSizeLimit' => 2*1024*1024
    ]
]);

编辑器相关配置,请在view中配置,参数为config,比如限制上传类型、文件大小等等,具体参数请查看WebUploader官网API

文件上传相关配置,请在controller中配置,参数为config,例如文件保存路径等;更多参数请参照 yii2-helpers 中的 Uploader::$config