thinkphp5集成H-ui后台（五）集成webUploader

在所有的编程语言中，都有对文件上传处理的知识点，这里不多赘述。在H-ui中，有一个功能强大的文件上传组件webUploader，今天就来说明和集成一下它。
先看一下webUploader集成后的效果：

1、页面中使用webUploader
这里就以博客的增加页面（blogAdd.html）为例，首先在页面中引入webUploader所需要的css样式和js文件：
<link href="__ADMIN__/lib/webuploader/0.1.5/webuploader.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="__ADMIN__/lib/webuploader/0.1.5/webuploader.min.js"></script> 
然后是复制webUploader示例中的html代码：

<input type="hidden" id="image_url" name="image_url" />
<div class="row cl">
    <label class="form-label col-xs-4 col-sm-2">缩略图：</label>
    <div class="formControls col-xs-8 col-sm-9">
        <div class="uploader-list-container"> 
            <div class="queueList">
                <div id="dndArea" class="placeholder">
                    <div id="filePicker-2"></div>
                    <!-- <p> 当前组件的说明 -->
                    <p>缩略图，只能选择一张</p>
                </div>
            </div>
            <div class="statusBar" style="display:none;">
                <div class="progress"> <span class="text">0%</span> <span class="percentage"></span> </div>
                <div class="info"></div>
                <div class="btns">
                    <div id="filePicker2"></div>
                    <div class="uploadBtn">开始上传</div>
                </div>
            </div>
        </div>
    </div>
