<?php
/**
 * @version     $Id: elFinder.class.php 1812 2013-01-14 18:45:06Z lefteris.kavadas $
 * @package     K2
 * @author      JoomlaWorks http://www.joomlaworks.net
 * @copyright   Copyright (c) 2006 - 2013 JoomlaWorks Ltd. All rights reserved.
 * @license     GNU/GPL license: http://www.gnu.org/copyleft/gpl.html
 */

// no direct access
defined('_JEXEC') or die;

/**
 * elFinder - file manager for web.
 * Core class.
 *
 * @package elfinder
 * @author Dmitry (dio) Levashov
 * @author Troex Nevelin
 * @author Alexey Sukhotin
 **/
class elFinder {
    
    /**
     * API version number
     *
     * @var string
     **/
    protected $version = '2.0';
    
    /**
     * Storages (root dirs)
     *
     * @var array
     **/
    protected $volumes = array();
    
    /**
     * Mounted volumes count
     * Required to create unique volume id
     *
     * @var int
     **/
    public static $volumesCnt = 1;
    
    /**
     * Default root (storage)
     *
     * @var elFinderStorageDriver
     **/
    protected $default = null;
    
    /**
     * Commands and required arguments list
     *
     * @var array
     **/
    protected $commands = array(
        'open'      => array('target' => false, 'tree' => false, 'init' => false, 'mimes' => false),
        'ls'        => array('target' => true, 'mimes' => false),
        'tree'      => array('target' => true),
        'parents'   => array('target' => true),
        'tmb'       => array('targets' => true),
        'file'      => array('target' => true, 'download' => false),
        'size'      => array('targets' => true),
        'mkdir'     => array('target' => true, 'name' => true),
        'mkfile'    => array('target' => true, 'name' => true, 'mimes' => false),
        'rm'        => array('targets' => true),
        'rename'    => array('target' => true, 'name' => true, 'mimes' => false),
        'duplicate' => array('targets' => true, 'suffix' => false),
        'paste'     => array('dst' => true, 'targets' => true, 'cut' => false, 'mimes' => false),
        'upload'    => array('target' => true, 'FILES' => true, 'mimes' => false, 'html' => false),
        'get'       => array('target' => true),
        'put'       => array('target' => true, 'content' => '', 'mimes' => false),
        'archive'   => array('targets' => true, 'type' => true, 'mimes' => false),
        'extract'   => array('target' => true, 'mimes' => false),
        'search'    => array('q' => true, 'mimes' => false),
        'info'      => array('targets' => true),
        'dim'       => array('target' => true),
        'resize'    => array('target' => true, 'width' => true, 'height' => true, 'mode' => false, 'x' => false, 'y' => false, 'degree' => false)
    );
    
    /**
     * Commands listeners
     *
     * @var array
     **/
    protected $listeners = array();
    
    /**
     * script work time for debug
     *
     * @var string
     **/
    protected $time = 0;
    /**
     * Is elFinder init correctly?
     *
     * @var bool
     **/
    protected $loaded = false;
    /**
     * Send debug to client?
     *
     * @var string
     **/
    protected $debug = false;
    
    /**
     * undocumented class variable
     *
     * @var string
     **/
    protected $uploadDebug = '';
    
    /**
     * Errors from not mounted volumes
     *
     * @var array
     **/
    public $mountErrors = array();
    
