File indexing completed on 2025-03-16 05:28:23

 <?php
 
 /**
  * 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