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