    // Errors messages
    const ERROR_UNKNOWN           = 'errUnknown';
    const ERROR_UNKNOWN_CMD       = 'errUnknownCmd';
    const ERROR_CONF              = 'errConf';
    const ERROR_CONF_NO_JSON      = 'errJSON';
    const ERROR_CONF_NO_VOL       = 'errNoVolumes';
    const ERROR_INV_PARAMS        = 'errCmdParams';
    const ERROR_OPEN              = 'errOpen';
    const ERROR_DIR_NOT_FOUND     = 'errFolderNotFound';
    const ERROR_FILE_NOT_FOUND    = 'errFileNotFound';     // 'File not found.'
    const ERROR_TRGDIR_NOT_FOUND  = 'errTrgFolderNotFound'; // 'Target folder "$1" not found.'
    const ERROR_NOT_DIR           = 'errNotFolder';
    const ERROR_NOT_FILE          = 'errNotFile';
    const ERROR_PERM_DENIED       = 'errPerm';
    const ERROR_LOCKED            = 'errLocked';        // '"$1" is locked and can not be renamed, moved or removed.'
    const ERROR_EXISTS            = 'errExists';        // 'File named "$1" already exists.'
    const ERROR_INVALID_NAME      = 'errInvName';       // 'Invalid file name.'
    const ERROR_MKDIR             = 'errMkdir';
    const ERROR_MKFILE            = 'errMkfile';
    const ERROR_RENAME            = 'errRename';
    const ERROR_COPY              = 'errCopy';
    const ERROR_MOVE              = 'errMove';
    const ERROR_COPY_FROM         = 'errCopyFrom';
    const ERROR_COPY_TO           = 'errCopyTo';
    const ERROR_COPY_ITSELF       = 'errCopyInItself';
    const ERROR_REPLACE           = 'errReplace';          // 'Unable to replace "$1".'
    const ERROR_RM                = 'errRm';               // 'Unable to remove "$1".'
    const ERROR_RM_SRC            = 'errRmSrc';            // 'Unable remove source file(s)'
    const ERROR_UPLOAD            = 'errUpload';           // 'Upload error.'
    const ERROR_UPLOAD_FILE       = 'errUploadFile';       // 'Unable to upload "$1".'
    const ERROR_UPLOAD_NO_FILES   = 'errUploadNoFiles';    // 'No files found for upload.'
    const ERROR_UPLOAD_TOTAL_SIZE = 'errUploadTotalSize';  // 'Data exceeds the maximum allowed size.'
    const ERROR_UPLOAD_FILE_SIZE  = 'errUploadFileSize';   // 'File exceeds maximum allowed size.'
    const ERROR_UPLOAD_FILE_MIME  = 'errUploadMime';       // 'File type not allowed.'
    const ERROR_UPLOAD_TRANSFER   = 'errUploadTransfer';   // '"$1" transfer error.'
    // const ERROR_ACCESS_DENIED     = 'errAccess';
    const ERROR_NOT_REPLACE       = 'errNotReplace';       // Object "$1" already exists at this location and can not be replaced with object of another type.
    const ERROR_SAVE              = 'errSave';
    const ERROR_EXTRACT           = 'errExtract';
    const ERROR_ARCHIVE           = 'errArchive';
    const ERROR_NOT_ARCHIVE       = 'errNoArchive';
    const ERROR_ARCHIVE_TYPE      = 'errArcType';
    const ERROR_ARC_SYMLINKS      = 'errArcSymlinks';
    const ERROR_ARC_MAXSIZE       = 'errArcMaxSize';
    const ERROR_RESIZE            = 'errResize';
    const ERROR_UNSUPPORT_TYPE    = 'errUsupportType';
    const ERROR_NOT_UTF8_CONTENT  = 'errNotUTF8Content';
    
    /**
     * Constructor
     *
     * @param  array  elFinder and roots configurations
     * @return void
     * @author Dmitry (dio) Levashov
     **/
    public function __construct($opts) {
        
        $this->time  = $this->utime();
        $this->debug = (isset($opts['debug']) && $opts['debug'] ? true : false);
        
        setlocale(LC_ALL, !empty($opts['locale']) ? $opts['locale'] : 'en_US.UTF-8');

        // bind events listeners
        if (!empty($opts['bind']) && is_array($opts['bind'])) {
            foreach ($opts['bind'] as $cmd => $handler) {
                $this->bind($cmd, $handler);
            }
        }

        // "mount" volumes
        if (isset($opts['roots']) && is_array($opts['roots'])) {
            
            foreach ($opts['roots'] as $i => $o) {
                $class = 'elFinderVolume'.(isset($o['driver']) ? $o['driver'] : '');

                if (class_exists($class)) {
                    $volume = new $class();

                    if ($volume->mount($o)) {
                        // unique volume id (ends on "_") - used as prefix to files hash
                        $id = $volume->id();
                        
                        $this->volumes[$id] = $volume;
                        if (!$this->default && $volume->isReadable()) {
                            $this->default = $this->volumes[$id]; 
                        }
                    } else {
                        $this->mountErrors[] = 'Driver "'.$class.'" : '.implode(' ', $volume->error());
                    }
                } else {
                    $this->mountErrors[] = 'Driver "'.$class.'" does not exists';
                }
            }
        }
        // if at least one redable volume - ii desu >_<
        $this->loaded = !empty($this->default);
    }
    
