Yii2.0-advanced-8—图片上传之webuploader的使用

yii2 -图片上传之webUploader的使用

1、安装

推荐使用composer进行安装

$ composer require bailangzhan/yii2-webuploader dev-master

如果composer安装有问题还可以手动安装,方法如下：

( github地址 : https://github.com/wlzx120/yii2-webuploder.git )

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

 

完结