</div>
webUploader初始化和配置代码（有点长）：
<script type="text/javascript">
/*WebUploader 图片上传初始化配置*/
(function( $ ){
    // 当domReady的时候开始初始化
    $(function() {
        var $wrap = $('.uploader-list-container'),
 
 
            // 图片容器
            $queue = $( '<ul class="filelist"></ul>' )
                .appendTo( $wrap.find( '.queueList' ) ),
 
 
            // 状态栏，包括进度和控制按钮
            $statusBar = $wrap.find( '.statusBar' ),
 
 
            // 文件总体选择信息。
            $info = $statusBar.find( '.info' ),
 
 
            // 上传按钮
            $upload = $wrap.find( '.uploadBtn' ),
 
 
            // 没选择文件之前的内容。
            $placeHolder = $wrap.find( '.placeholder' ),
 
 
            $progress = $statusBar.find( '.progress' ).hide(),
 
 
            // 添加的文件数量
            fileCount = 0,
 
 
            // 添加的文件总大小
            fileSize = 0,
 
 
            // 优化retina, 在retina下这个值是2
            ratio = window.devicePixelRatio || 1,
 
 
            // 缩略图大小
            thumbnailWidth = 110 * ratio,
            thumbnailHeight = 110 * ratio,
 
 
            // 可能有pedding, ready, uploading, confirm, done.
            state = 'pedding',
 
 
            // 所有文件的进度信息，key为file id
            percentages = {},
            // 判断浏览器是否支持图片的base64
            isSupportBase64 = ( function() {
                var data = new Image();
                var support = true;
                data.onload = data.onerror = function() {
                    if( this.width != 1 || this.height != 1 ) {
                        support = false;
                    }
                }
                data.src = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///ywAAAAAAQABAAACAUwAOw==";
                return support;
            } )(),
 
 
            // 检测是否已经安装flash，检测flash的版本
            flashVersion = ( function() {
                var version;
 
 
                try {
                    version = navigator.plugins[ 'Shockwave Flash' ];
                    version = version.description;
                } catch ( ex ) {
                    try {
                        version = new ActiveXObject('ShockwaveFlash.ShockwaveFlash')
                                .GetVariable('$version');
                    } catch ( ex2 ) {
                        version = '0.0';
                    }
                }
                version = version.match( /\d+/g );
                return parseFloat( version[ 0 ] + '.' + version[ 1 ], 10 );
            } )(),
 
 
            supportTransition = (function(){
                var s = document.createElement('p').style,
                    r = 'transition' in s ||
                            'WebkitTransition' in s ||
                            'MozTransition' in s ||
                            'msTransition' in s ||
                            'OTransition' in s;
                s = null;
                return r;
            })(),
 
 
            // WebUploader实例
            uploader;
 
 
        if ( !WebUploader.Uploader.support('flash') && WebUploader.browser.ie ) {
 
 
            // flash 安装了但是版本过低。
            if (flashVersion) {
                (function(container) {
                    window['expressinstallcallback'] = function( state ) {
                        switch(state) {
                            case 'Download.Cancelled':
                                alert('您取消了更新！')
                                break;
 
 
                            case 'Download.Failed':
                                alert('安装失败')
                                break;
 
 
                            default:
                                alert('安装已成功，请刷新！');
                                break;
                        }
                        delete window['expressinstallcallback'];
                    };
 
 
                    var swf = 'expressInstall.swf';
                    // insert flash object
                    var html = '<object type="application/' +
                            'x-shockwave-flash" data="' +  swf + '" ';
 
 
                    if (WebUploader.browser.ie) {
                        html += 'classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" ';
                    }
 
 
                    html += 'width="100%" height="100%" style="outline:0">'  +
                        '<param name="movie" value="' + swf + '" />' +
                        '<param name="wmode" value="transparent" />' +
                        '<param name="allowscriptaccess" value="always" />' +
                    '</object>';
 
 
                    container.html(html);
 
 
                })($wrap);
 
 
            // 压根就没有安转。
            } else {
                $wrap.html('<a href="http://www.adobe.com/go/getflashplayer" target="_blank" border="0"><img alt="get flash player" src="http://www.adobe.com/macromedia/style_guide/images/160x41_Get_Flash_Player.jpg" /></a>');
            }
 
 
            return;
        } else if (!WebUploader.Uploader.support()) {
            alert( 'Web Uploader 不支持您的浏览器！');
            return;
        }
 
 
        // 实例化
        uploader = WebUploader.create({
            pick: {
                id: '#filePicker-2',
                label: '点击选择图片'
            },
            formData: {
                uid: 123
            },
            dnd: '#dndArea',
            paste: '#uploader',
            swf: '__ADMIN__/lib/webuploader/0.1.5/Uploader.swf',
            chunked: false,
            chunkSize: 512 * 1024,
            server: '__URL__/webuploader/fileUpload',
            // runtimeOrder: 'flash',
 
 
            // accept: {
            //     title: 'Images',
            //     extensions: 'gif,jpg,jpeg,bmp,png',
            //     mimeTypes: 'image/*'
            // },
            
            // 不压缩image, 默认如果是jpeg，文件上传前会压缩一把再上传！
            resize: false,
            // 只允许选择图片文件。
            accept: {
                title: 'Images',
                extensions: 'gif,jpg,jpeg,bmp,png',
                mimeTypes: 'image/*'
            },
 
 
            // 禁掉全局的拖拽功能。这样不会出现图片拖进页面的时候，把图片打开。
            disableGlobalDnd: true,
            fileNumLimit: 5,
            fileSizeLimit: 200 * 1024 * 1024,    // 200 M
            fileSingleSizeLimit: 50 * 1024 * 1024    // 50 M
        });
 
 
        // 拖拽时不接受 js, txt 文件。
        uploader.on( 'dndAccept', function( items ) {
            var denied = false,
                len = items.length,
                i = 0,
                // 修改js类型
                unAllowed = 'text/plain;application/javascript ';
 
 
            for ( ; i < len; i++ ) {
                // 如果在列表里面
                if ( ~unAllowed.indexOf( items[ i ].type ) ) {
                    denied = true;
                    break;
                }
            }
 
 
            return !denied;
        });
 
 
        uploader.on('dialogOpen', function() {
            console.log('here');
        });
 
 
        // uploader.on('filesQueued', function() {
        //     uploader.sort(function( a, b ) {
        //         if ( a.name < b.name )
        //           return -1;
        //         if ( a.name > b.name )
        //           return 1;
        //         return 0;
        //     });
        // });
 
 
        // 添加“添加文件”的按钮，
        uploader.addButton({
            id: '#filePicker2',
            label: '继续添加'
        });
        
        uploader.addButton({
            id: '#filePicker',
            label: '选择文件',
            multiple : true
        });
 
 
        uploader.on('ready', function() {
            window.uploader = uploader;
        });
 
 
        // 当有文件添加进来时执行，负责view的创建
        function addFile( file ) {
            var $li = $( '<li id="' + file.id + '">' +
                    '<p class="title">' + file.name + '</p>' +
                    '<p class="imgWrap"></p>'+
                    '<p class="progress"><span></span></p>' +
                    '</li>' ),
 
 
                $btns = $('<div class="file-panel">' +
                    '<span class="cancel">删除</span>' +
                    '<span class="rotateRight">向右旋转</span>' +
                    '<span class="rotateLeft">向左旋转</span></div>').appendTo( $li ),
                $prgress = $li.find('p.progress span'),
                $wrap = $li.find( 'p.imgWrap' ),
                $info = $('<p class="error"></p>'),
 
 
                showError = function( code ) {
                    switch( code ) {
                        case 'exceed_size':
                            text = '文件大小超出';
                            break;
 
 
                        case 'interrupt':
                            text = '上传暂停';
                            break;
 
 
                        default:
                            text = '上传失败，请重试';
                            break;
                    }
 
 
                    $info.text( text ).appendTo( $li );
                };
 
 
            if ( file.getStatus() === 'invalid' ) {
                showError( file.statusText );
            } else {
                // @todo lazyload
                $wrap.text( '预览中' );
                uploader.makeThumb( file, function( error, src ) {
                    var img;
 
 
                    if ( error ) {
                        $wrap.text( '不能预览' );
                        return;
                    }
 
 
                    if( isSupportBase64 ) {
                        img = $('<img src="'+src+'">');
                        $wrap.empty().append( img );
                    } else {
                        $.ajax('lib/webuploader/0.1.5/server/preview.php', {
                            method: 'POST',
                            data: src,
                            dataType:'json'
                        }).done(function( response ) {
                            if (response.result) {
                                img = $('<img src="'+response.result+'">');
                                $wrap.empty().append( img );
                            } else {
                                $wrap.text("预览出错");
                            }
                        });
                    }
                }, thumbnailWidth, thumbnailHeight );
 
 
                percentages[ file.id ] = [ file.size, 0 ];
                file.rotation = 0;
            }
 
 
            file.on('statuschange', function( cur, prev ) {
                if ( prev === 'progress' ) {
                    $prgress.hide().width(0);
                } else if ( prev === 'queued' ) {
                    $li.off( 'mouseenter mouseleave' );
                    $btns.remove();
                }
 
 
                // 成功
                if ( cur === 'error' || cur === 'invalid' ) {
                    console.log( file.statusText );
                    showError( file.statusText );
                    percentages[ file.id ][ 1 ] = 1;
                } else if ( cur === 'interrupt' ) {
                    showError( 'interrupt' );
                } else if ( cur === 'queued' ) {
                    percentages[ file.id ][ 1 ] = 0;
                } else if ( cur === 'progress' ) {
                    $info.remove();
                    $prgress.css('display', 'block');
                } else if ( cur === 'complete' ) {
                    $li.append( '<span class="success"></span>' );
                }
 
 
                $li.removeClass( 'state-' + prev ).addClass( 'state-' + cur );
            });
 
 
            $li.on( 'mouseenter', function() {
                $btns.stop().animate({height: 30});
            });
 
 
            $li.on( 'mouseleave', function() {
                $btns.stop().animate({height: 0});
            });
 
 
            $btns.on( 'click', 'span', function() {
                var index = $(this).index(),
                    deg;
 
 
                switch ( index ) {
                    case 0:
                        uploader.removeFile( file );
                        return;
 
 
                    case 1:
                        file.rotation += 90;
                        break;
 
 
                    case 2:
                        file.rotation -= 90;
                        break;
                }
 
 
                if ( supportTransition ) {
                    deg = 'rotate(' + file.rotation + 'deg)';
                    $wrap.css({
                        '-webkit-transform': deg,
                        '-mos-transform': deg,
                        '-o-transform': deg,
                        'transform': deg
                    });
                } else {
                    $wrap.css( 'filter', 'progid:DXImageTransform.Microsoft.BasicImage(rotation='+ (~~((file.rotation/90)%4 + 4)%4) +')');
                    // use jquery animate to rotation
                    // $({
                    //     rotation: rotation
                    // }).animate({
                    //     rotation: file.rotation
                    // }, {
                    //     easing: 'linear',
                    //     step: function( now ) {
                    //         now = now * Math.PI / 180;
 
 
                    //         var cos = Math.cos( now ),
                    //             sin = Math.sin( now );
 
 
                    //         $wrap.css( 'filter', "progid:DXImageTransform.Microsoft.Matrix(M11=" + cos + ",M12=" + (-sin) + ",M21=" + sin + ",M22=" + cos + ",SizingMethod='auto expand')");
                    //     }
                    // });
                }
 
 
 
 
            });
 
 
            $li.appendTo( $queue );
        }
 
 
        // 负责view的销毁
        function removeFile( file ) {
            var $li = $('#'+file.id);
 
 
            delete percentages[ file.id ];
            updateTotalProgress();
            $li.off().find('.file-panel').off().end().remove();
        }
 
 
        function updateTotalProgress() {
            var loaded = 0,
                total = 0,
                spans = $progress.children(),
                percent;
 
 
            $.each( percentages, function( k, v ) {
                total += v[ 0 ];
                loaded += v[ 0 ] * v[ 1 ];
            } );
 
 
            percent = total ? loaded / total : 0;
 
 
 
 
            spans.eq( 0 ).text( Math.round( percent * 100 ) + '%' );
            spans.eq( 1 ).css( 'width', Math.round( percent * 100 ) + '%' );
            updateStatus();
        }
 
 
        function updateStatus() {
            var text = '', stats;
 
 
            if ( state === 'ready' ) {
                text = '选中' + fileCount + '张图片，共' +
                        WebUploader.formatSize( fileSize ) + '。';
            } else if ( state === 'confirm' ) {
                stats = uploader.getStats();
                if ( stats.uploadFailNum ) {
                    text = '已成功上传' + stats.successNum+ '张照片至XX相册，'+
                        stats.uploadFailNum + '张照片上传失败，<a class="retry" href="#">重新上传</a>失败图片或<a class="ignore" href="#">忽略</a>'
                }
 
 
            } else {
                stats = uploader.getStats();
                text = '共' + fileCount + '张（' +
                        WebUploader.formatSize( fileSize )  +
                        '），已上传' + stats.successNum + '张';
 
 
                if ( stats.uploadFailNum ) {
                    text += '，失败' + stats.uploadFailNum + '张';
                }
            }
 
 
            $info.html( text );
        }
 
 
        function setState( val ) {
            var file, stats;
 
 
            if ( val === state ) {
                return;
            }
 
 
            $upload.removeClass( 'state-' + state );
            $upload.addClass( 'state-' + val );
            state = val;
 
 
            switch ( state ) {
                case 'pedding':
                    $placeHolder.removeClass( 'element-invisible' );
                    $queue.hide();
                    $statusBar.addClass( 'element-invisible' );
                    uploader.refresh();
                    break;
 
 
                case 'ready':
                    $placeHolder.addClass( 'element-invisible' );
                    $( '#filePicker2' ).removeClass( 'element-invisible');
                    $queue.show();
                    $statusBar.removeClass('element-invisible');
                    uploader.refresh();
                    break;
 
 
                case 'uploading':
                    $( '#filePicker2' ).addClass( 'element-invisible' );
                    $progress.show();
                    $upload.text( '暂停上传' );
                    break;
 
 
                case 'paused':
                    $progress.show();
                    $upload.text( '继续上传' );
                    break;
 
 
                case 'confirm':
                    $progress.hide();
                    $( '#filePicker2' ).removeClass( 'element-invisible' );
                    $upload.text( '开始上传' );
 
 
                    stats = uploader.getStats();
                    if ( stats.successNum && !stats.uploadFailNum ) {
                        setState( 'finish' );
                        return;
                    }
                    break;
                case 'finish':
                    stats = uploader.getStats();
                    if ( stats.successNum ) {
                        alert( '上传成功' );
                    } else {
                        // 没有成功的图片，重设
                        state = 'done';
                        location.reload();
                    }
                    break;
            }
 
 
            updateStatus();
        }
        
         // 文件上传成功，给item添加成功class, 用样式标记上传成功。
        /* uploader.on( 'uploadSuccess', function( file,data ) {
            alert(data.msg + "_" + data.success);
            $( '#'+file.id ).addClass('upload-state-success').find(".state").text("已上传");
        }); */
        
        uploader.onUploadSuccess = function(file,data){            
            //上传成功后，设置图片访问路径
            data = eval(data);
            if(data.success){
                var imgurl = data.msg;
                $("#image_url").val(imgurl);
            }
        };
        
        uploader.onUploadProgress = function( file, percentage ) {
            var $li = $('#'+file.id),
                $percent = $li.find('.progress span');
 
 
            $percent.css( 'width', percentage * 100 + '%' );
            percentages[ file.id ][ 1 ] = percentage;
            updateTotalProgress();
        };
 
 
        uploader.onFileQueued = function( file ) {
            fileCount++;
            fileSize += file.size;
 
 
            if ( fileCount === 1 ) {
                $placeHolder.addClass( 'element-invisible' );
                $statusBar.show();
            }
 
 
            addFile( file );
            setState( 'ready' );
            updateTotalProgress();
        };
 
 
        uploader.onFileDequeued = function( file ) {
            fileCount--;
            fileSize -= file.size;
 
 
            if ( !fileCount ) {
                setState( 'pedding' );
            }
 
 
            removeFile( file );
            updateTotalProgress();
 
 
        };
 
 
        uploader.on( 'all', function( type ) {
            var stats;
            switch( type ) {
                case 'uploadFinished':
                    setState( 'confirm' );
                    break;
 
 
                case 'startUpload':
                    setState( 'uploading' );
                    break;
 
 
                case 'stopUpload':
                    setState( 'paused' );
                    break;
 
 
            }
        });
 
 
        uploader.onError = function( code ) {
            
            if(code == 'Q_EXCEED_NUM_LIMIT'){
                alert("缩略图只能上传一张图片");
                return;
            }
            
            alert( 'Error: ' + code );
        };
 
 
        $upload.on('click', function() {
            if ( $(this).hasClass( 'disabled' ) ) {
                return false;
            }
 
 
            if ( state === 'ready' ) {
                uploader.upload();
            } else if ( state === 'paused' ) {
                uploader.upload();
            } else if ( state === 'uploading' ) {
                uploader.stop();
            }
        });
 
 
        $info.on( 'click', '.retry', function() {
            uploader.retry();
        } );
 
 
        $info.on( 'click', '.ignore', function() {
            alert( 'todo' );
        } );
 
 
        $upload.addClass( 'state-' + state );
        updateTotalProgress();
    });
 
 
})( jQuery );
</script>
我们这么一锅粥的将代码copy过来，看上去webupload好像很复杂，有点无从下手的感觉。然而很多的代码都只是webupload自己需要调用的一些自定义函数，我们只要拿来用就可以。接下来我们详细讨论下webUploader的配置
2、webUploader的一些配置
实例化webUploader中，配置webUploader与后台访问的路径、上传文件的数量等等，如图：