    /**
     * Return true if fm init correctly
     *
     * @return bool
     * @author Dmitry (dio) Levashov
     **/
    public function loaded() {
        return $this->loaded;
    }
    
    /**
     * Return version (api) number
     *
     * @return string
     * @author Dmitry (dio) Levashov
     **/
    public function version() {
        return $this->version;
    }
    
    /**
     * Add handler to elFinder command
     *
     * @param  string  command name
     * @param  string|array  callback name or array(object, method)
     * @return elFinder
     * @author Dmitry (dio) Levashov
     **/
    public function bind($cmd, $handler) {
        $cmds = array_map('trim', explode(' ', $cmd));
        
        foreach ($cmds as $cmd) {
            if ($cmd) {
                if (!isset($this->listeners[$cmd])) {
                    $this->listeners[$cmd] = array();
                }

                if ((is_array($handler) && count($handler) == 2 && is_object($handler[0]) && method_exists($handler[0], $handler[1]))
                || function_exists($handler)) {
                    $this->listeners[$cmd][] = $handler;
                }
            }
        }

        return $this;
    }
    
    /**
     * Remove event (command exec) handler
     *
     * @param  string  command name
     * @param  string|array  callback name or array(object, method)
     * @return elFinder
     * @author Dmitry (dio) Levashov
     **/
    public function unbind($cmd, $handler) {
        if (!empty($this->listeners[$cmd])) {
            foreach ($this->listeners[$cmd] as $i => $h) {
                if ($h === $handler) {
                    unset($this->listeners[$cmd][$i]);
                    return $this;
                }
            }
        }
        return $this;
    }
    
    /**
     * Return true if command exists
     *
     * @param  string  command name
     * @return bool
     * @author Dmitry (dio) Levashov
     **/
    public function commandExists($cmd) {
        return $this->loaded && isset($this->commands[$cmd]) && method_exists($this, $cmd);
    }
    
    /**
     * Return command required arguments info
     *
     * @param  string  command name
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    public function commandArgsList($cmd) {
        return $this->commandExists($cmd) ? $this->commands[$cmd] : array();
    }
    
    /**
     * Exec command and return result
     *
     * @param  string  $cmd  command name
     * @param  array   $args command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    public function exec($cmd, $args) {
        
        if (!$this->loaded) {
            return array('error' => $this->error(self::ERROR_CONF, self::ERROR_CONF_NO_VOL));
        }
        
        if (!$this->commandExists($cmd)) {
            return array('error' => $this->error(self::ERROR_UNKNOWN_CMD));
        }
        
        if (!empty($args['mimes']) && is_array($args['mimes'])) {
            foreach ($this->volumes as $id => $v) {
                $this->volumes[$id]->setMimesFilter($args['mimes']);
            }
        }
        
        $result = $this->$cmd($args);
        
        if (isset($result['removed'])) {
            foreach ($this->volumes as $volume) {
                $result['removed'] = array_merge($result['removed'], $volume->removed());
                $volume->resetRemoved();
            }
        }
        
        // call handlers for this command
        if (!empty($this->listeners[$cmd])) {
            foreach ($this->listeners[$cmd] as $handler) {
                if ((is_array($handler) && $handler[0]->{$handler[1]}($cmd, $result, $args, $this))
                ||  (!is_array($handler) && $handler($cmd, $result, $args, $this))) {
                    // handler return true to force sync client after command completed
                    $result['sync'] = true;
                }
            }
        }
        
        // replace removed files info with removed files hashes
        if (!empty($result['removed'])) {
            $removed = array();
            foreach ($result['removed'] as $file) {
                $removed[] = $file['hash'];
            }
            $result['removed'] = array_unique($removed);
        }
        // remove hidden files and filter files by mimetypes
        if (!empty($result['added'])) {
            $result['added'] = $this->filter($result['added']);
        }
        // remove hidden files and filter files by mimetypes
        if (!empty($result['changed'])) {
            $result['changed'] = $this->filter($result['changed']);
        }
        
        if ($this->debug || !empty($args['debug'])) {
            $result['debug'] = array(
                'connector' => 'php', 
                'phpver'    => PHP_VERSION,
                'time'      => $this->utime() - $this->time,
                'memory'    => (function_exists('memory_get_peak_usage') ? ceil(memory_get_peak_usage()/1024).'Kb / ' : '').ceil(memory_get_usage()/1024).'Kb / '.ini_get('memory_limit'),
                'upload'    => $this->uploadDebug,
                'volumes'   => array(),
                'mountErrors' => $this->mountErrors
                );
            
            foreach ($this->volumes as $id => $volume) {
                $result['debug']['volumes'][] = $volume->debug();
            }
        }
        
        foreach ($this->volumes as $volume) {
            $volume->umount();
        }
        
        return $result;
    }
    
    /**
     * Return file real path
     *
     * @param  string  $hash  file hash
     * @return string
     * @author Dmitry (dio) Levashov
     **/
    public function realpath($hash) {
        if (($volume = $this->volume($hash)) == false) {
            return false;
        }
        return $volume->realpath($hash);
    }
    
