<?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