配置到了这里，其实webUploader的页面配置就已经差不多了。另外一些细节的配置，这里举一个例子，如果客户操作的时候，上传的数量超出了我们配置的数量，我们怎么友好提示呢？如图：

在webUploader中，有许多自定义的错误编码，如图：

我们只要按照这些编码在错误事件中注册就行：

在测试过程中，如果报出其余的错误编码，那么只要根据错误编码的意思映射对应的中文描述就行
3、后台处理webUploader的上传
我们在配置中访问后台的路径是server: '__URL__/webuploader/fileUpload',所以我们创建一个与之对应的类WebuploaderController.php，那么这个类的fileUpload函数其实就是将webuploader传到后台的文件有我们自己的逻辑保存到指定的目录，并返回网页访问的URL，这里直接上代码：
<?php
namespace app\admin\controller;
 
 
use think\Controller;
use think\Exception;
use think\Request;
 
 
/**
 *
 * @author tim
 *        
 */
class WebuploaderController extends Controller
{
    /**
     * 1、获取图片并且保存到服务器指定的目录下
     * 2、生成图片的URL访问路径，并返回
     * */   
    public function fileUpload(Request $request){
        try{
            //获取图片对象
            $filetemp = $request->file('file');
            
            //存放服务器上地址 
            $serverFile = $filetemp->move(ROOT_PATH.'/public/upload/image/single');
            
            //访问地址
            $imageUrl = 'http://'.$_SERVER['HTTP_HOST'].str_replace(ROOT_PATH.'/public', '', $serverFile->getPathname());
            
            $ajaxJson['success'] = true;
            $ajaxJson['msg'] = $imageUrl;
        }catch(Exception $e){
            $ajaxJson['success'] = false;
        }
        
        
        return json_encode($ajaxJson);
    }
}
当我们上传成功后，页面将返回访问当前图片的URL信息获取下来，

其中，image_url是我们自定义的表单隐藏域，用于存放于数据库中。
最后通过webuploader上传的文件放置在了'../public/image/single/日期文件夹'中。

4、其它说明
webUploader多张图片的上传其实和单图上传差不多，webUploader也是一张一张的轮流上传，只是我们在处理的时候要动态的获取每张图片的名称，好进一步处理对应的访问URL。