    /***************************************************************************/
    /*                                 commands                                */
    /***************************************************************************/
    
    /**
     * Normalize error messages
     *
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    public function error() {
        $errors = array();

        foreach (func_get_args() as $msg) {
            if (is_array($msg)) {
                $errors = array_merge($errors, $msg);
            } else {
                $errors[] = $msg;
            }
        }
        
        return count($errors) ? $errors : array(self::ERROR_UNKNOWN);
    }
    
    /**
     * "Open" directory
     * Return array with following elements
     *  - cwd          - opened dir info
     *  - files        - opened dir content [and dirs tree if $args[tree]]
     *  - api          - api version (if $args[init])
     *  - uplMaxSize   - if $args[init]
     *  - error        - on failed
     *
     * @param  array  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function open($args) {
        $target = $args['target'];
        $init   = !empty($args['init']);
        $tree   = !empty($args['tree']);
        $volume = $this->volume($target);
        $cwd    = $volume ? $volume->dir($target, true) : false;
        $hash   = $init ? 'default folder' : '#'.$target;

        // on init request we can get invalid dir hash -
        // dir which can not be opened now, but remembered by client,
        // so open default dir
        if ((!$cwd || !$cwd['read']) && $init) {
            $volume = $this->default;
            $cwd    = $volume->dir($volume->defaultPath(), true);
        }
        
        if (!$cwd) {
            return array('error' => $this->error(self::ERROR_OPEN, $hash, self::ERROR_DIR_NOT_FOUND));
        }
        if (!$cwd['read']) {
            return array('error' => $this->error(self::ERROR_OPEN, $hash, self::ERROR_PERM_DENIED));
        }

        $files = array();

        // get folders trees
        if ($args['tree']) {
            foreach ($this->volumes as $id => $v) {

                if (($tree = $v->tree('', 0, $cwd['hash'])) != false) {
                    $files = array_merge($files, $tree);
                }
            }
        }

        // get current working directory files list and add to $files if not exists in it
        if (($ls = $volume->scandir($cwd['hash'])) === false) {
            return array('error' => $this->error(self::ERROR_OPEN, $cwd['name'], $volume->error()));
        }
        
        foreach ($ls as $file) {
            if (!in_array($file, $files)) {
                $files[] = $file;
            }
        }
        
        $result = array(
            'cwd'     => $cwd,
            'options' => $volume->options($cwd['hash']),
            'files'   => $files
        );

        if (!empty($args['init'])) {
            $result['api'] = $this->version;
            $result['uplMaxSize'] = ini_get('upload_max_filesize');
        }
        
        return $result;
    }
    
    /**
     * Return dir files names list
     *
     * @param  array  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function ls($args) {
        $target = $args['target'];
        
        if (($volume = $this->volume($target)) == false
        || ($list = $volume->ls($target)) === false) {
            return array('error' => $this->error(self::ERROR_OPEN, '#'.$target));
        }
        return array('list' => $list);
    }
    
    /**
     * Return subdirs for required directory
     *
     * @param  array  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function tree($args) {
        $target = $args['target'];
        
        if (($volume = $this->volume($target)) == false
        || ($tree = $volume->tree($target)) == false) {
            return array('error' => $this->error(self::ERROR_OPEN, '#'.$target));
        }

        return array('tree' => $tree);
    }
    
    /**
     * Return parents dir for required directory
     *
     * @param  array  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function parents($args) {
        $target = $args['target'];
        
        if (($volume = $this->volume($target)) == false
        || ($tree = $volume->parents($target)) == false) {
            return array('error' => $this->error(self::ERROR_OPEN, '#'.$target));
        }

        return array('tree' => $tree);
    }
    
    /**
     * Return new created thumbnails list
     *
     * @param  array  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function tmb($args) {
        
        $result  = array('images' => array());
        $targets = $args['targets'];
        
        foreach ($targets as $target) {
            if (($volume = $this->volume($target)) != false
            && (($tmb = $volume->tmb($target)) != false)) {
                $result['images'][$target] = $tmb;
            }
        }
        return $result;
    }
    
    /**
     * Required to output file in browser when volume URL is not set 
     * Return array contains opened file pointer, root itself and required headers
     *
     * @param  array  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function file($args) {
        $target   = $args['target'];
        $download = !empty($args['download']);
        $h403     = 'HTTP/1.x 403 Access Denied';
        $h404     = 'HTTP/1.x 404 Not Found';

        if (($volume = $this->volume($target)) == false) { 
            return array('error' => 'File not found', 'header' => $h404, 'raw' => true);
        }
        
        if (($file = $volume->file($target)) == false) {
            return array('error' => 'File not found', 'header' => $h404, 'raw' => true);
        }
        
        if (!$file['read']) {
            return array('error' => 'Access denied', 'header' => $h403, 'raw' => true);
        }
        
        if (($fp = $volume->open($target)) == false) {
            return array('error' => 'File not found', 'header' => $h404, 'raw' => true);
        }

        if ($download) {
            $disp = 'attachment';
            $mime = 'application/octet-stream';
        } else {
            $disp  = preg_match('/^(image|text)/i', $file['mime']) || $file['mime'] == 'application/x-shockwave-flash' 
                    ? 'inline' 
                    : 'attachment';
            $mime = $file['mime'];
        }
        
        $filenameEncoded = rawurlencode($file['name']);
        if (strpos($filenameEncoded, '%') === false) { // ASCII only
            $filename = 'filename="'.$file['name'].'"';
        } else {
            $ua = $_SERVER["HTTP_USER_AGENT"];
            if (preg_match('/MSIE [4-8]/', $ua)) { // IE < 9 do not support RFC 6266 (RFC 2231/RFC 5987)
                $filename = 'filename="'.$filenameEncoded.'"';
            } else { // RFC 6266 (RFC 2231/RFC 5987)
                $filename = 'filename*=UTF-8\'\''.$filenameEncoded;
            }
        }
        
        $result = array(
            'volume'  => $volume,
            'pointer' => $fp,
            'info'    => $file,
            'header'  => array(
                'Content-Type: '.$mime, 
                'Content-Disposition: '.$disp.'; '.$filename,
                'Content-Location: '.$file['name'],
                'Content-Transfer-Encoding: binary',
                'Content-Length: '.$file['size'],
                'Connection: close'
            )
        );
        return $result;
    }
    
    /**
     * Count total files size
     *
     * @param  array  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function size($args) {
        $size = 0;
        
        foreach ($args['targets'] as $target) {
            if (($volume = $this->volume($target)) == false
            || ($file = $volume->file($target)) == false
            || !$file['read']) {
                return array('error' => $this->error(self::ERROR_OPEN, '#'.$target));
            }
            
            $size += $volume->size($target);
        }
        return array('size' => $size);
    }
    
    /**
     * Create directory
     *
     * @param  array  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function mkdir($args) {
        $target = $args['target'];
        $name   = $args['name'];
        
        if (($volume = $this->volume($target)) == false) {
            return array('error' => $this->error(self::ERROR_MKDIR, $name, self::ERROR_TRGDIR_NOT_FOUND, '#'.$target));
        }

        return ($dir = $volume->mkdir($target, $name)) == false
            ? array('error' => $this->error(self::ERROR_MKDIR, $name, $volume->error()))
            : array('added' => array($dir));
    }
    
    /**
     * Create empty file
     *
     * @param  array  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function mkfile($args) {
        $target = $args['target'];
        $name   = $args['name'];
        
        if (($volume = $this->volume($target)) == false) {
            return array('error' => $this->error(self::ERROR_MKFILE, $name, self::ERROR_TRGDIR_NOT_FOUND, '#'.$target));
        }

        return ($file = $volume->mkfile($target, $args['name'])) == false
            ? array('error' => $this->error(self::ERROR_MKFILE, $name, $volume->error()))
            : array('added' => array($file));
    }
    
    /**
     * Rename file
     *
     * @param  array  $args
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function rename($args) {
        $target = $args['target'];
        $name   = $args['name'];
        
        if (($volume = $this->volume($target)) == false
        ||  ($rm  = $volume->file($target)) == false) {
            return array('error' => $this->error(self::ERROR_RENAME, '#'.$target, self::ERROR_FILE_NOT_FOUND));
        }
        $rm['realpath'] = $volume->realpath($target);
        
        return ($file = $volume->rename($target, $name)) == false
            ? array('error' => $this->error(self::ERROR_RENAME, $rm['name'], $volume->error()))
            : array('added' => array($file), 'removed' => array($rm));
    }
    
    /**
     * Duplicate file - create copy with "copy %d" suffix
     *
     * @param array  $args  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function duplicate($args) {
        $targets = is_array($args['targets']) ? $args['targets'] : array();
        $result  = array('added' => array());
        $suffix  = empty($args['suffix']) ? 'copy' : $args['suffix'];
        
        foreach ($targets as $target) {
            if (($volume = $this->volume($target)) == false
            || ($src = $volume->file($target)) == false) {
                $result['warning'] = $this->error(self::ERROR_COPY, '#'.$target, self::ERROR_FILE_NOT_FOUND);
                break;
            }
            
            if (($file = $volume->duplicate($target, $suffix)) == false) {
                $result['warning'] = $this->error($volume->error());
                break;
            }
            
            $result['added'][] = $file;
        }
        
        return $result;
    }
        
    /**
     * Remove dirs/files
     *
     * @param array  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function rm($args) {
        $targets = is_array($args['targets']) ? $args['targets'] : array();
        $result  = array('removed' => array());
        
        foreach ($targets as $target) {
            if (($volume = $this->volume($target)) == false) {
                $result['warning'] = $this->error(self::ERROR_RM, '#'.$target, self::ERROR_FILE_NOT_FOUND);
                return $result;
            }
            if (!$volume->rm($target)) {
                $result['warning'] = $this->error($volume->error());
                return $result;
            }
        }

        return $result;
    }
    
    /**
     * Save uploaded files
     *
     * @param  array
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function upload($args) {
        $target = $args['target'];
        $volume = $this->volume($target);
        $files  = isset($args['FILES']['upload']) && is_array($args['FILES']['upload']) ? $args['FILES']['upload'] : array();
        $result = array('added' => array(), 'header' => empty($args['html']) ? false : 'Content-Type: text/html; charset=utf-8');
        
        if (empty($files)) {
            return array('error' => $this->error(self::ERROR_UPLOAD, self::ERROR_UPLOAD_NO_FILES), 'header' => $header);
        }
        
        if (!$volume) {
            return array('error' => $this->error(self::ERROR_UPLOAD, self::ERROR_TRGDIR_NOT_FOUND, '#'.$target), 'header' => $header);
        }
        
        foreach ($files['name'] as $i => $name) {
            if (($error = $files['error'][$i]) > 0) {               
                $result['warning'] = $this->error(self::ERROR_UPLOAD_FILE, $name, $error == UPLOAD_ERR_INI_SIZE || $error == UPLOAD_ERR_FORM_SIZE ? self::ERROR_UPLOAD_FILE_SIZE : self::ERROR_UPLOAD_TRANSFER);
                $this->uploadDebug = 'Upload error code: '.$error;
                break;
            }
            
            $tmpname = $files['tmp_name'][$i];
            
            if (($fp = fopen($tmpname, 'rb')) == false) {
                $result['warning'] = $this->error(self::ERROR_UPLOAD_FILE, $name, self::ERROR_UPLOAD_TRANSFER);
                $this->uploadDebug = 'Upload error: unable open tmp file';
                break;
            }
            
            if (($file = $volume->upload($fp, $target, $name, $tmpname)) === false) {
                $result['warning'] = $this->error(self::ERROR_UPLOAD_FILE, $name, $volume->error());
                fclose($fp);
                break;
            }
            
            fclose($fp);
            $result['added'][] = $file;
        }
        
        return $result;
    }
        
    /**
     * Copy/move files into new destination
     *
     * @param  array  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function paste($args) {
        $dst     = $args['dst'];
        $targets = is_array($args['targets']) ? $args['targets'] : array();
        $cut     = !empty($args['cut']);
        $error   = $cut ? self::ERROR_MOVE : self::ERROR_COPY;
        $result  = array('added' => array(), 'removed' => array());
        
        if (($dstVolume = $this->volume($dst)) == false) {
            return array('error' => $this->error($error, '#'.$targets[0], self::ERROR_TRGDIR_NOT_FOUND, '#'.$dst));
        }
        
        foreach ($targets as $target) {
            if (($srcVolume = $this->volume($target)) == false) {
                $result['warning'] = $this->error($error, '#'.$target, self::ERROR_FILE_NOT_FOUND);
                break;
            }
            
            if (($file = $dstVolume->paste($srcVolume, $target, $dst, $cut)) == false) {
                $result['warning'] = $this->error($dstVolume->error());
                break;
            }
            
            $result['added'][] = $file;
        }
        return $result;
    }
    
    /**
     * Return file content
     *
     * @param  array  $args  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function get($args) {
        $target = $args['target'];
        $volume = $this->volume($target);
        
        if (!$volume || ($file = $volume->file($target)) == false) {
            return array('error' => $this->error(self::ERROR_OPEN, '#'.$target, self::ERROR_FILE_NOT_FOUND));
        }
        
        if (($content = $volume->getContents($target)) === false) {
            return array('error' => $this->error(self::ERROR_OPEN, $volume->path($target), $volume->error()));
        }
        
        $json = json_encode($content);

        if ($json == 'null' && strlen($json) < strlen($content)) {
            return array('error' => $this->error(self::ERROR_NOT_UTF8_CONTENT, $volume->path($target)));
        }
        
        return array('content' => $content);
    }
    
    /**
     * Save content into text file
     *
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function put($args) {
        $target = $args['target'];
        
        if (($volume = $this->volume($target)) == false
        || ($file = $volume->file($target)) == false) {
            return array('error' => $this->error(self::ERROR_SAVE, '#'.$target, self::ERROR_FILE_NOT_FOUND));
        }
        
        if (($file = $volume->putContents($target, $args['content'])) == false) {
            return array('error' => $this->error(self::ERROR_SAVE, $volume->path($target), $volume->error()));
        }
        
        return array('changed' => array($file));
    }

    /**
     * Extract files from archive
     *
     * @param  array  $args  command arguments
     * @return array
     * @author Dmitry (dio) Levashov, 
     * @author Alexey Sukhotin
     **/
    protected function extract($args) {
        $target = $args['target'];
        $mimes  = !empty($args['mimes']) && is_array($args['mimes']) ? $args['mimes'] : array();
        $error  = array(self::ERROR_EXTRACT, '#'.$target);

        if (($volume = $this->volume($target)) == false
        || ($file = $volume->file($target)) == false) {
            return array('error' => $this->error(self::ERROR_EXTRACT, '#'.$target, self::ERROR_FILE_NOT_FOUND));
        }  

        return ($file = $volume->extract($target))
            ? array('added' => array($file))
            : array('error' => $this->error(self::ERROR_EXTRACT, $volume->path($target), $volume->error()));
    }
    
    /**
     * Create archive
     *
     * @param  array  $args  command arguments
     * @return array
     * @author Dmitry (dio) Levashov, 
     * @author Alexey Sukhotin
     **/
    protected function archive($args) {
        $type    = $args['type'];
        $targets = isset($args['targets']) && is_array($args['targets']) ? $args['targets'] : array();
    
        if (($volume = $this->volume($targets[0])) == false) {
            return $this->error(self::ERROR_ARCHIVE, self::ERROR_TRGDIR_NOT_FOUND);
        }
    
        return ($file = $volume->archive($targets, $args['type']))
            ? array('added' => array($file))
            : array('error' => $this->error(self::ERROR_ARCHIVE, $volume->error()));
    }
    
    /**
     * Search files
     *
     * @param  array  $args  command arguments
     * @return array
     * @author Dmitry Levashov
     **/
    protected function search($args) {
        $q      = trim($args['q']);
        $mimes  = !empty($args['mimes']) && is_array($args['mimes']) ? $args['mimes'] : array();
        $result = array();

        foreach ($this->volumes as $volume) {
            $result = array_merge($result, $volume->search($q, $mimes));
        }
        
        return array('files' => $result);
    }
    
    /**
     * Return file info (used by client "places" ui)
     *
     * @param  array  $args  command arguments
     * @return array
     * @author Dmitry Levashov
     **/
    protected function info($args) {
        $files = array();
        
        foreach ($args['targets'] as $hash) {
            if (($volume = $this->volume($hash)) != false
            && ($info = $volume->file($hash)) != false) {
                $files[] = $info;
            }
        }
        
        return array('files' => $files);
    }
    
    /**
     * Return image dimmensions
     *
     * @param  array  $args  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function dim($args) {
        $target = $args['target'];
        
        if (($volume = $this->volume($target)) != false) {
            $dim = $volume->dimensions($target);
            return $dim ? array('dim' => $dim) : array();
        }
        return array();
    }
    
    /**
     * Resize image
     *
     * @param  array  command arguments
     * @return array
     * @author Dmitry (dio) Levashov
     * @author Alexey Sukhotin
     **/
    protected function resize($args) {
        $target = $args['target'];
        $width  = $args['width'];
        $height = $args['height'];
        $x      = (int)$args['x'];
        $y      = (int)$args['y'];
        $mode   = $args['mode'];
        $bg     = null;
        $degree = (int)$args['degree'];
        
        if (($volume = $this->volume($target)) == false
        || ($file = $volume->file($target)) == false) {
            return array('error' => $this->error(self::ERROR_RESIZE, '#'.$target, self::ERROR_FILE_NOT_FOUND));
        }

        return ($file = $volume->resize($target, $width, $height, $x, $y, $mode, $bg, $degree))
            ? array('changed' => array($file))
            : array('error' => $this->error(self::ERROR_RESIZE, $volume->path($target), $volume->error()));
    }
    
    /***************************************************************************/
    /*                                   utils                                 */
    /***************************************************************************/
    
    /**
     * Return root - file's owner
     *
     * @param  string  file hash
     * @return elFinderStorageDriver
     * @author Dmitry (dio) Levashov
     **/
    protected function volume($hash) {
        foreach ($this->volumes as $id => $v) {
            if (strpos(''.$hash, $id) === 0) {
                return $this->volumes[$id];
            } 
        }
        return false;
    }
    
    /**
     * Return files info array 
     *
     * @param  array  $data  one file info or files info
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function toArray($data) {
        return isset($data['hash']) || !is_array($data) ? array($data) : $data;
    }
    
    /**
     * Return fils hashes list
     *
     * @param  array  $files  files info
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function hashes($files) {
        $ret = array();
        foreach ($files as $file) {
            $ret[] = $file['hash'];
        }
        return $ret;
    }
    
    /**
     * Remove from files list hidden files and files with required mime types
     *
     * @param  array  $files  files info
     * @return array
     * @author Dmitry (dio) Levashov
     **/
    protected function filter($files) {
        foreach ($files as $i => $file) {
            if (!empty($file['hidden']) || !$this->default->mimeAccepted($file['mime'])) {
                unset($files[$i]);
            }
        }
        return array_merge($files, array());
    }
    
    protected function utime() {
        $time = explode(" ", microtime());
        return (double)$time[1] + (double)$time[0];
    }
    
} // END class
