<?php

/**
 * Vvveb
 *
 * Copyright (C) 2022  Ziadin Givan
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as
 * published by the Free Software Foundation, either version 3 of the
 * License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 *
 */

abstract class elFinderVolumeDriver {
	/**
	 * Net mount key.
	 *
	 * @var string
	 **/
	public $netMountKey = '';

	/**
	 * Request args
	 * $_POST or $_GET values.
	 *
	 * @var array
	 */
	protected $ARGS = [];

	/**
	 * Driver id
	 * Must be started from letter and contains [a-z0-9]
	 * Used as part of volume id.
	 *
	 * @var string
	 **/
	protected $driverId = 'a';

	/**
	 * Volume id - used as prefix for files hashes.
	 *
	 * @var string
	 **/
	protected $id = '';

	/**
	 * Flag - volume "mounted" and available.
	 *
	 * @var bool
	 **/
	protected $mounted = false;

	/**
	 * Root directory path.
	 *
	 * @var string
	 **/
	protected $root = '';

	/**
	 * Root basename | alias.
	 *
	 * @var string
	 **/
	protected $rootName = '';

	/**
	 * Default directory to open.
	 *
	 * @var string
	 **/
	protected $startPath = '';

	/**
	 * Base URL.
	 *
	 * @var string
	 **/
	protected $URL = '';

	/**
	 * Path to temporary directory.
	 *
	 * @var string
	 */
	protected $tmp;

	/**
	 * A file save destination path when a temporary content URL is required
	 * on a network volume or the like
	 * If not specified, it tries to use "Connector Path/../files/.tmb".
	 *
	 * @var string
	 */
	protected $tmpLinkPath = '';

	/**
	 * A file save destination URL when a temporary content URL is required
	 * on a network volume or the like
	 * If not specified, it tries to use "Connector URL/../files/.tmb".
	 *
	 * @var string
	 */
	protected $tmpLinkUrl = '';

	/**
	 * Thumbnails dir path.
	 *
	 * @var string
	 **/
	protected $tmbPath = '';

	/**
	 * Is thumbnails dir writable.
	 *
	 * @var bool
	 **/
	protected $tmbPathWritable = false;

	/**
	 * Thumbnails base URL.
	 *
	 * @var string
	 **/
	protected $tmbURL = '';

	/**
	 * Thumbnails size in px.
	 *
	 * @var int
	 **/
	protected $tmbSize = 48;

	/**
	 * Image manipulation lib name
	 * auto|imagick|gd|convert.
	 *
	 * @var string
	 **/
	protected $imgLib = 'auto';

	/**
	 * Video to Image converter.
	 *
	 * @var array
	 */
	protected $imgConverter = [];

	/**
	 * Library to crypt files name.
	 *
	 * @var string
	 **/
	protected $cryptLib = '';

	/**
	 * Archivers config.
	 *
	 * @var array
	 **/
	protected $archivers = [
		'create'  => [],
		'extract' => [],
	];

	/**
	 * Static var of $this->options['maxArcFilesSize'].
	 * 
	 * @var int|string
	 */
	protected static $maxArcFilesSize;

	/**
	 * Server character encoding.
	 *
	 * @var string or null
	 **/
	protected $encoding = null;

	/**
	 * How many subdirs levels return for tree.
	 *
	 * @var int
	 **/
	protected $treeDeep = 1;

	/**
	 * Errors from last failed action.
	 *
	 * @var array
	 **/
	protected $error = [];

	/**
	 * Today 24:00 timestamp.
	 *
	 * @var int
	 **/
	protected $today = 0;

	/**
	 * Yesterday 24:00 timestamp.
	 *
	 * @var int
	 **/
	protected $yesterday = 0;

	/**
	 * Force make dirctory on extract.
	 *
	 * @var int
	 **/
	protected $extractToNewdir = 'auto';

	/**
	 * Object configuration.
	 *
	 * @var array
	 **/
	protected $options = [
		// Driver ID (Prefix of volume ID), Normally, the value specified for each volume driver is used.
		'driverId' => '',
		// Id (Suffix of volume ID), Normally, the number incremented according to the specified number of volumes is used.
		'id' => '',
		// revision id of root directory that uses for caching control of root stat
		'rootRev' => '',
		// driver type it uses volume root's CSS class name. e.g. 'group' -> Adds 'elfinder-group' to CSS class name.
		'type' => '',
		// root directory path
		'path' => '',
		// Folder hash value on elFinder to be the parent of this volume
		'phash' => '',
		// Folder hash value on elFinder to trash bin of this volume, it require 'copyJoin' to true
		'trashHash' => '',
		// open this path on initial request instead of root path
		'startPath' => '',
		// how many subdirs levels return per request
		'treeDeep' => 1,
		// root url, not set to URL via the connector. If you want to hide the file URL, do not set this value. (replacement for old "fileURL" option)
		'URL' => '',
		// enable onetime URL to a file - (true, false, 'auto' (true if a temporary directory is available) or callable (A function that return onetime URL))
		'onetimeUrl' => 'auto',
		// directory link url to own manager url with folder hash (`true`, `false`, `'hide'`(No show) or default `'auto'`: URL is empty then `true` else `false`)
		'dirUrlOwn' => 'auto',
		// directory separator. required by client to show paths correctly
		'separator' => DIRECTORY_SEPARATOR,
		// Use '/' as directory separator when the path hash encode/decode on the Windows server too
		'winHashFix' => false,
		// Server character encoding (default is '': UTF-8)
		'encoding' => '',
		// for convert character encoding (default is '': Not change locale)
		'locale' => '',
		// URL of volume icon image
		'icon' => '',
		// CSS Class of volume root in tree
		'rootCssClass' => '',
		// Items to disable session caching
		'noSessionCache' => [],
		// enable i18n folder name that convert name to elFinderInstance.messages['folder_'+name]
		'i18nFolderName' => false,
		// Search timeout (sec)
		'searchTimeout' => 30,
		// Search exclusion directory regex pattern (require demiliter e.g. '#/path/to/exclude_directory#i')
		'searchExDirReg' => '',
		// library to crypt/uncrypt files names (not implemented)
		'cryptLib' => '',
		// how to detect files mimetypes. (auto/internal/finfo/mime_content_type)
		'mimeDetect' => 'auto',
		// mime.types file path (for mimeDetect==internal)
		'mimefile' => '',
		// Static extension/MIME of general server side scripts to security issues
		'staticMineMap' => [
			'php:*'   => 'text/x-php',
			'pht:*'   => 'text/x-php',
			'php3:*'  => 'text/x-php',
			'php4:*'  => 'text/x-php',
			'php5:*'  => 'text/x-php',
			'php7:*'  => 'text/x-php',
			'php8:*'  => 'text/x-php',
			'php9:*'  => 'text/x-php',
			'phtml:*' => 'text/x-php',
			'phar:*'  => 'text/x-php',
			'cgi:*'   => 'text/x-httpd-cgi',
			'pl:*'    => 'text/x-perl',
			'asp:*'   => 'text/x-asap',
			'aspx:*'  => 'text/x-asap',
			'py:*'    => 'text/x-python',
			'rb:*'    => 'text/x-ruby',
			'jsp:*'   => 'text/x-jsp',
		],
		// mime type normalize map : Array '[ext]:[detected mime type]' => '[normalized mime]'
		'mimeMap' => [
			'md:application/x-genesis-rom'    => 'text/x-markdown',
			'md:text/plain'                   => 'text/x-markdown',
			'markdown:text/plain'             => 'text/x-markdown',
			'css:text/x-asm'                  => 'text/css',
			'css:text/plain'                  => 'text/css',
			'csv:text/plain'                  => 'text/csv',
			'java:text/x-c'                   => 'text/x-java-source',
			'json:text/plain'                 => 'application/json',
			'sql:text/plain'                  => 'text/x-sql',
			'rtf:text/rtf'                    => 'application/rtf',
			'rtfd:text/rtfd'                  => 'application/rtfd',
			'ico:image/vnd.microsoft.icon'    => 'image/x-icon',
			'svg:text/plain'                  => 'image/svg+xml',
			'pxd:application/octet-stream'    => 'image/x-pixlr-data',
			'dng:image/tiff'                  => 'image/x-adobe-dng',
			'sketch:application/zip'          => 'image/x-sketch',
			'sketch:application/octet-stream' => 'image/x-sketch',
			'xcf:application/octet-stream'    => 'image/x-xcf',
			'amr:application/octet-stream'    => 'audio/amr',
			'm4a:video/mp4'                   => 'audio/mp4',
			'oga:application/ogg'             => 'audio/ogg',
			'ogv:application/ogg'             => 'video/ogg',
			'zip:application/x-zip'           => 'application/zip',
			'm3u8:text/plain'                 => 'application/x-mpegURL',
			'mpd:text/plain'                  => 'application/dash+xml',
			'mpd:application/xml'             => 'application/dash+xml',
			'*:application/x-dosexec'         => 'application/x-executable',
			'doc:application/vnd.ms-office'   => 'application/msword',
			'xls:application/vnd.ms-office'   => 'application/vnd.ms-excel',
			'ppt:application/vnd.ms-office'   => 'application/vnd.ms-powerpoint',
			'yml:text/plain'                  => 'text/x-yaml',
			'ai:application/pdf'              => 'application/postscript',
			'cgm:text/plain'                  => 'image/cgm',
			'dxf:text/plain'                  => 'image/vnd.dxf',
			'dds:application/octet-stream'    => 'image/vnd-ms.dds',
			'hpgl:text/plain'                 => 'application/vnd.hp-hpgl',
			'igs:text/plain'                  => 'model/iges',
			'iges:text/plain'                 => 'model/iges',
			'plt:application/octet-stream'    => 'application/plt',
			'plt:text/plain'                  => 'application/plt',
			'sat:text/plain'                  => 'application/sat',
			'step:text/plain'                 => 'application/step',
			'stp:text/plain'                  => 'application/step',
		],
		// An option to add MimeMap to the `mimeMap` option
		// Array '[ext]:[detected mime type]' => '[normalized mime]'
		'additionalMimeMap' => [],
		// MIME-Type of filetype detected as unknown
		'mimeTypeUnknown' => 'application/octet-stream',
		// MIME regex of send HTTP header "Content-Disposition: inline" or allow preview in quicklook
		// '.' is allow inline of all of MIME types
		// '$^' is not allow inline of all of MIME types
		'dispInlineRegex' => '^(?:(?:video|audio)|image/(?!.+\+xml)|application/(?:ogg|x-mpegURL|dash\+xml)|(?:text/plain|application/pdf)$)',
		// temporary content URL's base path
		'tmpLinkPath' => '',
		// temporary content URL's base URL
		'tmpLinkUrl' => '',
		// directory for thumbnails
		'tmbPath' => '.tmb',
		// mode to create thumbnails dir
		'tmbPathMode' => 0777,
		// thumbnails dir URL. Set it if store thumbnails outside root directory
		'tmbURL' => '',
		// thumbnails size (px)
		'tmbSize' => 48,
		// thumbnails crop (true - crop, false - scale image to fit thumbnail size)
		'tmbCrop' => true,
		// thumbnail URL require custom data as the GET query
		'tmbReqCustomData' => false,
		// thumbnails background color (hex #rrggbb or 'transparent')
		'tmbBgColor' => 'transparent',
		// image rotate fallback background color (hex #rrggbb)
		'bgColorFb' => '#ffffff',
		// image manipulations library (imagick|gd|convert|auto|none, none - Does not check the image library at all.)
		'imgLib' => 'auto',
		// Fallback self image to thumbnail (nothing imgLib)
		'tmbFbSelf' => true,
		// Video to Image converters ['TYPE or MIME' => ['func' => function($file){ /* Converts $file to Image */ return true; }, 'maxlen' => (int)TransferLength]]
		'imgConverter' => [],
		// Max length of transfer to image converter
		'tmbVideoConvLen' => 10000000,
		// Captre point seccond
		'tmbVideoConvSec' => 6,
		// Life time (hour) for thumbnail garbage collection ("0" means no GC)
		'tmbGcMaxlifeHour' => 0,
		// Percentage of garbage collection executed for thumbnail creation command ("1" means "1%")
		'tmbGcPercentage' => 1,
		// Resource path of fallback icon images defailt: php/resouces
		'resourcePath' => '',
		// Jpeg image saveing quality
		'jpgQuality' => 100,
		// Save as progressive JPEG on image editing
		'jpgProgressive' => true,
		// enable to get substitute image with command `dim`
		'substituteImg' => true,
		// on paste file -  if true - old file will be replaced with new one, if false new file get name - original_name-number.ext
		'copyOverwrite' => true,
		// if true - join new and old directories content on paste
		'copyJoin' => true,
		// on upload -  if true - old file will be replaced with new one, if false new file get name - original_name-number.ext
		'uploadOverwrite' => true,
		// mimetypes allowed to upload
		'uploadAllow' => [],
		// mimetypes not allowed to upload
		'uploadDeny' => [],
		// order to process uploadAllow and uploadDeny options
		'uploadOrder' => ['deny', 'allow'],
		// maximum upload file size. NOTE - this is size for every uploaded files
		'uploadMaxSize' => 0,
		// Maximum number of folders that can be created at one time. (0: unlimited)
		'uploadMaxMkdirs' => 0,
		// maximum number of chunked upload connection. `-1` to disable chunked upload
		'uploadMaxConn' => 3,
		// maximum get file size. NOTE - Maximum value is 50% of PHP memory_limit
		'getMaxSize' => 0,
		// files dates format
		'dateFormat' => 'j M Y H:i',
		// files time format
		'timeFormat' => 'H:i',
		// if true - every folder will be check for children folders, -1 - every folder will be check asynchronously, false -  all folders will be marked as having subfolders
		'checkSubfolders' => true, // true, false or -1
		// allow to copy from this volume to other ones?
		'copyFrom' => true,
		// allow to copy from other volumes to this one?
		'copyTo' => true,
		// cmd duplicate suffix format e.g. '_%s_' to without spaces
		'duplicateSuffix' => ' %s ',
		// unique name numbar format e.g. '(%d)' to (1), (2)...
		'uniqueNumFormat' => '%d',
		// list of commands disabled on this root
		'disabled' => [],
		// enable file owner, group & mode info, `false` to inactivate "chmod" command.
		'statOwner' => false,
		// allow exec chmod of read-only files
		'allowChmodReadOnly' => false,
		// regexp or function name to validate new file name
		'acceptedName' => '/^[^\.].*/', // Notice: overwritten it in some volume drivers contractor
		// regexp or function name to validate new directory name
		'acceptedDirname' => '', // used `acceptedName` if empty value
		// function/class method to control files permissions
		'accessControl' => null,
		// some data required by access control
		'accessControlData' => null,
		// root stat that return without asking the system when mounted and not the current volume. Query to the system with false. array|false
		'rapidRootStat' => [
			'read'   => true,
			'write'  => true,
			'locked' => false,
			'hidden' => false,
			'size'   => 0,  // Unknown
			'ts'     => 0,    // Unknown
			'dirs'   => -1, // Check on demand for subdirectories
			'mime'   => 'directory',
		],
		// default permissions.
		'defaults' => [
			'read'   => true,
			'write'  => true,
			'locked' => false,
			'hidden' => false,
		],
		// files attributes
		'attributes' => [],
		// max allowed archive files size (0 - no limit)
		'maxArcFilesSize' => '2G',
		// Allowed archive's mimetypes to create. Leave empty for all available types.
		'archiveMimes' => [],
		// Manual config for archivers. See example below. Leave empty for auto detect
		'archivers' => [],
		// Use Archive function for remote volume
		'useRemoteArchive' => false,
		// plugin settings
		'plugin' => [],
		// Is support parent directory time stamp update on add|remove|rename item
		// Default `null` is auto detection that is LocalFileSystem, FTP or Dropbox are `true`
		'syncChkAsTs' => null,
		// Long pooling sync checker function for syncChkAsTs is true
		// Calls with args (TARGET DIRCTORY PATH, STAND-BY(sec), OLD TIMESTAMP, VOLUME DRIVER INSTANCE, ELFINDER INSTANCE)
		// This function must return the following values. Changed: New Timestamp or Same: Old Timestamp or Error: false
		// Default `null` is try use elFinderVolumeLocalFileSystem::localFileSystemInotify() on LocalFileSystem driver
		// another driver use elFinder stat() checker
		'syncCheckFunc' => null,
		// Long polling sync stand-by time (sec)
		'plStandby' => 30,
		// Sleep time (sec) for elFinder stat() checker (syncChkAsTs is true)
		'tsPlSleep' => 10,
		// Sleep time (sec) for elFinder ls() checker (syncChkAsTs is false)
		'lsPlSleep' => 30,
		// Client side sync interval minimum (ms)
		// Default `null` is auto set to ('tsPlSleep' or 'lsPlSleep') * 1000
		// `0` to disable auto sync
		'syncMinMs' => null,
		// required to fix bug on macos
		// However, we recommend to use the Normalizer plugin instead this option
		'utf8fix' => false,
		//                           й                 ё              Й               Ё              Ø         Å
		'utf8patterns' => ["\u0438\u0306", "\u0435\u0308", "\u0418\u0306", "\u0415\u0308", "\u00d8A", "\u030a"],
		'utf8replace'  => ["\u0439", "\u0451", "\u0419", "\u0401", "\u00d8", "\u00c5"],
		// cache control HTTP headers for commands `file` and  `get`
		'cacheHeaders' => [
			'Cache-Control: max-age=3600',
			'Expires:',
			'Pragma:',
		],
		// Header to use to accelerate sending local files to clients (e.g. 'X-Sendfile', 'X-Accel-Redirect')
		'xsendfile' => '',
		// Root path to xsendfile target. Probably, this is required for 'X-Accel-Redirect' on Nginx.
		'xsendfilePath' => '',
	];

	/**
	 * Defaults permissions.
	 *
	 * @var array
	 **/
	protected $defaults = [
		'read'   => true,
		'write'  => true,
		'locked' => false,
		'hidden' => false,
	];

	/**
	 * Access control function/class.
	 *
	 * @var mixed
	 **/
	protected $attributes = [];

	/**
	 * Access control function/class.
	 *
	 * @var mixed
	 **/
	protected $access = null;

	/**
	 * Mime types allowed to upload.
	 *
	 * @var array
	 **/
	protected $uploadAllow = [];

	/**
	 * Mime types denied to upload.
	 *
	 * @var array
	 **/
	protected $uploadDeny = [];

	/**
	 * Order to validate uploadAllow and uploadDeny.
	 *
	 * @var array
	 **/
	protected $uploadOrder = [];

	/**
	 * Maximum allowed upload file size.
	 * Set as number or string with unit - "10M", "500K", "1G".
	 *
	 * @var int|string
	 **/
	protected $uploadMaxSize = 0;

	/**
	 * Run time setting of overwrite items on upload.
	 *
	 * @var string
	 */
	protected $uploadOverwrite = true;

	/**
	 * Maximum allowed get file size.
	 * Set as number or string with unit - "10M", "500K", "1G".
	 *
	 * @var int|string
	 **/
	protected $getMaxSize = -1;

	/**
	 * Mimetype detect method.
	 *
	 * @var string
	 **/
	protected $mimeDetect = 'auto';

	/**
	 * Flag - mimetypes from externail file was loaded.
	 *
	 * @var bool
	 **/
	private static $mimetypesLoaded = false;

	/**
	 * Finfo resource for mimeDetect == 'finfo'.
	 *
	 * @var resource
	 **/
	protected $finfo = null;

	/**
	 * List of disabled client's commands.
	 *
	 * @var array
	 **/
	protected $disabled = [];

	/**
	 * overwrite extensions/mimetypes to mime.types.
	 *
	 * @var array
	 **/
	protected static $mimetypes = [
		// applications
		'exe' => 'application/x-executable',
		'jar' => 'application/x-jar',
		// archives
		'gz'  => 'application/x-gzip',
		'tgz' => 'application/x-gzip',
		'tbz' => 'application/x-bzip2',
		'rar' => 'application/x-rar',
		// texts
		'php'      => 'text/x-php',
		'js'       => 'text/javascript',
		'rtfd'     => 'application/rtfd',
		'py'       => 'text/x-python',
		'rb'       => 'text/x-ruby',
		'sh'       => 'text/x-shellscript',
		'pl'       => 'text/x-perl',
		'xml'      => 'text/xml',
		'c'        => 'text/x-csrc',
		'h'        => 'text/x-chdr',
		'cpp'      => 'text/x-c++src',
		'hh'       => 'text/x-c++hdr',
		'md'       => 'text/x-markdown',
		'markdown' => 'text/x-markdown',
		'yml'      => 'text/x-yaml',
		// images
		'bmp' => 'image/x-ms-bmp',
		'tga' => 'image/x-targa',
		'xbm' => 'image/xbm',
		'pxm' => 'image/pxm',
		//audio
		'wav' => 'audio/wav',
		// video
		'dv'   => 'video/x-dv',
		'wm'   => 'video/x-ms-wmv',
		'ogm'  => 'video/ogg',
		'm2ts' => 'video/MP2T',
		'mts'  => 'video/MP2T',
		'ts'   => 'video/MP2T',
		'm3u8' => 'application/x-mpegURL',
		'mpd'  => 'application/dash+xml',
	];

	/**
	 * Directory separator - required by client.
	 *
	 * @var string
	 **/
	protected $separator = DIRECTORY_SEPARATOR;

	/**
	 * Directory separator for decode/encode hash.
	 *
	 * @var string
	 **/
	protected $separatorForHash = '';

	/**
	 * System Root path (Unix like: '/', Windows: '\', 'C:\' or 'D:\'...).
	 *
	 * @var string
	 **/
	protected $systemRoot = DIRECTORY_SEPARATOR;

	/**
	 * Mimetypes allowed to display.
	 *
	 * @var array
	 **/
	protected $onlyMimes = [];

	/**
	 * Store files moved or overwrited files info.
	 *
	 * @var array
	 **/
	protected $removed = [];

	/**
	 * Store files added files info.
	 *
	 * @var array
	 **/
	protected $added = [];

	/**
	 * Cache storage.
	 *
	 * @var array
	 **/
	protected $cache = [];

	/**
	 * Cache by folders.
	 *
	 * @var array
	 **/
	protected $dirsCache = [];

	/**
	 * You should use `$this->sessionCache['subdirs']` instead.
	 *
	 * @var array
	 * @deprecated
	 */
	protected $subdirsCache = [];

	/**
	 * This volume session cache.
	 *
	 * @var array
	 */
	protected $sessionCache;

	/**
	 * Session caching item list.
	 *
	 * @var array
	 */
	protected $sessionCaching = ['rootstat' => true, 'subdirs' => true];

	/**
	 * elFinder session wrapper object.
	 *
	 * @var elFinderSessionInterface
	 */
	protected $session;

	/**
	 * Search start time.
	 *
	 * @var int
	 */
	protected $searchStart;

	/**
	 * Current query word on doSearch.
	 *
	 * @var array
	 **/
	protected $doSearchCurrentQuery = [];

	/**
	 * Is root modified (for clear root stat cache).
	 *
	 * @var bool
	 */
	protected $rootModified = false;

	/**
	 * Is disable of command `url`.
	 *
	 * @var string
	 */
	protected $disabledGetUrl = false;

	/**
	 * Accepted filename validator.
	 *
	 * @var string | callable
	 */
	protected $nameValidator;

	/**
	 * Accepted dirname validator.
	 *
	 * @var string | callable
	 */
	protected $dirnameValidator;

	/**
	 * This request require online state.
	 *
	 * @var boolean
	 */
	protected $needOnline;

	/*                            INITIALIZATION                         */

	/**
	 * Sets the need online.
	 *
	 * @param  boolean  $state  The state
	 */
	public function setNeedOnline($state = null) {
		if ($state !== null) {
			$this->needOnline = (bool)$state;

			return;
		}

		$need = false;
		$arg  = $this->ARGS;
		$id   = $this->id;

		$target  = ! empty($arg['target']) ? $arg['target'] : (! empty($arg['dst']) ? $arg['dst'] : '');
		$targets = ! empty($arg['targets']) ? $arg['targets'] : [];

		if (! is_array($targets)) {
			$targets = [$targets];
		}

		if ($target && strpos($target, $id) === 0) {
			$need = true;
		} else {
			if ($targets) {
				foreach ($targets as $t) {
					if ($t && strpos($t, $id) === 0) {
						$need = true;

						break;
					}
				}
			}
		}

		$this->needOnline = $need;
	}

	/**
	 * Prepare driver before mount volume.
	 * Return true if volume is ready.
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 **/
	protected function init() {
		return true;
	}

	/**
	 * Configure after successfull mount.
	 * By default set thumbnails path and image manipulation library.
	 *
	 * @return void
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	protected function configure() {
		// set thumbnails path
		$path = $this->options['tmbPath'];

		if ($path) {
			if (! file_exists($path)) {
				if (mkdir($path)) {
					chmod($path, $this->options['tmbPathMode']);
				} else {
					$path = '';
				}
			}

			if (is_dir($path) && is_readable($path)) {
				$this->tmbPath         = $path;
				$this->tmbPathWritable = is_writable($path);
			}
		}
		// set resouce path
		if (! is_dir($this->options['resourcePath'])) {
			$this->options['resourcePath'] = dirname(__FILE__) . DIRECTORY_SEPARATOR . 'resources';
		}

		// set image manipulation library
		$type = preg_match('/^(imagick|gd|convert|auto|none)$/i', $this->options['imgLib'])
			? strtolower($this->options['imgLib'])
			: 'auto';

		if ($type === 'none') {
			$this->imgLib = '';
		} else {
			if (($type === 'imagick' || $type === 'auto') && extension_loaded('imagick')) {
				$this->imgLib = 'imagick';
			} else {
				if (($type === 'gd' || $type === 'auto') && function_exists('gd_info')) {
					$this->imgLib = 'gd';
				} else {
					$convertCache = 'imgLibConvert';

					if (($convertCmd = $this->session->get($convertCache, false)) !== false) {
						$this->imgLib = $convertCmd;
					} else {
						$this->imgLib = ($this->procExec(ELFINDER_CONVERT_PATH . ' -version') === 0) ? 'convert' : '';
						$this->session->set($convertCache, $this->imgLib);
					}
				}
			}

			if ($type !== 'auto' && $this->imgLib === '') {
				// fallback
				$this->imgLib = extension_loaded('imagick') ? 'imagick' : (function_exists('gd_info') ? 'gd' : '');
			}
		}

		// check video to img converter
		if (! empty($this->options['imgConverter']) && is_array($this->options['imgConverter'])) {
			foreach ($this->options['imgConverter'] as $_type => $_converter) {
				if (isset($_converter['func'])) {
					$this->imgConverter[strtolower($_type)] = $_converter;
				}
			}
		}

		if (! isset($this->imgConverter['video'])) {
			$videoLibCache = 'videoLib';

			if (($videoLibCmd = $this->session->get($videoLibCache, false)) === false) {
				$videoLibCmd = ($this->procExec(ELFINDER_FFMPEG_PATH . ' -version') === 0) ? 'ffmpeg' : '';
				$this->session->set($videoLibCache, $videoLibCmd);
			}

			if ($videoLibCmd) {
				$this->imgConverter['video'] = [
					'func'   => [$this, $videoLibCmd . 'ToImg'],
					'maxlen' => $this->options['tmbVideoConvLen'],
				];
			}
		}

		// check onetimeUrl
		if (strtolower($this->options['onetimeUrl']) === 'auto') {
			$this->options['onetimeUrl'] = elFinder::getStaticVar('commonTempPath') ? true : false;
		}

		// check archivers
		if (empty($this->archivers['create'])) {
			$this->disabled[] = 'archive';
		}

		if (empty($this->archivers['extract'])) {
			$this->disabled[] = 'extract';
		}
		$_arc = $this->getArchivers();

		if (empty($_arc['create'])) {
			$this->disabled[] = 'zipdl';
		}

		if ($this->options['maxArcFilesSize']) {
			$this->options['maxArcFilesSize'] = elFinder::getIniBytes('', $this->options['maxArcFilesSize']);
		}
		self::$maxArcFilesSize = $this->options['maxArcFilesSize'];

		// check 'statOwner' for command `chmod`
		if (empty($this->options['statOwner'])) {
			$this->disabled[] = 'chmod';
		}

		// check 'mimeMap'
		if (! is_array($this->options['mimeMap'])) {
			$this->options['mimeMap'] = [];
		}

		if (is_array($this->options['staticMineMap']) && $this->options['staticMineMap']) {
			$this->options['mimeMap'] = array_merge($this->options['mimeMap'], $this->options['staticMineMap']);
		}

		if (is_array($this->options['additionalMimeMap']) && $this->options['additionalMimeMap']) {
			$this->options['mimeMap'] = array_merge($this->options['mimeMap'], $this->options['additionalMimeMap']);
		}

		// check 'url' in disabled commands
		if (in_array('url', $this->disabled)) {
			$this->disabledGetUrl = true;
		}

		// set run time setting uploadOverwrite
		$this->uploadOverwrite = $this->options['uploadOverwrite'];
	}

	/**
	 * @deprecated
	 */
	protected function sessionRestart() {
		$this->sessionCache = $this->session->start()->get($this->id, []);

		return true;
	}

	/*                              PUBLIC API                           */

	/**
	 * Return driver id. Used as a part of volume id.
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	public function driverId() {
		return $this->driverId;
	}

	/**
	 * Return volume id.
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	public function id() {
		return $this->id;
	}

	/**
	 * Assign elFinder session wrapper object.
	 *
	 * @param  $session  elFinderSessionInterface
	 */
	public function setSession($session) {
		$this->session = $session;
	}

	/**
	 * Get elFinder sesson wrapper object.
	 *
	 * @return object  The session object
	 */
	public function getSession() {
		return $this->session;
	}

	/**
	 * Save session cache data
	 * Calls this function before umount this volume on elFinder::exec().
	 *
	 * @return void
	 */
	public function saveSessionCache() {
		$this->session->set($this->id, $this->sessionCache);
	}

	/**
	 * Return debug info for client.
	 *
	 * @return array
	 * @author Dmitry (dio) Levashov
	 **/
	public function debug() {
		return [
			'id'         => $this->id(),
			'name'       => strtolower(substr(get_class($this), strlen('elfinderdriver'))),
			'mimeDetect' => $this->mimeDetect,
			'imgLib'     => $this->imgLib,
		];
	}

	/**
	 * chmod a file or folder.
	 *
	 * @param  string $hash file or folder hash to chmod
	 * @param  string $mode octal string representing new permissions
	 *
	 * @return array|false
	 * @author David Bartle
	 **/
	public function chmod($hash, $mode) {
		if ($this->commandDisabled('chmod')) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		if (! ($file = $this->file($hash))) {
			return $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
		}

		if (! $this->options['allowChmodReadOnly']) {
			if (! $this->attr($this->decode($hash), 'write', null, ($file['mime'] === 'directory'))) {
				return $this->setError(elFinder::ERROR_PERM_DENIED, $file['name']);
			}
		}

		$path  = $this->decode($hash);
		$write = $file['write'];

		if ($this->convEncOut(! $this->_chmod($this->convEncIn($path), $mode))) {
			return $this->setError(elFinder::ERROR_PERM_DENIED, $file['name']);
		}

		$this->clearstatcache();

		if ($path == $this->root) {
			$this->rootModified = true;
		}

		if ($file = $this->stat($path)) {
			$files = [$file];

			if ($file['mime'] === 'directory' && $write !== $file['write']) {
				foreach ($this->getScandir($path) as $stat) {
					if ($this->mimeAccepted($stat['mime'])) {
						$files[] = $stat;
					}
				}
			}

			return $files;
		} else {
			return $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
		}
	}

	/**
	 * stat a file or folder for elFinder cmd exec.
	 *
	 * @param  string $hash file or folder hash to chmod
	 *
	 * @return array
	 * @author Naoki Sawada
	 **/
	public function fstat($hash) {
		$path = $this->decode($hash);

		return $this->stat($path);
	}

	/**
	 * Clear PHP stat cache & all of inner stat caches.
	 */
	public function clearstatcache() {
		clearstatcache();
		$this->clearcache();
	}

	/**
	 * Clear inner stat caches for target hash.
	 *
	 * @param string $hash
	 */
	public function clearcaches($hash = null) {
		if ($hash === null) {
			$this->clearcache();
		} else {
			$path = $this->decode($hash);
			unset($this->cache[$path], $this->dirsCache[$path]);
		}
	}

	/**
	 * "Mount" volume.
	 * Return true if volume available for read or write,
	 * false - otherwise.
	 *
	 * @param array $opts
	 *
	 * @return bool
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 * @author Alexey Sukhotin
	 */
	public function mount(array $opts) {
		$this->options = array_merge($this->options, $opts);

		if (! isset($this->options['path']) || $this->options['path'] === '') {
			return $this->setError('Path undefined.');
		}

		if (! $this->session) {
			return $this->setError('Session wrapper dose not set. Need to `$volume->setSession(elFinderSessionInterface);` before mount.');
		}

		if (! ($this->session instanceof elFinderSessionInterface)) {
			return $this->setError('Session wrapper instance must be "elFinderSessionInterface".');
		}

		// set driverId
		if (! empty($this->options['driverId'])) {
			$this->driverId = $this->options['driverId'];
		}

		$this->id        = $this->driverId . (! empty($this->options['id']) ? $this->options['id'] : elFinder::$volumesCnt++) . '_';
		$this->root      = $this->normpathCE($this->options['path']);
		$this->separator = $this->options['separator'] ?? DIRECTORY_SEPARATOR;

		if (! empty($this->options['winHashFix'])) {
			$this->separatorForHash = ($this->separator !== '/') ? '/' : '';
		}
		$this->systemRoot = $this->options['systemRoot'] ?? $this->separator;

		// set ARGS
		$this->ARGS = $_SERVER['REQUEST_METHOD'] === 'POST' ? $_POST : $_GET;

		$argInit = ! empty($this->ARGS['init']);

		// set $this->needOnline
		if (! is_bool($this->needOnline)) {
			$this->setNeedOnline();
		}

		// session cache
		if ($argInit) {
			$this->session->set($this->id, []);
		}
		$this->sessionCache = $this->session->get($this->id, []);

		// default file attribute
		$this->defaults = [
			'read'   => isset($this->options['defaults']['read']) ? ! ! $this->options['defaults']['read'] : true,
			'write'  => isset($this->options['defaults']['write']) ? ! ! $this->options['defaults']['write'] : true,
			'locked' => isset($this->options['defaults']['locked']) ? ! ! $this->options['defaults']['locked'] : false,
			'hidden' => isset($this->options['defaults']['hidden']) ? ! ! $this->options['defaults']['hidden'] : false,
		];

		// root attributes
		$this->attributes[] = [
			'pattern' => '~^' . preg_quote($this->separator) . '$~',
			'locked'  => true,
			'hidden'  => false,
		];
		// set files attributes
		if (! empty($this->options['attributes']) && is_array($this->options['attributes'])) {
			foreach ($this->options['attributes'] as $a) {
				// attributes must contain pattern and at least one rule
				if (! empty($a['pattern']) || (is_array($a) && count($a) > 1)) {
					$this->attributes[] = $a;
				}
			}
		}

		if (! empty($this->options['accessControl']) && is_callable($this->options['accessControl'])) {
			$this->access = $this->options['accessControl'];
		}

		$this->today     = mktime(0, 0, 0, date('m'), date('d'), date('Y'));
		$this->yesterday = $this->today - 86400;

		if (! $this->init()) {
			return false;
		}

		// set server encoding
		if (! empty($this->options['encoding']) && strtoupper($this->options['encoding']) !== 'UTF-8') {
			$this->encoding = $this->options['encoding'];
		} else {
			$this->encoding = null;
		}

		// check some options is arrays
		$this->uploadAllow = isset($this->options['uploadAllow']) && is_array($this->options['uploadAllow'])
			? $this->options['uploadAllow']
			: [];

		$this->uploadDeny = isset($this->options['uploadDeny']) && is_array($this->options['uploadDeny'])
			? $this->options['uploadDeny']
			: [];

		$this->options['uiCmdMap'] = (isset($this->options['uiCmdMap']) && is_array($this->options['uiCmdMap']))
			? $this->options['uiCmdMap']
			: [];

		if (is_string($this->options['uploadOrder'])) { // telephat_mode on, compatibility with 1.x
			$parts             = explode(',', $this->options['uploadOrder'] ?? 'deny,allow');
			$this->uploadOrder = [trim($parts[0]), trim($parts[1])];
		} else { // telephat_mode off
			$this->uploadOrder = ! empty($this->options['uploadOrder']) ? $this->options['uploadOrder'] : ['deny', 'allow'];
		}

		if (! empty($this->options['uploadMaxSize'])) {
			$this->uploadMaxSize = elFinder::getIniBytes('', $this->options['uploadMaxSize']);
		}
		// Set maximum to PHP_INT_MAX
		if (! defined('PHP_INT_MAX')) {
			define('PHP_INT_MAX', 2147483647);
		}

		if ($this->uploadMaxSize < 1 || $this->uploadMaxSize > PHP_INT_MAX) {
			$this->uploadMaxSize = PHP_INT_MAX;
		}

		// Set to get maximum size to 50% of memory_limit
		$memLimit = elFinder::getIniBytes('memory_limit') / 2;

		if ($memLimit > 0) {
			$this->getMaxSize = empty($this->options['getMaxSize']) ? $memLimit : min($memLimit, elFinder::getIniBytes('', $this->options['getMaxSize']));
		} else {
			$this->getMaxSize = -1;
		}

		$this->disabled = isset($this->options['disabled']) && is_array($this->options['disabled'])
			? array_values(array_diff($this->options['disabled'], ['open'])) // 'open' is required
			: [];

		$this->cryptLib   = $this->options['cryptLib'];
		$this->mimeDetect = $this->options['mimeDetect'];

		// find available mimetype detect method
		$regexp     = '/text\/x\-(php|c\+\+)/';
		$auto_types = [];

		if (class_exists('finfo', false)) {
			$tmpFileInfo = explode(';', finfo_file(finfo_open(FILEINFO_MIME), __FILE__));

			if ($tmpFileInfo && preg_match($regexp, array_shift($tmpFileInfo))) {
				$auto_types[] = 'finfo';
			}
		}

		if (function_exists('mime_content_type')) {
			$_mimetypes = explode(';', mime_content_type(__FILE__));

			if (preg_match($regexp, array_shift($_mimetypes))) {
				$auto_types[] = 'mime_content_type';
			}
		}

		$auto_types[] = 'internal';

		$type = strtolower($this->options['mimeDetect']);

		if (! in_array($type, $auto_types)) {
			$type = 'auto';
		}

		if ($type == 'auto') {
			$type = array_shift($auto_types);
		}

		$this->mimeDetect = $type;

		if ($this->mimeDetect == 'finfo') {
			$this->finfo = finfo_open(FILEINFO_MIME);
		} else {
			if ($this->mimeDetect == 'internal' && ! elFinderVolumeDriver::$mimetypesLoaded) {
				// load mimes from external file for mimeDetect == 'internal'
				// based on Alexey Sukhotin idea and patch: http://elrte.org/redmine/issues/163
				// file must be in file directory or in parent one
				elFinderVolumeDriver::loadMimeTypes(! empty($this->options['mimefile']) ? $this->options['mimefile'] : '');
			}
		}
		$this->rootName = empty($this->options['alias']) ? $this->basenameCE($this->root) : $this->options['alias'];

		// This get's triggered if $this->root == '/' and alias is empty.
		// Maybe modify _basename instead?
		if ($this->rootName === '') {
			$this->rootName = $this->separator;
		}

		$this->_checkArchivers();

		$root = $this->stat($this->root);

		if (! $root) {
			return $this->setError('Root folder does not exist.');
		}

		if (! $root['read'] && ! $root['write']) {
			return $this->setError('Root folder has not read and write permissions.');
		}

		if ($root['read']) {
			if ($argInit) {
				// check startPath - path to open by default instead of root
				$startPath = $this->options['startPath'] ? $this->normpathCE($this->options['startPath']) : '';

				if ($startPath) {
					$start = $this->stat($startPath);

					if (! empty($start)
						&& $start['mime'] == 'directory'
						&& $start['read']
						&& empty($start['hidden'])
						&& $this->inpathCE($startPath, $this->root)) {
						$this->startPath = $startPath;

						if (substr($this->startPath, -1, 1) == $this->options['separator']) {
							$this->startPath = substr($this->startPath, 0, -1);
						}
					}
				}
			}
		} else {
			$this->options['URL']     = '';
			$this->options['tmbURL']  = '';
			$this->options['tmbPath'] = '';
			// read only volume
			array_unshift($this->attributes, [
				'pattern' => '/.*/',
				'read'    => false,
			]);
		}
		$this->treeDeep = $this->options['treeDeep'] > 0 ? (int)$this->options['treeDeep'] : 1;
		$this->tmbSize  = $this->options['tmbSize'] > 0 ? (int)$this->options['tmbSize'] : 48;
		$this->URL      = $this->options['URL'];

		if ($this->URL && preg_match('|[^/?&=]$|', $this->URL)) {
			$this->URL .= '/';
		}

		$dirUrlOwn = strtolower($this->options['dirUrlOwn']);

		if ($dirUrlOwn === 'auto') {
			$this->options['dirUrlOwn'] = $this->URL ? false : true;
		} else {
			if ($dirUrlOwn === 'hide') {
				$this->options['dirUrlOwn'] = 'hide';
			} else {
				$this->options['dirUrlOwn'] = (bool)$this->options['dirUrlOwn'];
			}
		}

		$this->tmbURL = ! empty($this->options['tmbURL']) ? $this->options['tmbURL'] : '';

		if ($this->tmbURL && $this->tmbURL !== 'self' && preg_match('|[^/?&=]$|', $this->tmbURL)) {
			$this->tmbURL .= '/';
		}

		$this->nameValidator = ! empty($this->options['acceptedName']) && (is_string($this->options['acceptedName']) || is_callable($this->options['acceptedName']))
			? $this->options['acceptedName']
			: '';

		$this->dirnameValidator = ! empty($this->options['acceptedDirname']) && (is_callable($this->options['acceptedDirname']) || (is_string($this->options['acceptedDirname']) && preg_match($this->options['acceptedDirname'], '') !== false))
			? $this->options['acceptedDirname']
			: $this->nameValidator;

		// enabling archivers['create'] with options['useRemoteArchive']
		if ($this->options['useRemoteArchive'] && empty($this->archivers['create']) && $this->getTempPath()) {
			$_archivers                = $this->getArchivers();
			$this->archivers['create'] = $_archivers['create'];
		}

		// manual control archive types to create
		if (! empty($this->options['archiveMimes']) && is_array($this->options['archiveMimes'])) {
			foreach ($this->archivers['create'] as $mime => $v) {
				if (! in_array($mime, $this->options['archiveMimes'])) {
					unset($this->archivers['create'][$mime]);
				}
			}
		}

		// manualy add archivers
		if (! empty($this->options['archivers']['create']) && is_array($this->options['archivers']['create'])) {
			foreach ($this->options['archivers']['create'] as $mime => $conf) {
				if (strpos($mime, 'application/') === 0
					&& ! empty($conf['cmd'])
					&& isset($conf['argc'])
					&& ! empty($conf['ext'])
					&& ! isset($this->archivers['create'][$mime])) {
					$this->archivers['create'][$mime] = $conf;
				}
			}
		}

		if (! empty($this->options['archivers']['extract']) && is_array($this->options['archivers']['extract'])) {
			foreach ($this->options['archivers']['extract'] as $mime => $conf) {
				if (strpos($mime, 'application/') === 0
					&& ! empty($conf['cmd'])
					&& isset($conf['argc'])
					&& ! empty($conf['ext'])
					&& ! isset($this->archivers['extract'][$mime])) {
					$this->archivers['extract'][$mime] = $conf;
				}
			}
		}

		if (! empty($this->options['noSessionCache']) && is_array($this->options['noSessionCache'])) {
			foreach ($this->options['noSessionCache'] as $_key) {
				$this->sessionCaching[$_key] = false;
				unset($this->sessionCache[$_key]);
			}
		}

		if ($this->sessionCaching['subdirs']) {
			if (! isset($this->sessionCache['subdirs'])) {
				$this->sessionCache['subdirs'] = [];
			}
		}

		$this->configure();

		// Normalize disabled (array_merge`for type array of JSON)
		$this->disabled = array_values(array_unique($this->disabled));

		// fix sync interval
		if ($this->options['syncMinMs'] !== 0) {
			$this->options['syncMinMs'] = max($this->options[$this->options['syncChkAsTs'] ? 'tsPlSleep' : 'lsPlSleep'] * 1000, intval($this->options['syncMinMs']));
		}

		// ` copyJoin` is required for the trash function
		if ($this->options['trashHash'] && empty($this->options['copyJoin'])) {
			$this->options['trashHash'] = '';
		}

		// set tmpLinkPath
		if (elFinder::$tmpLinkPath && ! $this->options['tmpLinkPath']) {
			if (is_writeable(elFinder::$tmpLinkPath)) {
				$this->options['tmpLinkPath'] = elFinder::$tmpLinkPath;
			} else {
				elFinder::$tmpLinkPath = '';
			}
		}

		if ($this->options['tmpLinkPath'] && is_writable($this->options['tmpLinkPath'])) {
			$this->tmpLinkPath = realpath($this->options['tmpLinkPath']);
		} else {
			if (! $this->tmpLinkPath && $this->tmbURL && $this->tmbPath) {
				$this->tmpLinkPath           = $this->tmbPath;
				$this->options['tmpLinkUrl'] = $this->tmbURL;
			} else {
				if (! $this->options['URL'] && is_writable('../files/.tmb')) {
					$this->tmpLinkPath           = realpath('../files/.tmb');
					$this->options['tmpLinkUrl'] = '';

					if (! elFinder::$tmpLinkPath) {
						elFinder::$tmpLinkPath = $this->tmpLinkPath;
						elFinder::$tmpLinkUrl  = '';
					}
				}
			}
		}

		// set tmpLinkUrl
		if (elFinder::$tmpLinkUrl && ! $this->options['tmpLinkUrl']) {
			$this->options['tmpLinkUrl'] = elFinder::$tmpLinkUrl;
		}

		if ($this->options['tmpLinkUrl']) {
			$this->tmpLinkUrl = $this->options['tmpLinkUrl'];
		}

		if ($this->tmpLinkPath && ! $this->tmpLinkUrl) {
			$cur = realpath('./');
			$i   = 0;

			while ($cur !== $this->systemRoot && strpos($this->tmpLinkPath, $cur) !== 0) {
				$i++;
				$cur = dirname($cur);
			}
			list($req)        = explode('?', $_SERVER['REQUEST_URI']);
			$reqs             = explode('/', dirname($req));
			$uri              = join('/', array_slice($reqs, 0, count($reqs) - 1)) . substr($this->tmpLinkPath, strlen($cur));
			$https            = (isset($_SERVER['HTTPS']) && strtolower($_SERVER['HTTPS']) !== 'off');
			$this->tmpLinkUrl = ($https ? 'https://' : 'http://')
				. $_SERVER['SERVER_NAME'] // host
				. (((! $https && $_SERVER['SERVER_PORT'] == 80) || ($https && $_SERVER['SERVER_PORT'] == 443)) ? '' : (':' . $_SERVER['SERVER_PORT']))  // port
				. $uri;

			if (! elFinder::$tmpLinkUrl) {
				elFinder::$tmpLinkUrl = $this->tmpLinkUrl;
			}
		}

		// remove last '/'
		if ($this->tmpLinkPath) {
			$this->tmpLinkPath = rtrim($this->tmpLinkPath, '/');
		}

		if ($this->tmpLinkUrl) {
			$this->tmpLinkUrl = rtrim($this->tmpLinkUrl, '/');
		}

		// to update options cache
		if (isset($this->sessionCache['rootstat'])) {
			unset($this->sessionCache['rootstat'][$this->getRootstatCachekey()]);
		}
		$this->updateCache($this->root, $root);

		return $this->mounted = true;
	}

	/**
	 * Some "unmount" stuffs - may be required by virtual fs.
	 *
	 * @return void
	 * @author Dmitry (dio) Levashov
	 **/
	public function umount() {
	}

	/**
	 * Remove session cache of this volume.
	 */
	public function clearSessionCache() {
		$this->sessionCache = [];
	}

	/**
	 * Return error message from last failed action.
	 *
	 * @return array
	 * @author Dmitry (dio) Levashov
	 **/
	public function error() {
		return $this->error;
	}

	/**
	 * Return is uploadable that given file name.
	 *
	 * @param  string $name file name
	 * @param  bool   $allowUnknown
	 *
	 * @return bool
	 * @author Naoki Sawada
	 **/
	public function isUploadableByName($name, $allowUnknown = false) {
		$mimeByName = $this->mimetype($name, true);

		return (($allowUnknown && $mimeByName === 'unknown') || $this->allowPutMime($mimeByName));
	}

	/**
	 * Return Extention/MIME Table (elFinderVolumeDriver::$mimetypes).
	 *
	 * @return array
	 * @author Naoki Sawada
	 */
	public function getMimeTable() {
		// load mime.types
		if (! elFinderVolumeDriver::$mimetypesLoaded) {
			elFinderVolumeDriver::loadMimeTypes();
		}

		return elFinderVolumeDriver::$mimetypes;
	}

	/**
	 * Return file extention detected by MIME type.
	 *
	 * @param  string $mime   MIME type
	 * @param  string $suffix Additional suffix
	 *
	 * @return string
	 * @author Naoki Sawada
	 */
	public function getExtentionByMime($mime, $suffix = '') {
		static $extTable = null;

		if (is_null($extTable)) {
			$extTable = array_flip(array_unique($this->getMimeTable()));

			foreach ($this->options['mimeMap'] as $pair => $_mime) {
				list($ext) = explode(':', $pair);

				if ($ext !== '*' && ! isset($extTable[$_mime])) {
					$extTable[$_mime] = $ext;
				}
			}
		}

		if ($mime && isset($extTable[$mime])) {
			return $suffix ? ($extTable[$mime] . $suffix) : $extTable[$mime];
		}

		return '';
	}

	/**
	 * Set mimetypes allowed to display to client.
	 *
	 * @param  array $mimes
	 *
	 * @return void
	 * @author Dmitry (dio) Levashov
	 **/
	public function setMimesFilter($mimes) {
		if (is_array($mimes)) {
			$this->onlyMimes = $mimes;
		}
	}

	/**
	 * Return root folder hash.
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	public function root() {
		return $this->encode($this->root);
	}

	/**
	 * Return root path.
	 *
	 * @return string
	 * @author Naoki Sawada
	 **/
	public function getRootPath() {
		return $this->root;
	}

	/**
	 * Return target path hash.
	 *
	 * @param  string $path
	 * @param  string $name
	 *
	 * @author Naoki Sawada
	 * @return string
	 */
	public function getHash($path, $name = '') {
		if ($name !== '') {
			$path = $this->joinPathCE($path, $name);
		}

		return $this->encode($path);
	}

	/**
	 * Return decoded path of target hash
	 * This method do not check the stat of target
	 * Use method `realpath()` to do check of the stat of target.
	 *
	 * @param  string $hash
	 *
	 * @author Naoki Sawada
	 * @return string
	 */
	public function getPath($hash) {
		return $this->decode($hash);
	}

	/**
	 * Return root or startPath hash.
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	public function defaultPath() {
		return $this->encode($this->startPath ? $this->startPath : $this->root);
	}

	/**
	 * Return volume options required by client:.
	 *
	 * @param $hash
	 *
	 * @return array
	 * @author Dmitry (dio) Levashov
	 */
	public function options($hash) {
		$create = $createext = [];

		if (isset($this->archivers['create']) && is_array($this->archivers['create'])) {
			foreach ($this->archivers['create'] as $m => $v) {
				$create[]      = $m;
				$createext[$m] = $v['ext'];
			}
		}
		$opts = [
			'path'            => $hash ? $this->path($hash) : '',
			'url'             => $this->URL,
			'tmbUrl'          => (! $this->imgLib && $this->options['tmbFbSelf']) ? 'self' : $this->tmbURL,
			'disabled'        => $this->disabled,
			'separator'       => $this->separator,
			'copyOverwrite'   => intval($this->options['copyOverwrite']),
			'uploadOverwrite' => intval($this->options['uploadOverwrite']),
			'uploadMaxSize'   => intval($this->uploadMaxSize),
			'uploadMaxConn'   => intval($this->options['uploadMaxConn']),
			'uploadMime'      => [
				'firstOrder' => $this->uploadOrder[0] ?? 'deny',
				'allow'      => $this->uploadAllow,
				'deny'       => $this->uploadDeny,
			],
			'dispInlineRegex' => $this->options['dispInlineRegex'],
			'jpgQuality'      => intval($this->options['jpgQuality']),
			'archivers'       => [
				'create'    => $create,
				'extract'   => isset($this->archivers['extract']) && is_array($this->archivers['extract']) ? array_keys($this->archivers['extract']) : [],
				'createext' => $createext,
			],
			'uiCmdMap'         => (isset($this->options['uiCmdMap']) && is_array($this->options['uiCmdMap'])) ? $this->options['uiCmdMap'] : [],
			'syncChkAsTs'      => intval($this->options['syncChkAsTs']),
			'syncMinMs'        => intval($this->options['syncMinMs']),
			'i18nFolderName'   => intval($this->options['i18nFolderName']),
			'tmbCrop'          => intval($this->options['tmbCrop']),
			'tmbReqCustomData' => (bool)$this->options['tmbReqCustomData'],
			'substituteImg'    => (bool)$this->options['substituteImg'],
			'onetimeUrl'       => (bool)$this->options['onetimeUrl'],
		];

		if (! empty($this->options['trashHash'])) {
			$opts['trashHash'] = $this->options['trashHash'];
		}

		if ($hash === null) {
			// call from getRootStatExtra()
			if (! empty($this->options['icon'])) {
				$opts['icon'] = $this->options['icon'];
			}

			if (! empty($this->options['rootCssClass'])) {
				$opts['csscls'] = $this->options['rootCssClass'];
			}

			if (isset($this->options['netkey'])) {
				$opts['netkey'] = $this->options['netkey'];
			}
		}

		return $opts;
	}

	/**
	 * Get option value of this volume.
	 *
	 * @param string $name target option name
	 *
	 * @return NULL|mixed   target option value
	 * @author Naoki Sawada
	 */
	public function getOption($name) {
		return $this->options[$name] ?? null;
	}

	/**
	 * Get plugin values of this options.
	 *
	 * @param string $name Plugin name
	 *
	 * @return NULL|array   Plugin values
	 * @author Naoki Sawada
	 */
	public function getOptionsPlugin($name = '') {
		if ($name) {
			return $this->options['plugin'][$name] ?? [];
		} else {
			return $this->options['plugin'];
		}
	}

	/**
	 * Return true if command disabled in options.
	 *
	 * @param  string $cmd command name
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 **/
	public function commandDisabled($cmd) {
		return in_array($cmd, $this->disabled);
	}

	/**
	 * Return true if mime is required mimes list.
	 *
	 * @param  string    $mime  mime type to check
	 * @param  array     $mimes allowed mime types list or not set to use client mimes list
	 * @param  bool|null $empty what to return on empty list
	 *
	 * @return bool|null
	 * @author Dmitry (dio) Levashov
	 * @author Troex Nevelin
	 **/
	public function mimeAccepted($mime, $mimes = null, $empty = true) {
		$mimes = is_array($mimes) ? $mimes : $this->onlyMimes;

		if (empty($mimes)) {
			return $empty;
		}

		return $mime == 'directory'
			|| in_array('all', $mimes)
			|| in_array('All', $mimes)
			|| in_array($mime, $mimes)
			|| in_array(substr($mime, 0, strpos($mime, '/')), $mimes);
	}

	/**
	 * Return true if voume is readable.
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 **/
	public function isReadable() {
		$stat = $this->stat($this->root);

		return $stat['read'];
	}

	/**
	 * Return true if copy from this volume allowed.
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 **/
	public function copyFromAllowed() {
		return ! ! $this->options['copyFrom'];
	}

	/**
	 * Return file path related to root with convert encoging.
	 *
	 * @param  string $hash file hash
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	public function path($hash) {
		return $this->convEncOut($this->_path($this->convEncIn($this->decode($hash))));
	}

	/**
	 * Return file real path if file exists.
	 *
	 * @param  string $hash file hash
	 *
	 * @return string | false
	 * @author Dmitry (dio) Levashov
	 **/
	public function realpath($hash) {
		$path = $this->decode($hash);

		return $this->stat($path) ? $path : false;
	}

	/**
	 * Return list of moved/overwrited files.
	 *
	 * @return array
	 * @author Dmitry (dio) Levashov
	 **/
	public function removed() {
		if ($this->removed) {
			$unsetSubdir = isset($this->sessionCache['subdirs']) ? true : false;

			foreach ($this->removed as $item) {
				if ($item['mime'] === 'directory') {
					$path = $this->decode($item['hash']);

					if ($unsetSubdir) {
						unset($this->sessionCache['subdirs'][$path]);
					}

					if ($item['phash'] !== '') {
						$parent = $this->decode($item['phash']);
						unset($this->cache[$parent]);

						if ($this->root === $parent) {
							$this->sessionCache['rootstat'] = [];
						}

						if ($unsetSubdir) {
							unset($this->sessionCache['subdirs'][$parent]);
						}
					}
				}
			}
			$this->removed = array_values($this->removed);
		}

		return $this->removed;
	}

	/**
	 * Return list of added files.
	 *
	 * @deprecated
	 * @return array
	 * @author Naoki Sawada
	 **/
	public function added() {
		return $this->added;
	}

	/**
	 * Clean removed files list.
	 *
	 * @return void
	 * @author Dmitry (dio) Levashov
	 **/
	public function resetRemoved() {
		$this->resetResultStat();
	}

	/**
	 * Clean added/removed files list.
	 *
	 * @return void
	 **/
	public function resetResultStat() {
		$this->removed = [];
		$this->added   = [];
	}

	/**
	 * Return file/dir hash or first founded child hash with required attr == $val.
	 *
	 * @param  string $hash file hash
	 * @param  string $attr attribute name
	 * @param  bool   $val  attribute value
	 *
	 * @return string|false
	 * @author Dmitry (dio) Levashov
	 **/
	public function closest($hash, $attr, $val) {
		return ($path = $this->closestByAttr($this->decode($hash), $attr, $val)) ? $this->encode($path) : false;
	}

	/**
	 * Return file info or false on error.
	 *
	 * @param  string $hash file hash
	 *
	 * @return array|false
	 * @internal param bool $realpath add realpath field to file info
	 * @author   Dmitry (dio) Levashov
	 */
	public function file($hash) {
		$file = $this->stat($this->decode($hash));

		return ($file) ? $file : $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
	}

	/**
	 * Return folder info.
	 *
	 * @param  string $hash folder hash
	 * @param bool    $resolveLink
	 *
	 * @return array|false
	 * @internal param bool $hidden return hidden file info
	 * @author   Dmitry (dio) Levashov
	 */
	public function dir($hash, $resolveLink = false) {
		if (($dir = $this->file($hash)) == false) {
			return $this->setError(elFinder::ERROR_DIR_NOT_FOUND);
		}

		if ($resolveLink && ! empty($dir['thash'])) {
			$dir = $this->file($dir['thash']);
		}

		return $dir && $dir['mime'] == 'directory' && empty($dir['hidden'])
			? $dir
			: $this->setError(elFinder::ERROR_NOT_DIR);
	}

	/**
	 * Return directory content or false on error.
	 *
	 * @param  string $hash file hash
	 *
	 * @return array|false
	 * @author Dmitry (dio) Levashov
	 **/
	public function scandir($hash) {
		if (($dir = $this->dir($hash)) == false) {
			return false;
		}

		$path = $this->decode($hash);

		if ($res = $dir['read']
			? $this->getScandir($path)
			: $this->setError(elFinder::ERROR_PERM_DENIED)) {
			$dirs = null;

			if ($this->sessionCaching['subdirs'] && isset($this->sessionCache['subdirs'][$path])) {
				$dirs = $this->sessionCache['subdirs'][$path];
			}

			if ($dirs !== null || (isset($dir['dirs']) && $dir['dirs'] != 1)) {
				$_dir = $dir;

				if ($dirs || $this->subdirs($hash)) {
					$dir['dirs'] = 1;
				} else {
					unset($dir['dirs']);
				}

				if ($dir !== $_dir) {
					$this->updateCache($path, $dir);
				}
			}
		}

		return $res;
	}

	/**
	 * Return dir files names list.
	 *
	 * @param  string $hash file hash
	 * @param null    $intersect
	 *
	 * @return array|false
	 * @author Dmitry (dio) Levashov
	 */
	public function ls($hash, $intersect = null) {
		if (($dir = $this->dir($hash)) == false || ! $dir['read']) {
			return false;
		}

		$list = [];
		$path = $this->decode($hash);

		$check = [];

		if ($intersect) {
			$check = array_flip($intersect);
		}

		foreach ($this->getScandir($path) as $stat) {
			if (empty($stat['hidden']) && (! $check || isset($check[$stat['name']])) && $this->mimeAccepted($stat['mime'])) {
				$list[$stat['hash']] = $stat['name'];
			}
		}

		return $list;
	}

	/**
	 * Return subfolders for required folder or false on error.
	 *
	 * @param  string $hash    folder hash or empty string to get tree from root folder
	 * @param  int    $deep    subdir deep
	 * @param  string $exclude dir hash which subfolders must be exluded from result, required to not get stat twice on cwd subfolders
	 *
	 * @return array|false
	 * @author Dmitry (dio) Levashov
	 **/
	public function tree($hash = '', $deep = 0, $exclude = '') {
		$path = $hash ? $this->decode($hash) : $this->root;

		if (($dir = $this->stat($path)) == false || $dir['mime'] != 'directory') {
			return false;
		}

		$dirs = $this->gettree($path, $deep > 0 ? $deep - 1 : $this->treeDeep - 1, $exclude ? $this->decode($exclude) : null);
		array_unshift($dirs, $dir);

		return $dirs;
	}

	/**
	 * Return part of dirs tree from required dir up to root dir.
	 *
	 * @param  string    $hash   directory hash
	 * @param  bool|null $lineal only lineal parents
	 *
	 * @return array|false
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	public function parents($hash, $lineal = false) {
		if (($current = $this->dir($hash)) == false) {
			return false;
		}

		$args = func_get_args();
		// checks 3rd param `$until` (elFinder >= 2.1.24)
		$until = '';

		if (isset($args[2])) {
			$until = $args[2];
		}

		$path = $this->decode($hash);
		$tree = [];

		while ($path && $path != $this->root) {
			elFinder::checkAborted();
			$path = $this->dirnameCE($path);

			if (! ($stat = $this->stat($path)) || ! empty($stat['hidden']) || ! $stat['read']) {
				return false;
			}

			array_unshift($tree, $stat);

			if (! $lineal) {
				foreach ($this->gettree($path, 0) as $dir) {
					elFinder::checkAborted();

					if (! isset($tree[$dir['hash']])) {
						$tree[$dir['hash']] = $dir;
					}
				}
			}

			if ($until && $until === $this->encode($path)) {
				break;
			}
		}

		return $tree ? array_values($tree) : [$current];
	}

	/**
	 * Create thumbnail for required file and return its name or false on failed.
	 *
	 * @param $hash
	 *
	 * @return false|string
	 * @throws ImagickException
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	public function tmb($hash) {
		$path = $this->decode($hash);
		$stat = $this->stat($path);

		if (isset($stat['tmb'])) {
			$res = $stat['tmb'] == '1' ? $this->createTmb($path, $stat) : $stat['tmb'];

			if (! $res) {
				list($type) = explode('/', $stat['mime']);
				$fallback   = $this->options['resourcePath'] . DIRECTORY_SEPARATOR . strtolower($type) . '.png';

				if (is_file($fallback)) {
					$res = $this->tmbname($stat);

					if (! copy($fallback, $this->tmbPath . DIRECTORY_SEPARATOR . $res)) {
						$res = false;
					}
				}
			}
			// tmb garbage collection
			if ($res && $this->options['tmbGcMaxlifeHour'] && $this->options['tmbGcPercentage'] > 0) {
				$rand = mt_rand(1, 10000);

				if ($rand <= $this->options['tmbGcPercentage'] * 100) {
					register_shutdown_function(['elFinder', 'GlobGC'], $this->tmbPath . DIRECTORY_SEPARATOR . '*.png', $this->options['tmbGcMaxlifeHour'] * 3600);
				}
			}

			return $res;
		}

		return false;
	}

	/**
	 * Return file size / total directory size.
	 *
	 * @param  string   file hash
	 * @param mixed $hash
	 *
	 * @return array
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	public function size($hash) {
		return $this->countSize($this->decode($hash));
	}

	/**
	 * Open file for reading and return file pointer.
	 *
	 * @param  string   file hash
	 * @param mixed $hash
	 *
	 * @return Resource|false
	 * @author Dmitry (dio) Levashov
	 **/
	public function open($hash) {
		if (($file = $this->file($hash)) == false
			|| $file['mime'] == 'directory') {
			return false;
		}
		// check extra option for network stream pointer
		if (func_num_args() > 1) {
			$opts = func_get_arg(1);
		} else {
			$opts = [];
		}

		return $this->fopenCE($this->decode($hash), 'rb', $opts);
	}

	/**
	 * Close file pointer.
	 *
	 * @param  Resource $fp   file pointer
	 * @param  string   $hash file hash
	 *
	 * @return void
	 * @author Dmitry (dio) Levashov
	 **/
	public function close($fp, $hash) {
		$this->fcloseCE($fp, $this->decode($hash));
	}

	/**
	 * Create directory and return dir info.
	 *
	 * @param  string $dsthash destination directory hash
	 * @param  string $name    directory name
	 *
	 * @return array|false
	 * @author Dmitry (dio) Levashov
	 **/
	public function mkdir($dsthash, $name) {
		if ($this->commandDisabled('mkdir')) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		if (! $this->nameAccepted($name, true)) {
			return $this->setError(elFinder::ERROR_INVALID_DIRNAME);
		}

		if (($dir = $this->dir($dsthash)) == false) {
			return $this->setError(elFinder::ERROR_TRGDIR_NOT_FOUND, '#' . $dsthash);
		}

		$path = $this->decode($dsthash);

		if (! $dir['write'] || ! $this->allowCreate($path, $name, true)) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		$dst  = $this->joinPathCE($path, $name);
		$stat = $this->isNameExists($dst);

		if (! empty($stat)) {
			return $this->setError(elFinder::ERROR_EXISTS, $name);
		}
		$this->clearcache();

		$mkpath = $this->convEncOut($this->_mkdir($this->convEncIn($path), $this->convEncIn($name)));

		if ($mkpath) {
			$this->clearstatcache();
			$this->updateSubdirsCache($path, true);
			$this->updateSubdirsCache($mkpath, false);
		}

		return $mkpath ? $this->stat($mkpath) : false;
	}

	/**
	 * Create empty file and return its info.
	 *
	 * @param  string $dst  destination directory
	 * @param  string $name file name
	 *
	 * @return array|false
	 * @author Dmitry (dio) Levashov
	 **/
	public function mkfile($dst, $name) {
		if ($this->commandDisabled('mkfile')) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		if (! $this->nameAccepted($name, false)) {
			return $this->setError(elFinder::ERROR_INVALID_NAME);
		}

		$mimeByName = $this->mimetype($name, true);

		if ($mimeByName && ! $this->allowPutMime($mimeByName)) {
			return $this->setError(elFinder::ERROR_UPLOAD_FILE_MIME, $name);
		}

		if (($dir = $this->dir($dst)) == false) {
			return $this->setError(elFinder::ERROR_TRGDIR_NOT_FOUND, '#' . $dst);
		}

		$path = $this->decode($dst);

		if (! $dir['write'] || ! $this->allowCreate($path, $name, false)) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		if ($this->isNameExists($this->joinPathCE($path, $name))) {
			return $this->setError(elFinder::ERROR_EXISTS, $name);
		}

		$this->clearcache();
		$res = false;

		if ($path = $this->convEncOut($this->_mkfile($this->convEncIn($path), $this->convEncIn($name)))) {
			$this->clearstatcache();
			$res = $this->stat($path);
		}

		return $res;
	}

	/**
	 * Rename file and return file info.
	 *
	 * @param  string $hash file hash
	 * @param  string $name new file name
	 *
	 * @return array|false
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	public function rename($hash, $name) {
		if ($this->commandDisabled('rename')) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		if (! ($file = $this->file($hash))) {
			return $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
		}

		if ($name === $file['name']) {
			return $file;
		}

		if (! empty($this->options['netkey']) && ! empty($file['isroot'])) {
			// change alias of netmount root
			$rootKey = $this->getRootstatCachekey();
			// delete old cache data
			if ($this->sessionCaching['rootstat']) {
				unset($this->sessionCaching['rootstat'][$rootKey]);
			}

			if (elFinder::$instance->updateNetVolumeOption($this->options['netkey'], 'alias', $name)) {
				$this->clearcache();
				$this->rootName = $this->options['alias'] = $name;

				return $this->stat($this->root);
			} else {
				return $this->setError(elFinder::ERROR_TRGDIR_NOT_FOUND, $name);
			}
		}

		if (! empty($file['locked'])) {
			return $this->setError(elFinder::ERROR_LOCKED, $file['name']);
		}

		$isDir = ($file['mime'] === 'directory');

		if (! $this->nameAccepted($name, $isDir)) {
			return $this->setError($isDir ? elFinder::ERROR_INVALID_DIRNAME : elFinder::ERROR_INVALID_NAME);
		}

		if (! $isDir) {
			$mimeByName = $this->mimetype($name, true);

			if ($mimeByName && ! $this->allowPutMime($mimeByName)) {
				return $this->setError(elFinder::ERROR_UPLOAD_FILE_MIME, $name);
			}
		}

		$path = $this->decode($hash);
		$dir  = $this->dirnameCE($path);
		$stat = $this->isNameExists($this->joinPathCE($dir, $name));

		if ($stat) {
			return $this->setError(elFinder::ERROR_EXISTS, $name);
		}

		if (! $this->allowCreate($dir, $name, ($file['mime'] === 'directory'))) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		$this->rmTmb($file); // remove old name tmbs, we cannot do this after dir move

		if ($path = $this->convEncOut($this->_move($this->convEncIn($path), $this->convEncIn($dir), $this->convEncIn($name)))) {
			$this->clearcache();

			return $this->stat($path);
		}

		return false;
	}

	/**
	 * Create file copy with suffix "copy number" and return its info.
	 *
	 * @param  string $hash   file hash
	 * @param  string $suffix suffix to add to file name
	 *
	 * @return array|false
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	public function duplicate($hash, $suffix = 'copy') {
		if ($this->commandDisabled('duplicate')) {
			return $this->setError(elFinder::ERROR_COPY, '#' . $hash, elFinder::ERROR_PERM_DENIED);
		}

		if (($file = $this->file($hash)) == false) {
			return $this->setError(elFinder::ERROR_COPY, elFinder::ERROR_FILE_NOT_FOUND);
		}

		$path = $this->decode($hash);
		$dir  = $this->dirnameCE($path);
		$name = $this->uniqueName($dir, $file['name'], sprintf($this->options['duplicateSuffix'], $suffix));

		if (! $this->allowCreate($dir, $name, ($file['mime'] === 'directory'))) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		return ($path = $this->copy($path, $dir, $name)) == false
			? false
			: $this->stat($path);
	}

	/**
	 * Save uploaded file.
	 * On success return array with new file stat and with removed file hash (if existed file was replaced).
	 *
	 * @param  Resource $fp      file pointer
	 * @param  string   $dst     destination folder hash
	 * @param           $name
	 * @param  string   $tmpname file tmp name - required to detect mime type
	 * @param  array    $hashes  exists files hash array with filename as key
	 *
	 * @return array|false
	 * @throws elFinderAbortException
	 * @internal param string $src file name
	 * @author   Dmitry (dio) Levashov
	 */
	public function upload($fp, $dst, $name, $tmpname, $hashes = []) {
		if ($this->commandDisabled('upload')) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		if (($dir = $this->dir($dst)) == false) {
			return $this->setError(elFinder::ERROR_TRGDIR_NOT_FOUND, '#' . $dst);
		}

		if (empty($dir['write'])) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		if (! $this->nameAccepted($name, false)) {
			return $this->setError(elFinder::ERROR_INVALID_NAME);
		}

		$mimeByName = '';

		if ($this->mimeDetect === 'internal') {
			$mime = $this->mimetype($tmpname, $name);
		} else {
			$mime       = $this->mimetype($tmpname, $name);
			$mimeByName = $this->mimetype($name, true);

			if ($mime === 'unknown') {
				$mime = $mimeByName;
			}
		}

		if (! $this->allowPutMime($mime) || ($mimeByName && ! $this->allowPutMime($mimeByName))) {
			return $this->setError(elFinder::ERROR_UPLOAD_FILE_MIME, '(' . $mime . ')');
		}

		$tmpsize = (int)sprintf('%u', filesize($tmpname));

		if ($this->uploadMaxSize > 0 && $tmpsize > $this->uploadMaxSize) {
			return $this->setError(elFinder::ERROR_UPLOAD_FILE_SIZE);
		}

		$dstpath = $this->decode($dst);

		if (isset($hashes[$name])) {
			$test = $this->decode($hashes[$name]);
			$file = $this->stat($test);
		} else {
			$test = $this->joinPathCE($dstpath, $name);
			$file = $this->isNameExists($test);
		}

		$this->clearcache();

		if ($file && $file['name'] === $name) { // file exists and check filename for item ID based filesystem
			if ($this->uploadOverwrite) {
				if (! $file['write']) {
					return $this->setError(elFinder::ERROR_PERM_DENIED);
				} elseif ($file['mime'] == 'directory') {
					return $this->setError(elFinder::ERROR_NOT_REPLACE, $name);
				}
				$this->remove($test);
			} else {
				$name = $this->uniqueName($dstpath, $name, '-', false);
			}
		}

		$stat = [
			'mime'   => $mime,
			'width'  => 0,
			'height' => 0,
			'size'   => $tmpsize, ];

		// $w = $h = 0;
		if (strpos($mime, 'image') === 0 && ($s = getimagesize($tmpname))) {
			$stat['width']  = $s[0];
			$stat['height'] = $s[1];
		}
		// $this->clearcache();
		if (($path = $this->saveCE($fp, $dstpath, $name, $stat)) == false) {
			return false;
		}

		$stat = $this->stat($path);
		// Try get URL
		if (empty($stat['url']) && ($url = $this->getContentUrl($stat['hash']))) {
			$stat['url'] = $url;
		}

		return $stat;
	}

	/**
	 * Paste files.
	 *
	 * @param  Object $volume source volume
	 * @param         $src
	 * @param  string $dst    destination dir hash
	 * @param  bool   $rmSrc  remove source after copy?
	 * @param array   $hashes
	 *
	 * @return array|false
	 * @throws elFinderAbortException
	 * @internal param string $source file hash
	 * @author   Dmitry (dio) Levashov
	 */
	public function paste($volume, $src, $dst, $rmSrc = false, $hashes = []) {
		$err = $rmSrc ? elFinder::ERROR_MOVE : elFinder::ERROR_COPY;

		if ($this->commandDisabled('paste')) {
			return $this->setError($err, '#' . $src, elFinder::ERROR_PERM_DENIED);
		}

		if (($file = $volume->file($src, $rmSrc)) == false) {
			return $this->setError($err, '#' . $src, elFinder::ERROR_FILE_NOT_FOUND);
		}

		$name    = $file['name'];
		$errpath = $volume->path($file['hash']);

		if (($dir = $this->dir($dst)) == false) {
			return $this->setError($err, $errpath, elFinder::ERROR_TRGDIR_NOT_FOUND, '#' . $dst);
		}

		if (! $dir['write'] || ! $file['read']) {
			return $this->setError($err, $errpath, elFinder::ERROR_PERM_DENIED);
		}

		$destination = $this->decode($dst);

		if (($test = $volume->closest($src, $rmSrc ? 'locked' : 'read', $rmSrc))) {
			return $rmSrc
				? $this->setError($err, $errpath, elFinder::ERROR_LOCKED, $volume->path($test))
				: $this->setError($err, $errpath, empty($file['thash']) ? elFinder::ERROR_PERM_DENIED : elFinder::ERROR_MKOUTLINK);
		}

		if (isset($hashes[$name])) {
			$test = $this->decode($hashes[$name]);
			$stat = $this->stat($test);
		} else {
			$test = $this->joinPathCE($destination, $name);
			$stat = $this->isNameExists($test);
		}
		$this->clearcache();
		$dstDirExists = false;

		if ($stat && $stat['name'] === $name) { // file exists and check filename for item ID based filesystem
			if ($this->options['copyOverwrite']) {
				// do not replace file with dir or dir with file
				if (! $this->isSameType($file['mime'], $stat['mime'])) {
					return $this->setError(elFinder::ERROR_NOT_REPLACE, $this->path($stat['hash']));
				}
				// existed file is not writable
				if (empty($stat['write'])) {
					return $this->setError($err, $errpath, elFinder::ERROR_PERM_DENIED);
				}

				if ($this->options['copyJoin']) {
					if (! empty($stat['locked'])) {
						return $this->setError(elFinder::ERROR_LOCKED, $this->path($stat['hash']));
					}
				} else {
					// existed file locked or has locked child
					if (($locked = $this->closestByAttr($test, 'locked', true))) {
						$stat = $this->stat($locked);

						return $this->setError(elFinder::ERROR_LOCKED, $this->path($stat['hash']));
					}
				}
				// target is entity file of alias
				if ($volume === $this && ((isset($file['target']) && $test == $file['target']) || $test == $this->decode($src))) {
					return $this->setError(elFinder::ERROR_REPLACE, $errpath);
				}
				// remove existed file
				if (! $this->options['copyJoin'] || $stat['mime'] !== 'directory') {
					if (! $this->remove($test)) {
						return $this->setError(elFinder::ERROR_REPLACE, $this->path($stat['hash']));
					}
				} else {
					if ($stat['mime'] === 'directory') {
						$dstDirExists = true;
					}
				}
			} else {
				$name = $this->uniqueName($destination, $name, ' ', false);
			}
		}

		// copy/move inside current volume
		if ($volume === $this) { //  changing == operand to === fixes issue #1285 - Paul Canning 24/03/2016
			$source = $this->decode($src);
			// do not copy into itself
			if ($this->inpathCE($destination, $source)) {
				return $this->setError(elFinder::ERROR_COPY_ITSELF, $errpath);
			}
			$rmDir = false;

			if ($rmSrc) {
				if ($dstDirExists) {
					$rmDir  = true;
					$method = 'copy';
				} else {
					$method = 'move';
				}
			} else {
				$method = 'copy';
			}
			$this->clearcache();

			if ($res = ($path = $this->$method($source, $destination, $name)) ? $this->stat($path) : false) {
				if ($rmDir) {
					$this->remove($source);
				}
			} else {
				return false;
			}
		} else {
			// copy/move from another volume
			if (! $this->options['copyTo'] || ! $volume->copyFromAllowed()) {
				return $this->setError(elFinder::ERROR_COPY, $errpath, elFinder::ERROR_PERM_DENIED);
			}

			$this->error = [];

			if (($path = $this->copyFrom($volume, $src, $destination, $name)) == false) {
				return false;
			}

			if ($rmSrc && ! $this->error()) {
				if (! $volume->rm($src)) {
					if ($volume->file($src)) {
						$this->addError(elFinder::ERROR_RM_SRC);
					} else {
						$this->removed[] = $file;
					}
				}
			}
			$res = $this->stat($path);
		}

		return $res;
	}

	/**
	 * Return path info array to archive of target items.
	 *
	 * @param  array $hashes
	 *
	 * @return array|false
	 * @throws Exception
	 * @author Naoki Sawada
	 */
	public function zipdl($hashes) {
		if ($this->commandDisabled('zipdl')) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		$archivers = $this->getArchivers();
		$cmd       = null;

		if (! $archivers || empty($archivers['create'])) {
			return false;
		}
		$archivers = $archivers['create'];

		if (! $archivers) {
			return false;
		}
		$file = $mime = '';

		foreach (['zip', 'tgz'] as $ext) {
			$mime = $this->mimetype('file.' . $ext, true);

			if (isset($archivers[$mime])) {
				$cmd = $archivers[$mime];

				break;
			}
		}

		if (! $cmd) {
			$cmd = array_shift($archivers);

			if (! empty($ext)) {
				$mime = $this->mimetype('file.' . $ext, true);
			}
		}
		$ext     = $cmd['ext'];
		$res     = false;
		$mixed   = false;
		$hashes  = array_values($hashes);
		$dirname = dirname(str_replace($this->separator, DIRECTORY_SEPARATOR, $this->path($hashes[0])));
		$cnt     = count($hashes);

		if ($cnt > 1) {
			for ($i = 1; $i < $cnt; $i++) {
				if ($dirname !== dirname(str_replace($this->separator, DIRECTORY_SEPARATOR, $this->path($hashes[$i])))) {
					$mixed = true;

					break;
				}
			}
		}

		if ($mixed || $this->root == $this->dirnameCE($this->decode($hashes[0]))) {
			$prefix = $this->rootName;
		} else {
			$prefix = basename($dirname);
		}

		if ($dir = $this->getItemsInHand($hashes)) {
			$tmppre = (substr(PHP_OS, 0, 3) === 'WIN') ? 'zd-' : 'elfzdl-';
			$pdir   = dirname($dir);
			// garbage collection (expire 2h)
			register_shutdown_function(['elFinder', 'GlobGC'], $pdir . DIRECTORY_SEPARATOR . $tmppre . '*', 7200);
			$files = self::localScandir($dir);

			if ($files && ($arc = tempnam($dir, $tmppre))) {
				unlink($arc);
				$arc  = $arc . '.' . $ext;
				$name = basename($arc);

				if ($arc = $this->makeArchive($dir, $files, $name, $cmd)) {
					$file = tempnam($pdir, $tmppre);
					unlink($file);
					$res = rename($arc, $file);
					$this->rmdirRecursive($dir);
				}
			}
		}

		return $res ? ['path' => $file, 'ext' => $ext, 'mime' => $mime, 'prefix' => $prefix] : false;
	}

	/**
	 * Return file contents.
	 *
	 * @param  string $hash file hash
	 *
	 * @return string|false
	 * @author Dmitry (dio) Levashov
	 **/
	public function getContents($hash) {
		$file = $this->file($hash);

		if (! $file) {
			return $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
		}

		if ($file['mime'] == 'directory') {
			return $this->setError(elFinder::ERROR_NOT_FILE);
		}

		if (! $file['read']) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		if ($this->getMaxSize > 0 && $file['size'] > $this->getMaxSize) {
			return $this->setError(elFinder::ERROR_UPLOAD_FILE_SIZE);
		}

		return $file['size'] ? $this->_getContents($this->convEncIn($this->decode($hash), true)) : '';
	}

	/**
	 * Put content in text file and return file info.
	 *
	 * @param  string $hash    file hash
	 * @param  string $content new file content
	 *
	 * @return array|false
	 * @author Dmitry (dio) Levashov
	 **/
	public function putContents($hash, $content) {
		if ($this->commandDisabled('edit')) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		$path = $this->decode($hash);

		if (! ($file = $this->file($hash))) {
			return $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
		}

		if (! $file['write']) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		// check data cheme
		if (preg_match('~^\0data:(.+?/.+?);base64,~', $content, $m)) {
			$dMime = $m[1];

			if ($file['size'] > 0 && $dMime !== $file['mime']) {
				return $this->setError(elFinder::ERROR_PERM_DENIED);
			}
			$content = base64_decode(substr($content, strlen($m[0])));
		}

		// check MIME
		$name       = $this->basenameCE($path);
		$mime       = '';
		$mimeByName = $this->mimetype($name, true);

		if ($this->mimeDetect !== 'internal') {
			if ($tp = $this->tmpfile()) {
				fwrite($tp, $content);
				$info     = stream_get_meta_data($tp);
				$filepath = $info['uri'];
				$mime     = $this->mimetype($filepath, $name);
				fclose($tp);
			}
		}

		if (! $this->allowPutMime($mimeByName) || ($mime && ! $this->allowPutMime($mime))) {
			return $this->setError(elFinder::ERROR_UPLOAD_FILE_MIME);
		}

		$this->clearcache();
		$res = false;

		if ($this->convEncOut($this->_filePutContents($this->convEncIn($path), $content))) {
			$this->rmTmb($file);
			$this->clearstatcache();
			$res = $this->stat($path);
		}

		return $res;
	}

	/**
	 * Extract files from archive.
	 *
	 * @param  string $hash archive hash
	 * @param null    $makedir
	 *
	 * @return array|bool
	 * @author Dmitry (dio) Levashov,
	 * @author Alexey Sukhotin
	 */
	public function extract($hash, $makedir = null) {
		if ($this->commandDisabled('extract')) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		if (($file = $this->file($hash)) == false) {
			return $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
		}

		$archiver = $this->archivers['extract'][$file['mime']]
			?? [];

		if (! $archiver) {
			return $this->setError(elFinder::ERROR_NOT_ARCHIVE);
		}

		$path   = $this->decode($hash);
		$parent = $this->stat($this->dirnameCE($path));

		if (! $file['read'] || ! $parent['write']) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}
		$this->clearcache();
		$this->extractToNewdir = is_null($makedir) ? 'auto' : (bool)$makedir;

		if ($path = $this->convEncOut($this->_extract($this->convEncIn($path), $archiver))) {
			if (is_array($path)) {
				foreach ($path as $_k => $_p) {
					$path[$_k] = $this->stat($_p);
				}
			} else {
				$path = $this->stat($path);
			}

			return $path;
		} else {
			return false;
		}
	}

	/**
	 * Add files to archive.
	 *
	 * @param        $hashes
	 * @param        $mime
	 * @param string $name
	 *
	 * @return array|bool
	 * @throws Exception
	 */
	public function archive($hashes, $mime, $name = '') {
		if ($this->commandDisabled('archive')) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		if ($name !== '' && ! $this->nameAccepted($name, false)) {
			return $this->setError(elFinder::ERROR_INVALID_NAME);
		}

		$archiver = $this->archivers['create'][$mime]
			?? [];

		if (! $archiver) {
			return $this->setError(elFinder::ERROR_ARCHIVE_TYPE);
		}

		$files            = [];
		$useRemoteArchive = ! empty($this->options['useRemoteArchive']);

		$dir = '';

		foreach ($hashes as $hash) {
			if (($file = $this->file($hash)) == false) {
				return $this->setError(elFinder::ERROR_FILE_NOT_FOUND, '#' . $hash);
			}

			if (! $file['read']) {
				return $this->setError(elFinder::ERROR_PERM_DENIED);
			}
			$path = $this->decode($hash);

			if ($dir === '') {
				$dir  = $this->dirnameCE($path);
				$stat = $this->stat($dir);

				if (! $stat['write']) {
					return $this->setError(elFinder::ERROR_PERM_DENIED);
				}
			}

			$files[] = $useRemoteArchive ? $hash : $this->basenameCE($path);
		}

		if ($name === '') {
			$name = count($files) == 1 ? $files[0] : 'Archive';
		} else {
			$name = str_replace(['/', '\\'], '_', preg_replace('/\.' . preg_quote($archiver['ext'], '/') . '$/i', '', $name));
		}
		$name .= '.' . $archiver['ext'];
		$name = $this->uniqueName($dir, $name, '');
		$this->clearcache();

		if ($useRemoteArchive) {
			return ($path = $this->remoteArchive($files, $name, $archiver)) ? $this->stat($path) : false;
		} else {
			return ($path = $this->convEncOut($this->_archive($this->convEncIn($dir), $this->convEncIn($files), $this->convEncIn($name), $archiver))) ? $this->stat($path) : false;
		}
	}

	/**
	 * Create an archive from remote items.
	 *
	 * @param      array  $hashes files hashes list
	 * @param      string $name   archive name
	 * @param      array  $arc    archiver options
	 *
	 * @return     string|boolean  path of created archive
	 * @throws     Exception
	 */
	protected function remoteArchive($hashes, $name, $arc) {
		$resPath = false;
		$file0   = $this->file($hashes[0]);

		if ($file0 && ($dir = $this->getItemsInHand($hashes))) {
			$files = self::localScandir($dir);

			if ($files) {
				if ($arc = $this->makeArchive($dir, $files, $name, $arc)) {
					if ($fp = fopen($arc, 'rb')) {
						$fstat = stat($arc);
						$stat  = [
							'size' => $fstat['size'],
							'ts'   => $fstat['mtime'],
							'mime' => $this->mimetype($arc, $name),
						];
						$path    = $this->decode($file0['phash']);
						$resPath = $this->saveCE($fp, $path, $name, $stat);
						fclose($fp);
					}
				}
			}
			$this->rmdirRecursive($dir);
		}

		return $resPath;
	}

	/**
	 * Resize image.
	 *
	 * @param  string $hash       image file
	 * @param  int    $width      new width
	 * @param  int    $height     new height
	 * @param  int    $x          X start poistion for crop
	 * @param  int    $y          Y start poistion for crop
	 * @param  string $mode       action how to mainpulate image
	 * @param  string $bg         background color
	 * @param  int    $degree     rotete degree
	 * @param  int    $jpgQuality JEPG quality (1-100)
	 *
	 * @return array|false
	 * @throws ImagickException
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 * @author Alexey Sukhotin
	 * @author nao-pon
	 * @author Troex Nevelin
	 */
	public function resize($hash, $width, $height, $x, $y, $mode = 'resize', $bg = '', $degree = 0, $jpgQuality = null) {
		if ($this->commandDisabled('resize')) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		if ($mode === 'rotate' && $degree == 0) {
			return ['losslessRotate' => ($this->procExec(ELFINDER_EXIFTRAN_PATH . ' -h') === 0 || $this->procExec(ELFINDER_JPEGTRAN_PATH . ' -version') === 0)];
		}

		if (($file = $this->file($hash)) == false) {
			return $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
		}

		if (! $file['write'] || ! $file['read']) {
			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		$path = $this->decode($hash);

		$work_path = $this->getWorkFile($this->encoding ? $this->convEncIn($path, true) : $path);

		if (! $work_path || ! is_writable($work_path)) {
			if ($work_path && $path !== $work_path && is_file($work_path)) {
				unlink($work_path);
			}

			return $this->setError(elFinder::ERROR_PERM_DENIED);
		}

		if ($this->imgLib !== 'imagick' && $this->imgLib !== 'convert') {
			if (elFinder::isAnimationGif($work_path)) {
				return $this->setError(elFinder::ERROR_UNSUPPORT_TYPE);
			}
		}

		if (elFinder::isAnimationPng($work_path)) {
			return $this->setError(elFinder::ERROR_UNSUPPORT_TYPE);
		}

		switch ($mode) {
			case 'propresize':
				$result = $this->imgResize($work_path, $width, $height, true, true, null, $jpgQuality);

				break;

			case 'crop':
				$result = $this->imgCrop($work_path, $width, $height, $x, $y, null, $jpgQuality);

				break;

			case 'fitsquare':
				$result = $this->imgSquareFit($work_path, $width, $height, 'center', 'middle', ($bg ? $bg : $this->options['tmbBgColor']), null, $jpgQuality);

				break;

			case 'rotate':
				$result = $this->imgRotate($work_path, $degree, ($bg ? $bg : $this->options['bgColorFb']), null, $jpgQuality);

				break;

			default:
				$result = $this->imgResize($work_path, $width, $height, false, true, null, $jpgQuality);

				break;
		}

		$ret = false;

		if ($result) {
			$this->rmTmb($file);
			$this->clearstatcache();
			$fstat   = stat($work_path);
			$imgsize = getimagesize($work_path);

			if ($path !== $work_path) {
				$file['size'] = $fstat['size'];
				$file['ts']   = $fstat['mtime'];

				if ($imgsize) {
					$file['width']  = $imgsize[0];
					$file['height'] = $imgsize[1];
				}

				if ($fp = fopen($work_path, 'rb')) {
					$ret = $this->saveCE($fp, $this->dirnameCE($path), $this->basenameCE($path), $file);
					fclose($fp);
				}
			} else {
				$ret = true;
			}

			if ($ret) {
				$this->clearcache();
				$ret = $this->stat($path);

				if ($imgsize) {
					$ret['width']  = $imgsize[0];
					$ret['height'] = $imgsize[1];
				}
			}
		}

		if ($path !== $work_path) {
			is_file($work_path) && unlink($work_path);
		}

		return $ret;
	}

	/**
	 * Remove file/dir.
	 *
	 * @param  string $hash file hash
	 *
	 * @return bool
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	public function rm($hash) {
		return $this->commandDisabled('rm')
			? $this->setError(elFinder::ERROR_PERM_DENIED)
			: $this->remove($this->decode($hash));
	}

	/**
	 * Search files.
	 *
	 * @param  string $q search string
	 * @param  array  $mimes
	 * @param null    $hash
	 *
	 * @return array
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	public function search($q, $mimes, $hash = null) {
		$res         = [];
		$matchMethod = null;
		$args        = func_get_args();

		if (! empty($args[3])) {
			$matchMethod = 'searchMatch' . $args[3];

			if (! is_callable([$this, $matchMethod])) {
				return [];
			}
		}

		$dir = null;

		if ($hash) {
			$dir  = $this->decode($hash);
			$stat = $this->stat($dir);

			if (! $stat || $stat['mime'] !== 'directory' || ! $stat['read']) {
				$q = '';
			}
		}

		if ($mimes && $this->onlyMimes) {
			$mimes = array_intersect($mimes, $this->onlyMimes);

			if (! $mimes) {
				$q = '';
			}
		}
		$this->searchStart = time();

		$qs    = preg_split('/"([^"]+)"| +/', $q, -1, PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE);
		$query = $excludes = [];

		foreach ($qs as $_q) {
			$_q = trim($_q);

			if ($_q !== '') {
				if ($_q[0] === '-') {
					if (isset($_q[1])) {
						$excludes[] = substr($_q, 1);
					}
				} else {
					$query[] = $_q;
				}
			}
		}

		if (! $query) {
			$q = '';
		} else {
			$q                          = join(' ', $query);
			$this->doSearchCurrentQuery = [
				'q'           => $q,
				'excludes'    => $excludes,
				'matchMethod' => $matchMethod,
			];
		}

		if ($q === '' || $this->commandDisabled('search')) {
			return $res;
		}

		// valided regex $this->options['searchExDirReg']
		if ($this->options['searchExDirReg']) {
			if (false === preg_match($this->options['searchExDirReg'], '')) {
				$this->options['searchExDirReg'] = '';
			}
		}

		// check the leaf root too
		if (! $mimes && (is_null($dir) || $dir == $this->root)) {
			$rootStat = $this->stat($this->root);

			if (! empty($rootStat['phash'])) {
				if ($this->stripos($rootStat['name'], $q) !== false) {
					$res = [$rootStat];
				}
			}
		}

		return array_merge($res, $this->doSearch(is_null($dir) ? $this->root : $dir, $q, $mimes));
	}

	/**
	 * Return image dimensions.
	 *
	 * @param  string $hash file hash
	 *
	 * @return array|string
	 * @author Dmitry (dio) Levashov
	 **/
	public function dimensions($hash) {
		if (($file = $this->file($hash)) == false) {
			return false;
		}
		// Throw additional parameters for some drivers
		if (func_num_args() > 1) {
			$args = func_get_arg(1);
		} else {
			$args = [];
		}

		return $this->convEncOut($this->_dimensions($this->convEncIn($this->decode($hash)), $file['mime'], $args));
	}

	/**
	 * Return has subdirs.
	 *
	 * @param  string $hash file hash
	 *
	 * @return bool
	 * @author Naoki Sawada
	 **/
	public function subdirs($hash) {
		return (bool)$this->subdirsCE($this->decode($hash));
	}

	/**
	 * Return content URL (for netmout volume driver)
	 * If file.url == 1 requests from JavaScript client with XHR.
	 *
	 * @param string $hash    file hash
	 * @param array  $options options array
	 *
	 * @return boolean|string
	 * @author Naoki Sawada
	 */
	public function getContentUrl($hash, $options = []) {
		if (($file = $this->file($hash)) === false) {
			return false;
		}

		if (! empty($options['onetime']) && $this->options['onetimeUrl']) {
			if (is_callable($this->options['onetimeUrl'])) {
				return call_user_func_array($this->options['onetimeUrl'], [$file, $options, $this]);
			} else {
				$ret = false;

				if ($tmpdir = elFinder::getStaticVar('commonTempPath')) {
					if ($source = $this->open($hash)) {
						if ($_dat = tempnam($tmpdir, 'ELF')) {
							$token = md5($_dat . session_id());
							$dat   = $tmpdir . DIRECTORY_SEPARATOR . 'ELF' . $token;

							if (rename($_dat, $dat)) {
								$info = stream_get_meta_data($source);

								if (! empty($info['uri'])) {
									$tmp = $info['uri'];
								} else {
									$tmp = tempnam($tmpdir, 'ELF');

									if ($dest = fopen($tmp, 'wb')) {
										if (! stream_copy_to_stream($source, $dest)) {
											$tmp = false;
										}
										fclose($dest);
									}
								}
								$this->close($source, $hash);

								if ($tmp) {
									$info = [
										'file' => base64_encode($tmp),
										'name' => $file['name'],
										'mime' => $file['mime'],
										'ts'   => $file['ts'],
									];

									if (file_put_contents($dat, json_encode($info))) {
										$conUrl = elFinder::getConnectorUrl();
										$ret    = $conUrl . (strpos($conUrl, '?') !== false ? '&' : '?') . 'cmd=file&onetime=1&target=' . $token;
									}
								}

								if (! $ret) {
									unlink($dat);
								}
							} else {
								unlink($_dat);
							}
						}
					}
				}

				return $ret;
			}
		}

		if (empty($file['url']) && $this->URL) {
			$path = str_replace($this->separator, '/', substr($this->decode($hash), strlen(trim($this->root, '/' . $this->separator))));

			if ($this->encoding) {
				$path = $this->convEncIn($path, true);
			}
			$path = str_replace('%2F', '/', rawurlencode($path));

			return $this->URL . $path;
		} else {
			$ret = false;

			if (! empty($file['url']) && $file['url'] != 1) {
				return $file['url'];
			} else {
				if (! empty($options['temporary']) && ($tempInfo = $this->getTempLinkInfo('temp_' . md5($hash . session_id())))) {
					if (is_readable($tempInfo['path'])) {
						touch($tempInfo['path']);
						$ret = $tempInfo['url'] . '?' . rawurlencode($file['name']);
					} else {
						if ($source = $this->open($hash)) {
							if ($dest = fopen($tempInfo['path'], 'wb')) {
								if (stream_copy_to_stream($source, $dest)) {
									$ret = $tempInfo['url'] . '?' . rawurlencode($file['name']);
								}
								fclose($dest);
							}
							$this->close($source, $hash);
						}
					}
				}
			}

			return $ret;
		}
	}

	/**
	 * Get temporary contents link infomation.
	 *
	 * @param string $name
	 *
	 * @return boolean|array
	 * @author Naoki Sawada
	 */
	public function getTempLinkInfo($name = null) {
		if ($this->tmpLinkPath) {
			if (! $name) {
				$name = 'temp_' . md5($_SERVER['REMOTE_ADDR'] . (string)microtime(true));
			} else {
				if (substr($name, 0, 5) !== 'temp_') {
					$name = 'temp_' . $name;
				}
			}
			register_shutdown_function(['elFinder', 'GlobGC'], $this->tmpLinkPath . DIRECTORY_SEPARATOR . 'temp_*', elFinder::$tmpLinkLifeTime);

			return [
				'path' => $path = $this->tmpLinkPath . DIRECTORY_SEPARATOR . $name,
				'url'  => $this->tmpLinkUrl . '/' . rawurlencode($name),
			];
		}

		return false;
	}

	/**
	 * Get URL of substitute image by request args `substitute` or 4th argument $maxSize.
	 *
	 * @param string   $target  Target hash
	 * @param array    $srcSize Size info array [width, height]
	 * @param resource $srcfp   Source file file pointer
	 * @param integer  $maxSize Maximum pixel of substitute image
	 *
	 * @return boolean
	 * @throws ImagickException
	 * @throws elFinderAbortException
	 */
	public function getSubstituteImgLink($target, $srcSize, $srcfp = null, $maxSize = null) {
		$url   = false;
		$file  = $this->file($target);
		$force = ! in_array($file['mime'], ['image/jpeg', 'image/png', 'image/gif']);

		if (! $maxSize) {
			$args = elFinder::$currentArgs;

			if (! empty($args['substitute'])) {
				$maxSize = $args['substitute'];
			}
		}

		if ($maxSize && $srcSize[0] && $srcSize[1]) {
			if ($this->getOption('substituteImg')) {
				$maxSize = intval($maxSize);
				$zoom    = min(($maxSize / $srcSize[0]), ($maxSize / $srcSize[1]));

				if ($force || $zoom < 1) {
					$width         = round($srcSize[0] * $zoom);
					$height        = round($srcSize[1] * $zoom);
					$jpgQuality    = 50;
					$preserveExif  = false;
					$unenlarge     = true;
					$checkAnimated = true;
					$destformat    = $file['mime'] === 'image/jpeg' ? null : 'png';

					if (! $srcfp) {
						elFinder::checkAborted();
						$srcfp = $this->open($target);
					}

					if ($srcfp && ($tempLink = $this->getTempLinkInfo())) {
						elFinder::checkAborted();
						$dest = fopen($tempLink['path'], 'wb');

						if ($dest && stream_copy_to_stream($srcfp, $dest)) {
							fclose($dest);

							if ($this->imageUtil('resize', $tempLink['path'], compact('width', 'height', 'jpgQuality', 'preserveExif', 'unenlarge', 'checkAnimated', 'destformat'))) {
								$url = $tempLink['url'];
								// set expire to 1 min left
								touch($tempLink['path'], time() - elFinder::$tmpLinkLifeTime + 60);
							} else {
								unlink($tempLink['path']);
							}
						}
						$this->close($srcfp, $target);
					}
				}
			}
		}

		return $url;
	}

	/**
	 * Return temp path.
	 *
	 * @return string
	 * @author Naoki Sawada
	 */
	public function getTempPath() {
		$tempPath = null;

		if (isset($this->tmpPath) && $this->tmpPath && is_writable($this->tmpPath)) {
			$tempPath = $this->tmpPath;
		} else {
			if (isset($this->tmp) && $this->tmp && is_writable($this->tmp)) {
				$tempPath = $this->tmp;
			} else {
				if (elFinder::getStaticVar('commonTempPath') && is_writable(elFinder::getStaticVar('commonTempPath'))) {
					$tempPath = elFinder::getStaticVar('commonTempPath');
				} else {
					if (function_exists('sys_get_temp_dir')) {
						$tempPath = sys_get_temp_dir();
					} else {
						if ($this->tmbPathWritable) {
							$tempPath = $this->tmbPath;
						}
					}
				}
			}
		}

		if ($tempPath && DIRECTORY_SEPARATOR !== '/') {
			$tempPath = str_replace('/', DIRECTORY_SEPARATOR, $tempPath);
		}

		return $tempPath;
	}

	/**
	 * (Make &) Get upload taget dirctory hash.
	 *
	 * @param string $baseTargetHash
	 * @param string $path
	 * @param array  $result
	 *
	 * @return boolean|string
	 * @author Naoki Sawada
	 */
	public function getUploadTaget($baseTargetHash, $path, &$result) {
		$base       = $this->decode($baseTargetHash);
		$targetHash = $baseTargetHash;
		$path       = ltrim($path, $this->separator);
		$dirs       = explode($this->separator, $path);
		array_pop($dirs);

		foreach ($dirs as $dir) {
			$targetPath = $this->joinPathCE($base, $dir);

			if (! $_realpath = $this->realpath($this->encode($targetPath))) {
				if ($stat = $this->mkdir($targetHash, $dir)) {
					$result['added'][] = $stat;
					$targetHash        = $stat['hash'];
					$base              = $this->decode($targetHash);
				} else {
					return false;
				}
			} else {
				$targetHash = $this->encode($_realpath);

				if ($this->dir($targetHash)) {
					$base = $this->decode($targetHash);
				} else {
					return false;
				}
			}
		}

		return $targetHash;
	}

	/**
	 * Return this uploadMaxSize value.
	 *
	 * @return integer
	 * @author Naoki Sawada
	 */
	public function getUploadMaxSize() {
		return $this->uploadMaxSize;
	}

	public function setUploadOverwrite($var) {
		$this->uploadOverwrite = (bool)$var;
	}

	/**
	 * Image file utility.
	 *
	 * @param string $mode    'resize', 'rotate', 'propresize', 'crop', 'fitsquare'
	 * @param string $src     Image file local path
	 * @param array  $options excute options
	 *
	 * @return bool
	 * @throws ImagickException
	 * @throws elFinderAbortException
	 * @author Naoki Sawada
	 */
	public function imageUtil($mode, $src, $options = []) {
		if (! isset($options['jpgQuality'])) {
			$options['jpgQuality'] = intval($this->options['jpgQuality']);
		}

		if (! isset($options['bgcolor'])) {
			$options['bgcolor'] = '#ffffff';
		}

		if (! isset($options['bgColorFb'])) {
			$options['bgColorFb'] = $this->options['bgColorFb'];
		}
		$destformat = ! empty($options['destformat']) ? $options['destformat'] : null;

		// check 'width' ,'height'
		if (in_array($mode, ['resize', 'propresize', 'crop', 'fitsquare'])) {
			if (empty($options['width']) || empty($options['height'])) {
				return false;
			}
		}

		if (! empty($options['checkAnimated'])) {
			if ($this->imgLib !== 'imagick' && $this->imgLib !== 'convert') {
				if (elFinder::isAnimationGif($src)) {
					return false;
				}
			}

			if (elFinder::isAnimationPng($src)) {
				return false;
			}
		}

		switch ($mode) {
			case 'rotate':
				if (empty($options['degree'])) {
					return true;
				}

				return (bool)$this->imgRotate($src, $options['degree'], $options['bgColorFb'], $destformat, $options['jpgQuality']);

			case 'resize':
				return (bool)$this->imgResize($src, $options['width'], $options['height'], false, true, $destformat, $options['jpgQuality'], $options);

			case 'propresize':
				return (bool)$this->imgResize($src, $options['width'], $options['height'], true, true, $destformat, $options['jpgQuality'], $options);

			case 'crop':
				if (isset($options['x']) && isset($options['y'])) {
					return (bool)$this->imgCrop($src, $options['width'], $options['height'], $options['x'], $options['y'], $destformat, $options['jpgQuality']);
				}

				break;

			case 'fitsquare':
				return (bool)$this->imgSquareFit($src, $options['width'], $options['height'], 'center', 'middle', $options['bgcolor'], $destformat, $options['jpgQuality']);
		}

		return false;
	}

	/**
	 * Convert Video To Image by ffmpeg.
	 *
	 * @param  string $file video source file path
	 * @param  array  $stat file stat array
	 * @param  object $self volume driver object
	 * @param  int    $ss   start seconds
	 *
	 * @return bool
	 * @throws elFinderAbortException
	 * @author Naoki Sawada
	 */
	public function ffmpegToImg($file, $stat, $self, $ss = null) {
		$name = basename($file);
		$path = dirname($file);
		$tmp  = $path . DIRECTORY_SEPARATOR . md5($name);
		// register auto delete on shutdown
		$GLOBALS['elFinderTempFiles'][$tmp] = true;

		if (rename($file, $tmp)) {
			if ($ss === null) {
				// specific start time by file name (xxx^[sec].[extention] - video^3.mp4)
				if (preg_match('/\^(\d+(?:\.\d+)?)\.[^.]+$/', $stat['name'], $_m)) {
					$ss = $_m[1];
				} else {
					$ss = $this->options['tmbVideoConvSec'];
				}
			}
			$cmd = sprintf(ELFINDER_FFMPEG_PATH . ' -i %s -ss 00:00:%.3f -vframes 1 -f image2 -- %s', escapeshellarg($tmp), $ss, escapeshellarg($file));
			$r   = ($this->procExec($cmd) === 0);
			clearstatcache();

			if ($r && $ss > 0 && ! file_exists($file)) {
				// Retry by half of $ss
				$ss = max(intval($ss / 2), 0);
				rename($tmp, $file);
				$r = $this->ffmpegToImg($file, $stat, $self, $ss);
			} else {
				unlink($tmp);
			}

			return $r;
		}

		return false;
	}

	/**
	 * Creates a temporary file and return file pointer.
	 *
	 * @return resource|boolean
	 */
	public function tmpfile() {
		if ($tmp = $this->getTempFile()) {
			return fopen($tmp, 'wb');
		}

		return false;
	}

	/**
	 * Save error message.
	 *
	 * @param  array  error
	 *
	 * @return boolean false
	 * @author Naoki Sawada
	 **/
	protected function setError() {
		$this->error = [];
		$this->addError(func_get_args());

		return false;
	}

	/**
	 * Add error message.
	 *
	 * @param  array  error
	 *
	 * @return false
	 * @author Dmitry(dio) Levashov
	 **/
	protected function addError() {
		foreach (func_get_args() as $err) {
			if (is_array($err)) {
				foreach ($err as $er) {
					$this->addError($er);
				}
			} else {
				$this->error[] = (string)$err;
			}
		}

		return false;
	}

	/*                               FS API                              */

	/***************** server encoding support *******************/

	/**
	 * Return parent directory path (with convert encoding).
	 *
	 * @param  string $path file path
	 *
	 * @return string
	 * @author Naoki Sawada
	 **/
	protected function dirnameCE($path) {
		$dirname = (! $this->encoding) ? $this->_dirname($path) : $this->convEncOut($this->_dirname($this->convEncIn($path)));
		// check to infinite loop prevention
		return ($dirname != $path) ? $dirname : '';
	}

	/**
	 * Return file name (with convert encoding).
	 *
	 * @param  string $path file path
	 *
	 * @return string
	 * @author Naoki Sawada
	 **/
	protected function basenameCE($path) {
		return (! $this->encoding) ? $this->_basename($path) : $this->convEncOut($this->_basename($this->convEncIn($path)));
	}

	/**
	 * Join dir name and file name and return full path. (with convert encoding)
	 * Some drivers (db) use int as path - so we give to concat path to driver itself.
	 *
	 * @param  string $dir  dir path
	 * @param  string $name file name
	 *
	 * @return string
	 * @author Naoki Sawada
	 **/
	protected function joinPathCE($dir, $name) {
		return (! $this->encoding) ? $this->_joinPath($dir, $name) : $this->convEncOut($this->_joinPath($this->convEncIn($dir), $this->convEncIn($name)));
	}

	/**
	 * Return normalized path (with convert encoding).
	 *
	 * @param  string $path file path
	 *
	 * @return string
	 * @author Naoki Sawada
	 **/
	protected function normpathCE($path) {
		return (! $this->encoding) ? $this->_normpath($path) : $this->convEncOut($this->_normpath($this->convEncIn($path)));
	}

	/**
	 * Return file path related to root dir (with convert encoding).
	 *
	 * @param  string $path file path
	 *
	 * @return string
	 * @author Naoki Sawada
	 **/
	protected function relpathCE($path) {
		return (! $this->encoding) ? $this->_relpath($path) : $this->convEncOut($this->_relpath($this->convEncIn($path)));
	}

	/**
	 * Convert path related to root dir into real path (with convert encoding).
	 *
	 * @param  string $path rel file path
	 *
	 * @return string
	 * @author Naoki Sawada
	 **/
	protected function abspathCE($path) {
		return (! $this->encoding) ? $this->_abspath($path) : $this->convEncOut($this->_abspath($this->convEncIn($path)));
	}

	/**
	 * Return true if $path is children of $parent (with convert encoding).
	 *
	 * @param  string $path   path to check
	 * @param  string $parent parent path
	 *
	 * @return bool
	 * @author Naoki Sawada
	 **/
	protected function inpathCE($path, $parent) {
		return (! $this->encoding) ? $this->_inpath($path, $parent) : $this->convEncOut($this->_inpath($this->convEncIn($path), $this->convEncIn($parent)));
	}

	/**
	 * Open file and return file pointer (with convert encoding).
	 *
	 * @param  string $path file path
	 * @param string  $mode
	 *
	 * @return false|resource
	 * @internal param bool $write open file for writing
	 * @author   Naoki Sawada
	 */
	protected function fopenCE($path, $mode = 'rb') {
		// check extra option for network stream pointer
		if (func_num_args() > 2) {
			$opts = func_get_arg(2);
		} else {
			$opts = [];
		}

		return (! $this->encoding) ? $this->_fopen($path, $mode, $opts) : $this->convEncOut($this->_fopen($this->convEncIn($path), $mode, $opts));
	}

	/**
	 * Close opened file (with convert encoding).
	 *
	 * @param  resource $fp   file pointer
	 * @param  string   $path file path
	 *
	 * @return bool
	 * @author Naoki Sawada
	 **/
	protected function fcloseCE($fp, $path = '') {
		return (! $this->encoding) ? $this->_fclose($fp, $path) : $this->convEncOut($this->_fclose($fp, $this->convEncIn($path)));
	}

	/**
	 * Create new file and write into it from file pointer. (with convert encoding)
	 * Return new file path or false on error.
	 *
	 * @param  resource $fp   file pointer
	 * @param  string   $dir  target dir path
	 * @param  string   $name file name
	 * @param  array    $stat file stat (required by some virtual fs)
	 *
	 * @return bool|string
	 * @author Naoki Sawada
	 **/
	protected function saveCE($fp, $dir, $name, $stat) {
		$res = (! $this->encoding) ? $this->_save($fp, $dir, $name, $stat) : $this->convEncOut($this->_save($fp, $this->convEncIn($dir), $this->convEncIn($name), $this->convEncIn($stat)));

		if ($res !== false) {
			$this->clearstatcache();
		}

		return $res;
	}

	/**
	 * Return true if path is dir and has at least one childs directory (with convert encoding).
	 *
	 * @param  string $path dir path
	 *
	 * @return bool
	 * @author Naoki Sawada
	 **/
	protected function subdirsCE($path) {
		if ($this->sessionCaching['subdirs']) {
			if (isset($this->sessionCache['subdirs'][$path]) && ! $this->isMyReload()) {
				return $this->sessionCache['subdirs'][$path];
			}
		}
		$hasdir = (bool)((! $this->encoding) ? $this->_subdirs($path) : $this->convEncOut($this->_subdirs($this->convEncIn($path))));
		$this->updateSubdirsCache($path, $hasdir);

		return $hasdir;
	}

	/**
	 * Return files list in directory (with convert encoding).
	 *
	 * @param  string $path dir path
	 *
	 * @return array
	 * @author Naoki Sawada
	 **/
	protected function scandirCE($path) {
		return (! $this->encoding) ? $this->_scandir($path) : $this->convEncOut($this->_scandir($this->convEncIn($path)));
	}

	/**
	 * Create symlink (with convert encoding).
	 *
	 * @param  string $source    file to link to
	 * @param  string $targetDir folder to create link in
	 * @param  string $name      symlink name
	 *
	 * @return bool
	 * @author Naoki Sawada
	 **/
	protected function symlinkCE($source, $targetDir, $name) {
		return (! $this->encoding) ? $this->_symlink($source, $targetDir, $name) : $this->convEncOut($this->_symlink($this->convEncIn($source), $this->convEncIn($targetDir), $this->convEncIn($name)));
	}

	/***************** paths *******************/

	/**
	 * Encode path into hash.
	 *
	 * @param  string  file path
	 * @param mixed $path
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 * @author Troex Nevelin
	 **/
	protected function encode($path) {
		if ($path !== '') {
			// cut ROOT from $path for security reason, even if hacker decodes the path he will not know the root
			$p = $this->relpathCE($path);
			// if reqesting root dir $path will be empty, then assign '/' as we cannot leave it blank for crypt
			if ($p === '') {
				$p = $this->separator;
			}
			// change separator
			if ($this->separatorForHash) {
				$p = str_replace($this->separator, $this->separatorForHash, $p);
			}
			// TODO crypt path and return hash
			$hash = $this->crypt($p);
			// hash is used as id in HTML that means it must contain vaild chars
			// make base64 html safe and append prefix in begining
			$hash = strtr(base64_encode($hash), '+/=', '-_.');
			// remove dots '.' at the end, before it was '=' in base64
			$hash = rtrim($hash, '.');
			// append volume id to make hash unique
			return $this->id . $hash;
		}
		//TODO: Add return statement here
	}

	/**
	 * Decode path from hash.
	 *
	 * @param  string  file hash
	 * @param mixed $hash
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 * @author Troex Nevelin
	 **/
	protected function decode($hash) {
		if (strpos($hash, $this->id) === 0) {
			// cut volume id after it was prepended in encode
			$h = substr($hash, strlen($this->id));
			// replace HTML safe base64 to normal
			$h = base64_decode(strtr($h, '-_.', '+/='));
			// TODO uncrypt hash and return path
			$path = $this->uncrypt($h);
			// change separator
			if ($this->separatorForHash) {
				$path = str_replace($this->separatorForHash, $this->separator, $path);
			}
			// append ROOT to path after it was cut in encode
			return $this->abspathCE($path); //$this->root.($path === $this->separator ? '' : $this->separator.$path);
		}

		return '';
	}

	/**
	 * Return crypted path
	 * Not implemented.
	 *
	 * @param  string  path
	 * @param mixed $path
	 *
	 * @return mixed
	 * @author Dmitry (dio) Levashov
	 **/
	protected function crypt($path) {
		return $path;
	}

	/**
	 * Return uncrypted path
	 * Not implemented.
	 *
	 * @param  mixed  hash
	 * @param mixed $hash
	 *
	 * @return mixed
	 * @author Dmitry (dio) Levashov
	 **/
	protected function uncrypt($hash) {
		return $hash;
	}

	/**
	 * Validate file name based on $this->options['acceptedName'] regexp or function.
	 *
	 * @param  string $name file name
	 * @param  bool   $isDir
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 */
	protected function nameAccepted($name, $isDir = false) {
		if (json_encode($name) === false) {
			return false;
		}
		$nameValidator = $isDir ? $this->dirnameValidator : $this->nameValidator;

		if ($nameValidator) {
			if (is_callable($nameValidator)) {
				$res = call_user_func($nameValidator, $name);

				return $res;
			}

			if (preg_match($nameValidator, '') !== false) {
				return preg_match($nameValidator, $name);
			}
		}

		return true;
	}

	/**
	 * Return session rootstat cache key.
	 *
	 * @return string
	 */
	protected function getRootstatCachekey() {
		return md5($this->root . ($this->options['alias'] ?? ''));
	}

	/**
	 * Return new unique name based on file name and suffix.
	 *
	 * @param         $dir
	 * @param         $name
	 * @param  string $suffix suffix append to name
	 * @param bool    $checkNum
	 * @param int     $start
	 *
	 * @return string
	 * @internal param string $path file path
	 * @author   Dmitry (dio) Levashov
	 */
	public function uniqueName($dir, $name, $suffix = ' copy', $checkNum = true, $start = 1) {
		static $lasts = null;

		if ($lasts === null) {
			$lasts = [];
		}

		$ext = '';

		$splits = elFinder::splitFileExtention($name);

		if ($splits[1]) {
			$ext  = '.' . $splits[1];
			$name = $splits[0];
		}

		if ($checkNum && preg_match('/(' . preg_quote($suffix, '/') . ')(\d*)$/i', $name, $m)) {
			$i    = (int)$m[2];
			$name = substr($name, 0, strlen($name) - strlen($m[2]));
		} else {
			$i = $start;
			$name .= $suffix;
		}
		$max = $i + 100000;

		if (isset($lasts[$name])) {
			$i = max($i, $lasts[$name]);
		}

		while ($i <= $max) {
			$n = $name . ($i > 0 ? sprintf($this->options['uniqueNumFormat'], $i) : '') . $ext;

			if (! $this->isNameExists($this->joinPathCE($dir, $n))) {
				$this->clearcache();
				$lasts[$name] = ++$i;

				return $n;
			}
			$i++;
		}

		return $name . md5($dir) . $ext;
	}

	/**
	 * Converts character encoding from UTF-8 to server's one.
	 *
	 * @param  mixed  $var           target string or array var
	 * @param  bool   $restoreLocale do retore global locale, default is false
	 * @param  string $unknown       replaces character for unknown
	 *
	 * @return mixed
	 * @author Naoki Sawada
	 */
	public function convEncIn($var = null, $restoreLocale = false, $unknown = '_') {
		return (! $this->encoding) ? $var : $this->convEnc($var, 'UTF-8', $this->encoding, $this->options['locale'], $restoreLocale, $unknown);
	}

	/**
	 * Converts character encoding from server's one to UTF-8.
	 *
	 * @param  mixed  $var           target string or array var
	 * @param  bool   $restoreLocale do retore global locale, default is true
	 * @param  string $unknown       replaces character for unknown
	 *
	 * @return mixed
	 * @author Naoki Sawada
	 */
	public function convEncOut($var = null, $restoreLocale = true, $unknown = '_') {
		return (! $this->encoding) ? $var : $this->convEnc($var, $this->encoding, 'UTF-8', $this->options['locale'], $restoreLocale, $unknown);
	}

	/**
	 * Converts character encoding (base function).
	 *
	 * @param  mixed  $var     target string or array var
	 * @param  string $from    from character encoding
	 * @param  string $to      to character encoding
	 * @param  string $locale  local locale
	 * @param         $restoreLocale
	 * @param  string $unknown replaces character for unknown
	 *
	 * @return mixed
	 */
	protected function convEnc($var, $from, $to, $locale, $restoreLocale, $unknown = '_') {
		if (strtoupper($from) !== strtoupper($to)) {
			if ($locale) {
				setlocale(LC_ALL, $locale);
			}

			if (is_array($var)) {
				$_ret = [];

				foreach ($var as $_k => $_v) {
					$_ret[$_k] = $this->convEnc($_v, $from, $to, '', false, $unknown = '_');
				}
				$var = $_ret;
			} else {
				$_var = false;

				if (is_string($var)) {
					$_var   = $var;
					$errlev = error_reporting();
					error_reporting($errlev ^ E_NOTICE);

					if (false !== ($_var = iconv($from, $to . '//TRANSLIT', $_var))) {
						$_var = str_replace('?', $unknown, $_var);
					}
					error_reporting($errlev);
				}

				if ($_var !== false) {
					$var = $_var;
				}
			}

			if ($restoreLocale) {
				setlocale(LC_ALL, elFinder::$locale);
			}
		}

		return $var;
	}

	/**
	 * Normalize MIME-Type by options['mimeMap'].
	 *
	 * @param      string $type MIME-Type
	 * @param      string $name Filename
	 * @param      string $ext  File extention without first dot (optional)
	 *
	 * @return     string  Normalized MIME-Type
	 */
	public function mimeTypeNormalize($type, $name, $ext = '') {
		if ($ext === '') {
			$ext = (false === $pos = strrpos($name, '.')) ? '' : substr($name, $pos + 1);
		}
		$_checkKey = strtolower($ext . ':' . $type);

		if ($type === '') {
			$_keylen = strlen($_checkKey);

			foreach ($this->options['mimeMap'] as $_key => $_type) {
				if (substr($_key, 0, $_keylen) === $_checkKey) {
					$type = $_type;

					break;
				}
			}
		} else {
			if (isset($this->options['mimeMap'][$_checkKey])) {
				$type = $this->options['mimeMap'][$_checkKey];
			} else {
				$_checkKey = strtolower($ext . ':*');

				if (isset($this->options['mimeMap'][$_checkKey])) {
					$type = $this->options['mimeMap'][$_checkKey];
				} else {
					$_checkKey = strtolower('*:' . $type);

					if (isset($this->options['mimeMap'][$_checkKey])) {
						$type = $this->options['mimeMap'][$_checkKey];
					}
				}
			}
		}

		return $type;
	}

	/*********************** util mainly for inheritance class *********************/

	/**
	 * Get temporary filename. Tempfile will be removed when after script execution finishes or exit() is called.
	 * When needing the unique file to a path, give $path to parameter.
	 *
	 * @param  string $path for get unique file to a path
	 *
	 * @return string|false
	 * @author Naoki Sawada
	 */
	protected function getTempFile($path = '') {
		static $cache = [];

		$key = '';

		if ($path !== '') {
			$key = $this->id . '#' . $path;

			if (isset($cache[$key])) {
				return $cache[$key];
			}
		}

		if ($tmpdir = $this->getTempPath()) {
			$name = tempnam($tmpdir, 'ELF');

			if ($key) {
				$cache[$key] = $name;
			}
			// register auto delete on shutdown
			$GLOBALS['elFinderTempFiles'][$name] = true;

			return $name;
		}

		return false;
	}

	/**
	 * File path of local server side work file path.
	 *
	 * @param  string $path path need convert encoding to server encoding
	 *
	 * @return string
	 * @author Naoki Sawada
	 */
	protected function getWorkFile($path) {
		if ($wfp = $this->tmpfile()) {
			if ($fp = $this->_fopen($path)) {
				while (! feof($fp)) {
					fwrite($wfp, fread($fp, 8192));
				}
				$info = stream_get_meta_data($wfp);
				fclose($wfp);

				if ($info && ! empty($info['uri'])) {
					return $info['uri'];
				}
			}
		}

		return false;
	}

	/**
	 * Get image size array with `dimensions`.
	 *
	 * @param string $path path need convert encoding to server encoding
	 * @param string $mime file mime type
	 *
	 * @return array|false
	 * @throws ImagickException
	 * @throws elFinderAbortException
	 */
	public function getImageSize($path, $mime = '') {
		$size = false;

		if ($mime === '' || strtolower(substr($mime, 0, 5)) === 'image') {
			if ($work = $this->getWorkFile($path)) {
				if ($size = getimagesize($work)) {
					$size['dimensions'] = $size[0] . 'x' . $size[1];
					$srcfp              = fopen($work, 'rb');
					$cArgs              = elFinder::$currentArgs;

					if (! empty($cArgs['target']) && $subImgLink = $this->getSubstituteImgLink($cArgs['target'], $size, $srcfp)) {
						$size['url'] = $subImgLink;
					}
				}
			}
			is_file($work) && unlink($work);
		}

		return $size;
	}

	/**
	 * Delete dirctory trees.
	 *
	 * @param string $localpath path need convert encoding to server encoding
	 *
	 * @return boolean
	 * @throws elFinderAbortException
	 * @author Naoki Sawada
	 */
	protected function delTree($localpath) {
		foreach ($this->_scandir($localpath) as $p) {
			elFinder::checkAborted();
			$stat = $this->stat($this->convEncOut($p));
			$this->convEncIn();
			($stat['mime'] === 'directory') ? $this->delTree($p) : $this->_unlink($p);
		}
		$res = $this->_rmdir($localpath);
		$res && $this->clearstatcache();

		return $res;
	}

	/**
	 * Copy items to a new temporary directory on the local server.
	 *
	 * @param  array  $hashes  target hashes
	 * @param  string $dir     destination directory (for recurcive)
	 * @param  string $canLink it can use link() (for recurcive)
	 *
	 * @return string|false    saved path name
	 * @throws elFinderAbortException
	 * @author Naoki Sawada
	 */
	protected function getItemsInHand($hashes, $dir = null, $canLink = null) {
		static $banChrs   = null;
		static $totalSize = 0;

		if (is_null($banChrs)) {
			$banChrs = DIRECTORY_SEPARATOR !== '/' ? ['\\', '/', ':', '*', '?', '"', '<', '>', '|'] : ['\\', '/'];
		}

		if (is_null($dir)) {
			$totalSize = 0;

			if (! $tmpDir = $this->getTempPath()) {
				return false;
			}
			$dir = tempnam($tmpDir, 'elf');

			if (! unlink($dir) || ! mkdir($dir, 0700, true)) {
				return false;
			}
			register_shutdown_function([$this, 'rmdirRecursive'], $dir);
		}

		if (is_null($canLink)) {
			$canLink = ($this instanceof elFinderVolumeLocalFileSystem);
		}
		elFinder::checkAborted();
		$res   = true;
		$files = [];

		foreach ($hashes as $hash) {
			if (($file = $this->file($hash)) == false) {
				continue;
			}

			if (! $file['read']) {
				continue;
			}

			$name = $file['name'];
			// remove ctrl characters
			$name = preg_replace('/[[:cntrl:]]+/', '', $name);
			// replace ban characters
			$name = str_replace($banChrs, '_', $name);

			// for call from search results
			if (isset($files[$name])) {
				$name = preg_replace('/^(.*?)(\..*)?$/', '$1_' . $files[$name]++ . '$2', $name);
			} else {
				$files[$name] = 1;
			}
			$target = $dir . DIRECTORY_SEPARATOR . $name;

			if ($file['mime'] === 'directory') {
				$chashes = [];
				$_files  = $this->scandir($hash);

				foreach ($_files as $_file) {
					if ($file['read']) {
						$chashes[] = $_file['hash'];
					}
				}

				if (($res = mkdir($target, 0700, true)) && $chashes) {
					$res = $this->getItemsInHand($chashes, $target, $canLink);
				}

				if (! $res) {
					break;
				}
				! empty($file['ts']) && touch($target, $file['ts']);
			} else {
				$path = $this->decode($hash);

				if (! $canLink || ! ($canLink = $this->localFileSystemSymlink($path, $target))) {
					if (file_exists($target)) {
						unlink($target);
					}

					if ($fp = $this->fopenCE($path)) {
						if ($tfp = fopen($target, 'wb')) {
							$totalSize += stream_copy_to_stream($fp, $tfp);
							fclose($tfp);
						}
						! empty($file['ts']) && touch($target, $file['ts']);
						$this->fcloseCE($fp, $path);
					}
				} else {
					$totalSize += filesize($path);
				}

				if ($this->options['maxArcFilesSize'] > 0 && $this->options['maxArcFilesSize'] < $totalSize) {
					$res = $this->setError(elFinder::ERROR_ARC_MAXSIZE);
				}
			}
		}

		return $res ? $dir : false;
	}

	/*********************** file stat *********************/

	/**
	 * Check file attribute.
	 *
	 * @param  string $path  file path
	 * @param  string $name  attribute name (read|write|locked|hidden)
	 * @param  bool   $val   attribute value returned by file system
	 * @param  bool   $isDir path is directory (true: directory, false: file)
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 **/
	protected function attr($path, $name, $val = null, $isDir = null) {
		if (! isset($this->defaults[$name])) {
			return false;
		}

		$relpath = $this->relpathCE($path);

		if ($this->separator !== '/') {
			$relpath = str_replace($this->separator, '/', $relpath);
		}
		$relpath = '/' . $relpath;

		$perm = null;

		if ($this->access) {
			$perm = call_user_func($this->access, $name, $path, $this->options['accessControlData'], $this, $isDir, $relpath);

			if ($perm !== null) {
				return ! ! $perm;
			}
		}

		foreach ($this->attributes as $attrs) {
			if (isset($attrs[$name]) && isset($attrs['pattern']) && preg_match($attrs['pattern'], $relpath)) {
				$perm = $attrs[$name];

				break;
			}
		}

		return $perm === null ? (is_null($val) ? $this->defaults[$name] : $val) : ! ! $perm;
	}

	/**
	 * Return true if file with given name can be created in given folder.
	 *
	 * @param string $dir  parent dir path
	 * @param string $name new file name
	 * @param null   $isDir
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 */
	protected function allowCreate($dir, $name, $isDir = null) {
		return $this->attr($this->joinPathCE($dir, $name), 'write', true, $isDir);
	}

	/**
	 * Return true if file MIME type can save with check uploadOrder config.
	 *
	 * @param string $mime
	 *
	 * @return boolean
	 */
	protected function allowPutMime($mime) {
		// logic based on http://httpd.apache.org/docs/2.2/mod/mod_authz_host.html#order
		$allow = $this->mimeAccepted($mime, $this->uploadAllow, null);
		$deny  = $this->mimeAccepted($mime, $this->uploadDeny, null);

		if (strtolower($this->uploadOrder[0]) == 'allow') { // array('allow', 'deny'), default is to 'deny'
			$res = false; // default is deny

			if (! $deny && ($allow === true)) { // match only allow
				$res = true;
			}// else (both match | no match | match only deny) { deny }
		} else { // array('deny', 'allow'), default is to 'allow' - this is the default rule
			$res = true; // default is allow

			if (($deny === true) && ! $allow) { // match only deny
				$res = false;
			} // else (both match | no match | match only allow) { allow }
		}

		return $res;
	}

	/**
	 * Return fileinfo.
	 *
	 * @param  string $path file cache
	 *
	 * @return array|bool
	 * @author Dmitry (dio) Levashov
	 **/
	protected function stat($path) {
		if ($path === false || is_null($path)) {
			return false;
		}
		$is_root = ($path == $this->root);

		if ($is_root) {
			$rootKey = $this->getRootstatCachekey();

			if ($this->sessionCaching['rootstat'] && ! isset($this->sessionCache['rootstat'])) {
				$this->sessionCache['rootstat'] = [];
			}

			if (! isset($this->cache[$path]) && ! $this->isMyReload()) {
				// need $path as key for netmount/netunmount
				if ($this->sessionCaching['rootstat'] && isset($this->sessionCache['rootstat'][$rootKey])) {
					if ($ret = $this->sessionCache['rootstat'][$rootKey]) {
						if ($this->options['rootRev'] === $ret['rootRev']) {
							if (isset($this->options['phash'])) {
								$ret['isroot'] = 1;
								$ret['phash']  = $this->options['phash'];
							}

							return $ret;
						}
					}
				}
			}
		}
		$rootSessCache = false;

		if (isset($this->cache[$path])) {
			$ret = $this->cache[$path];
		} else {
			if ($is_root && ! empty($this->options['rapidRootStat']) && is_array($this->options['rapidRootStat']) && ! $this->needOnline) {
				$ret = $this->updateCache($path, $this->options['rapidRootStat'], true);
			} else {
				$ret = $this->updateCache($path, $this->convEncOut($this->_stat($this->convEncIn($path))), true);

				if ($is_root && ! empty($rootKey) && $this->sessionCaching['rootstat']) {
					$rootSessCache = true;
				}
			}
		}

		if ($is_root) {
			if ($ret) {
				$this->rootModified = false;

				if ($rootSessCache) {
					$this->sessionCache['rootstat'][$rootKey] = $ret;
				}

				if (isset($this->options['phash'])) {
					$ret['isroot'] = 1;
					$ret['phash']  = $this->options['phash'];
				}
			} else {
				if (! empty($rootKey) && $this->sessionCaching['rootstat']) {
					unset($this->sessionCache['rootstat'][$rootKey]);
				}
			}
		}

		return $ret;
	}

	/**
	 * Get root stat extra key values.
	 *
	 * @return array stat extras
	 * @author Naoki Sawada
	 */
	protected function getRootStatExtra() {
		$stat = [];

		if ($this->rootName) {
			$stat['name'] = $this->rootName;
		}
		$stat['rootRev'] = $this->options['rootRev'];
		$stat['options'] = $this->options(null);

		return $stat;
	}

	/**
	 * Return fileinfo based on filename
	 * For item ID based path file system
	 * Please override if needed on each drivers.
	 *
	 * @param  string $path file cache
	 *
	 * @return array
	 */
	protected function isNameExists($path) {
		return $this->stat($path);
	}

	/**
	 * Put file stat in cache and return it.
	 *
	 * @param  string $path file path
	 * @param  array  $stat file stat
	 *
	 * @return array
	 * @author Dmitry (dio) Levashov
	 **/
	protected function updateCache($path, $stat) {
		if (empty($stat) || ! is_array($stat)) {
			return $this->cache[$path] = [];
		}

		if (func_num_args() > 2) {
			$fromStat = func_get_arg(2);
		} else {
			$fromStat = false;
		}

		$stat['hash'] = $this->encode($path);

		$root   = $path == $this->root;
		$parent = '';

		if ($root) {
			$stat = array_merge($stat, $this->getRootStatExtra());
		} else {
			if (! isset($stat['name']) || $stat['name'] === '') {
				$stat['name'] = $this->basenameCE($path);
			}

			if (empty($stat['phash'])) {
				$parent        = $this->dirnameCE($path);
				$stat['phash'] = $this->encode($parent);
			} else {
				$parent = $this->decode($stat['phash']);
			}
		}

		// name check
		if (isset($stat['name']) && ! $jeName = json_encode($stat['name'])) {
			return $this->cache[$path] = [];
		}
		// fix name if required
		if ($this->options['utf8fix'] && $this->options['utf8patterns'] && $this->options['utf8replace']) {
			$stat['name'] = json_decode(str_replace($this->options['utf8patterns'], $this->options['utf8replace'], $jeName));
		}

		if (! isset($stat['size'])) {
			$stat['size'] = 'unknown';
		}

		$mime = $stat['mime'] ?? '';

		if ($isDir = ($mime === 'directory')) {
			$stat['volumeid'] = $this->id;
		} else {
			if (empty($stat['mime']) || $stat['size'] == 0) {
				$stat['mime'] = $this->mimetype($stat['name'], true, $stat['size'], $mime);
			} else {
				$stat['mime'] = $this->mimeTypeNormalize($stat['mime'], $stat['name']);
			}
		}

		$stat['read']  = intval($this->attr($path, 'read', isset($stat['read']) ? ! ! $stat['read'] : null, $isDir));
		$stat['write'] = intval($this->attr($path, 'write', isset($stat['write']) ? ! ! $stat['write'] : null, $isDir));

		if ($root) {
			$stat['locked'] = 1;

			if ($this->options['type'] !== '') {
				$stat['type'] = $this->options['type'];
			}
		} else {
			// lock when parent directory is not writable
			if (! isset($stat['locked'])) {
				$pstat = $this->stat($parent);

				if (isset($pstat['write']) && ! $pstat['write']) {
					$stat['locked'] = true;
				}
			}

			if ($this->attr($path, 'locked', isset($stat['locked']) ? ! ! $stat['locked'] : null, $isDir)) {
				$stat['locked'] = 1;
			} else {
				unset($stat['locked']);
			}
		}

		if ($root) {
			unset($stat['hidden']);
		} elseif ($this->attr($path, 'hidden', isset($stat['hidden']) ? ! ! $stat['hidden'] : null, $isDir)
			|| ! $this->mimeAccepted($stat['mime'])) {
			$stat['hidden'] = 1;
		} else {
			unset($stat['hidden']);
		}

		if ($stat['read'] && empty($stat['hidden'])) {
			if ($isDir) {
				// caching parent's subdirs
				if ($parent) {
					$this->updateSubdirsCache($parent, true);
				}
				// for dir - check for subdirs
				if ($this->options['checkSubfolders']) {
					if (! isset($stat['dirs']) && intval($this->options['checkSubfolders']) === -1) {
						$stat['dirs'] = -1;
					}

					if (isset($stat['dirs'])) {
						if ($stat['dirs']) {
							if ($stat['dirs'] == -1) {
								$stat['dirs'] = ($this->sessionCaching['subdirs'] && isset($this->sessionCache['subdirs'][$path])) ? (int)$this->sessionCache['subdirs'][$path] : -1;
							} else {
								$stat['dirs'] = 1;
							}
						} else {
							unset($stat['dirs']);
						}
					} elseif (! empty($stat['alias']) && ! empty($stat['target'])) {
						$stat['dirs'] = isset($this->cache[$stat['target']])
							? intval(isset($this->cache[$stat['target']]['dirs']))
							: $this->subdirsCE($stat['target']);
					} elseif ($this->subdirsCE($path)) {
						$stat['dirs'] = 1;
					}
				} else {
					$stat['dirs'] = 1;
				}

				if ($this->options['dirUrlOwn'] === true) {
					// Set `null` to use the client option `commandsOptions.info.nullUrlDirLinkSelf = true`
					$stat['url'] = null;
				} else {
					if ($this->options['dirUrlOwn'] === 'hide') {
						// to hide link in info dialog of the elFinder client
						$stat['url'] = '';
					}
				}
			} else {
				// for files - check for thumbnails
				$p = $stat['target'] ?? $path;

				if ($this->tmbURL && ! isset($stat['tmb']) && $this->canCreateTmb($p, $stat)) {
					$tmb         = $this->gettmb($p, $stat);
					$stat['tmb'] = $tmb ? $tmb : 1;
				}
			}

			if (! isset($stat['url']) && $this->URL && $this->encoding) {
				$_path       = str_replace($this->separator, '/', substr($path, strlen($this->root) + 1));
				$stat['url'] = rtrim($this->URL, '/') . '/' . str_replace('%2F', '/', rawurlencode((substr(PHP_OS, 0, 3) === 'WIN') ? $_path : $this->convEncIn($_path, true)));
			}
		} else {
			if ($isDir) {
				unset($stat['dirs']);
			}
		}

		if (! empty($stat['alias']) && ! empty($stat['target'])) {
			$stat['thash'] = $this->encode($stat['target']);
			//$this->cache[$stat['target']] = $stat;
			unset($stat['target']);
		}

		$this->cache[$path] = $stat;

		if (! $fromStat && $root && $this->sessionCaching['rootstat']) {
			// to update session cache
			$this->stat($path);
		}

		return $stat;
	}

	/**
	 * Get stat for folder content and put in cache.
	 *
	 * @param  string $path
	 *
	 * @return void
	 * @author Dmitry (dio) Levashov
	 **/
	protected function cacheDir($path) {
		$this->dirsCache[$path] = [];
		$hasDir                 = false;

		foreach ($this->scandirCE($path) as $p) {
			if (($stat = $this->stat($p)) && empty($stat['hidden'])) {
				if (! $hasDir && $stat['mime'] === 'directory') {
					$hasDir = true;
				}
				$this->dirsCache[$path][] = $p;
			}
		}

		$this->updateSubdirsCache($path, $hasDir);
	}

	/**
	 * Clean cache.
	 *
	 * @return void
	 * @author Dmitry (dio) Levashov
	 **/
	protected function clearcache() {
		$this->cache = $this->dirsCache = [];
	}

	/**
	 * Return file mimetype.
	 *
	 * @param  string      $path file path
	 * @param  string|bool $name
	 * @param  integer     $size
	 * @param  string      $mime was notified from the volume driver
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 */
	protected function mimetype($path, $name = '', $size = null, $mime = null) {
		$type      = '';
		$nameCheck = false;

		if ($name === '') {
			$name = $path;
		} else {
			if ($name === true) {
				$name      = $path;
				$nameCheck = true;
			}
		}

		if (! $this instanceof elFinderVolumeLocalFileSystem) {
			$nameCheck = true;
		}
		$ext = (false === $pos = strrpos($name, '.')) ? '' : strtolower(substr($name, $pos + 1));

		if (! $nameCheck && $size === null) {
			$size = file_exists($path) ? filesize($path) : -1;
		}

		if (! $nameCheck && is_readable($path) && $size > 0) {
			// detecting by contents
			if ($this->mimeDetect === 'finfo') {
				$type = finfo_file($this->finfo, $path);
			} else {
				if ($this->mimeDetect === 'mime_content_type') {
					$type = mime_content_type($path);
				}
			}

			if ($type) {
				$type = explode(';', $type);
				$type = trim($type[0]);

				if ($ext && preg_match('~^application/(?:octet-stream|(?:x-)?zip|xml)$~', $type)) {
					// load default MIME table file "mime.types"
					if (! elFinderVolumeDriver::$mimetypesLoaded) {
						elFinderVolumeDriver::loadMimeTypes();
					}

					if (isset(elFinderVolumeDriver::$mimetypes[$ext])) {
						$type = elFinderVolumeDriver::$mimetypes[$ext];
					}
				} else {
					if ($ext === 'js' && preg_match('~^text/~', $type)) {
						$type = 'text/javascript';
					}
				}
			}
		}

		if (! $type) {
			// detecting by filename
			$type = elFinderVolumeDriver::mimetypeInternalDetect($name);

			if ($type === 'unknown') {
				if ($mime) {
					$type = $mime;
				} else {
					$type = ($size == 0) ? 'text/plain' : $this->options['mimeTypeUnknown'];
				}
			}
		}

		// mime type normalization
		$type = $this->mimeTypeNormalize($type, $name, $ext);

		return $type;
	}

	/**
	 * Load file of mime.types.
	 *
	 * @param string $mimeTypesFile The mime types file
	 */
	static protected function loadMimeTypes($mimeTypesFile = '') {
		if (! elFinderVolumeDriver::$mimetypesLoaded) {
			elFinderVolumeDriver::$mimetypesLoaded = true;
			$file                                  = false;

			if (! empty($mimeTypesFile) && file_exists($mimeTypesFile)) {
				$file = $mimeTypesFile;
			} elseif (elFinder::$defaultMimefile && file_exists(elFinder::$defaultMimefile)) {
				$file = elFinder::$defaultMimefile;
			} elseif (file_exists(dirname(__FILE__) . DIRECTORY_SEPARATOR . 'mime.types')) {
				$file = dirname(__FILE__) . DIRECTORY_SEPARATOR . 'mime.types';
			} elseif (file_exists(dirname(dirname(__FILE__)) . DIRECTORY_SEPARATOR . 'mime.types')) {
				$file = dirname(dirname(__FILE__)) . DIRECTORY_SEPARATOR . 'mime.types';
			}

			if ($file && file_exists($file)) {
				$mimecf = file($file);

				foreach ($mimecf as $line_num => $line) {
					if (! preg_match('/^\s*#/', $line)) {
						$mime = preg_split('/\s+/', $line, -1, PREG_SPLIT_NO_EMPTY);

						for ($i = 1, $size = count($mime); $i < $size; $i++) {
							if (! isset(self::$mimetypes[$mime[$i]])) {
								self::$mimetypes[$mime[$i]] = $mime[0];
							}
						}
					}
				}
			}
		}
	}

	/**
	 * Detect file mimetype using "internal" method or Loading mime.types with $path = ''.
	 *
	 * @param  string $path file path
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	static protected function mimetypeInternalDetect($path = '') {
		// load default MIME table file "mime.types"
		if (! elFinderVolumeDriver::$mimetypesLoaded) {
			elFinderVolumeDriver::loadMimeTypes();
		}
		$ext = '';

		if ($path) {
			$pinfo = pathinfo($path);
			$ext   = isset($pinfo['extension']) ? strtolower($pinfo['extension']) : '';
		}
		$res = ($ext && isset(elFinderVolumeDriver::$mimetypes[$ext])) ? elFinderVolumeDriver::$mimetypes[$ext] : 'unknown';
		// Recursive check if MIME type is unknown with multiple extensions
		if ($res === 'unknown' && strpos($pinfo['filename'], '.')) {
			return elFinderVolumeDriver::mimetypeInternalDetect($pinfo['filename']);
		} else {
			return $res;
		}
	}

	/**
	 * Return file/total directory size infomation.
	 *
	 * @param  string $path file path
	 *
	 * @return array
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	protected function countSize($path) {
		elFinder::checkAborted();

		$result = ['size' => 0, 'files' => 0, 'dirs' => 0];
		$stat   = $this->stat($path);

		if (empty($stat) || ! $stat['read'] || ! empty($stat['hidden'])) {
			$result['size'] = 'unknown';

			return $result;
		}

		if ($stat['mime'] !== 'directory') {
			$result['size']  = intval($stat['size']);
			$result['files'] = 1;

			return $result;
		}

		$result['dirs']                   = 1;
		$subdirs                          = $this->options['checkSubfolders'];
		$this->options['checkSubfolders'] = true;

		foreach ($this->getScandir($path) as $stat) {
			if ($isDir = ($stat['mime'] === 'directory' && $stat['read'])) {
				++$result['dirs'];
			} else {
				++$result['files'];
			}
			$res = $isDir
				? $this->countSize($this->decode($stat['hash']))
				: (isset($stat['size']) ? ['size' => intval($stat['size'])] : []);

			if (! empty($res['size']) && is_numeric($res['size'])) {
				$result['size'] += $res['size'];
			}

			if (! empty($res['files']) && is_numeric($res['files'])) {
				$result['files'] += $res['files'];
			}

			if (! empty($res['dirs']) && is_numeric($res['dirs'])) {
				$result['dirs'] += $res['dirs'];
				--$result['dirs'];
			}
		}
		$this->options['checkSubfolders'] = $subdirs;

		return $result;
	}

	/**
	 * Return true if all mimes is directory or files.
	 *
	 * @param  string $mime1 mimetype
	 * @param  string $mime2 mimetype
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 **/
	protected function isSameType($mime1, $mime2) {
		return ($mime1 == 'directory' && $mime1 == $mime2) || ($mime1 != 'directory' && $mime2 != 'directory');
	}

	/**
	 * If file has required attr == $val - return file path,
	 * If dir has child with has required attr == $val - return child path.
	 *
	 * @param  string $path file path
	 * @param  string $attr attribute name
	 * @param  bool   $val  attribute value
	 *
	 * @return string|false
	 * @author Dmitry (dio) Levashov
	 **/
	protected function closestByAttr($path, $attr, $val) {
		$stat = $this->stat($path);

		if (empty($stat)) {
			return false;
		}

		$v = $stat[$attr] ?? false;

		if ($v == $val) {
			return $path;
		}

		return $stat['mime'] == 'directory'
			? $this->childsByAttr($path, $attr, $val)
			: false;
	}

	/**
	 * Return first found children with required attr == $val.
	 *
	 * @param  string $path file path
	 * @param  string $attr attribute name
	 * @param  bool   $val  attribute value
	 *
	 * @return string|false
	 * @author Dmitry (dio) Levashov
	 **/
	protected function childsByAttr($path, $attr, $val) {
		foreach ($this->scandirCE($path) as $p) {
			if (($_p = $this->closestByAttr($p, $attr, $val)) != false) {
				return $_p;
			}
		}

		return false;
	}

	protected function isMyReload($target = '', $ARGtarget = '') {
		if ($this->rootModified || (! empty($this->ARGS['cmd']) && $this->ARGS['cmd'] === 'parents')) {
			return true;
		}

		if (! empty($this->ARGS['reload'])) {
			if ($ARGtarget === '') {
				$ARGtarget = $this->ARGS['target']
					?? ((isset($this->ARGS['targets']) && is_array($this->ARGS['targets']) && count($this->ARGS['targets']) === 1) ?
						$this->ARGS['targets'][0] : '');
			}

			if ($ARGtarget !== '') {
				$ARGtarget = strval($ARGtarget);

				if ($target === '') {
					return (strpos($ARGtarget, $this->id) === 0);
				} else {
					$target = strval($target);

					return ($target === $ARGtarget);
				}
			}
		}

		return false;
	}

	/**
	 * Update subdirs cache data.
	 *
	 * @param string $path
	 * @param bool   $subdirs
	 *
	 * @return void
	 */
	protected function updateSubdirsCache($path, $subdirs) {
		if (isset($this->cache[$path])) {
			if ($subdirs) {
				$this->cache[$path]['dirs'] = 1;
			} else {
				unset($this->cache[$path]['dirs']);
			}
		}

		if ($this->sessionCaching['subdirs']) {
			$this->sessionCache['subdirs'][$path] = $subdirs;
		}

		if ($this->sessionCaching['rootstat'] && $path == $this->root) {
			unset($this->sessionCache['rootstat'][$this->getRootstatCachekey()]);
		}
	}

	/*****************  get content *******************/

	/**
	 * Return required dir's files info.
	 * If onlyMimes is set - return only dirs and files of required mimes.
	 *
	 * @param  string $path dir path
	 *
	 * @return array
	 * @author Dmitry (dio) Levashov
	 **/
	protected function getScandir($path) {
		$files = [];

		! isset($this->dirsCache[$path]) && $this->cacheDir($path);

		foreach ($this->dirsCache[$path] as $p) {
			if (($stat = $this->stat($p)) && empty($stat['hidden'])) {
				$files[] = $stat;
			}
		}

		return $files;
	}

	/**
	 * Return subdirs tree.
	 *
	 * @param  string $path parent dir path
	 * @param  int    $deep tree deep
	 * @param string  $exclude
	 *
	 * @return array
	 * @author Dmitry (dio) Levashov
	 */
	protected function gettree($path, $deep, $exclude = '') {
		$dirs = [];

		! isset($this->dirsCache[$path]) && $this->cacheDir($path);

		foreach ($this->dirsCache[$path] as $p) {
			$stat = $this->stat($p);

			if ($stat && empty($stat['hidden']) && $p != $exclude && $stat['mime'] == 'directory') {
				$dirs[] = $stat;

				if ($deep > 0 && ! empty($stat['dirs'])) {
					$dirs = array_merge($dirs, $this->gettree($p, $deep - 1));
				}
			}
		}

		return $dirs;
	}

	/**
	 * Recursive files search.
	 *
	 * @param  string $path dir path
	 * @param  string $q    search string
	 * @param  array  $mimes
	 *
	 * @return array
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	protected function doSearch($path, $q, $mimes) {
		$result      = [];
		$matchMethod = empty($this->doSearchCurrentQuery['matchMethod']) ? 'searchMatchName' : $this->doSearchCurrentQuery['matchMethod'];
		$timeout     = $this->options['searchTimeout'] ? $this->searchStart + $this->options['searchTimeout'] : 0;

		if ($timeout && $timeout < time()) {
			$this->setError(elFinder::ERROR_SEARCH_TIMEOUT, $this->path($this->encode($path)));

			return $result;
		}

		foreach ($this->scandirCE($path) as $p) {
			elFinder::extendTimeLimit($this->options['searchTimeout'] + 30);

			if ($timeout && ($this->error || $timeout < time())) {
				! $this->error && $this->setError(elFinder::ERROR_SEARCH_TIMEOUT, $this->path($this->encode($path)));

				break;
			}

			$stat = $this->stat($p);

			if (! $stat) { // invalid links
				continue;
			}

			if (! empty($stat['hidden']) || ! $this->mimeAccepted($stat['mime'], $mimes)) {
				continue;
			}

			$name = $stat['name'];

			if ($this->doSearchCurrentQuery['excludes']) {
				foreach ($this->doSearchCurrentQuery['excludes'] as $exclude) {
					if ($this->stripos($name, $exclude) !== false) {
						continue 2;
					}
				}
			}

			if ((! $mimes || $stat['mime'] !== 'directory') && $this->$matchMethod($name, $q, $p) !== false) {
				$stat['path'] = $this->path($stat['hash']);

				if ($this->URL && ! isset($stat['url'])) {
					$path = str_replace($this->separator, '/', substr($p, strlen($this->root) + 1));

					if ($this->encoding) {
						$path = str_replace('%2F', '/', rawurlencode($this->convEncIn($path, true)));
					} else {
						$path = str_replace('%2F', '/', rawurlencode($path));
					}
					$stat['url'] = $this->URL . $path;
				}

				$result[] = $stat;
			}

			if ($stat['mime'] == 'directory' && $stat['read'] && ! isset($stat['alias'])) {
				if (! $this->options['searchExDirReg'] || ! preg_match($this->options['searchExDirReg'], $p)) {
					$result = array_merge($result, $this->doSearch($p, $q, $mimes));
				}
			}
		}

		return $result;
	}

	/**********************  manuipulations  ******************/

	/**
	 * Copy file/recursive copy dir only in current volume.
	 * Return new file path or false.
	 *
	 * @param  string $src  source path
	 * @param  string $dst  destination dir path
	 * @param  string $name new file name (optionaly)
	 *
	 * @return string|false
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	protected function copy($src, $dst, $name) {
		elFinder::checkAborted();

		$srcStat = $this->stat($src);

		if (! empty($srcStat['thash'])) {
			$target = $this->decode($srcStat['thash']);

			if (! $this->inpathCE($target, $this->root)) {
				return $this->setError(elFinder::ERROR_COPY, $this->path($srcStat['hash']), elFinder::ERROR_MKOUTLINK);
			}
			$stat = $this->stat($target);
			$this->clearcache();

			return $stat && $this->symlinkCE($target, $dst, $name)
				? $this->joinPathCE($dst, $name)
				: $this->setError(elFinder::ERROR_COPY, $this->path($srcStat['hash']));
		}

		if ($srcStat['mime'] === 'directory') {
			$testStat = $this->isNameExists($this->joinPathCE($dst, $name));
			$this->clearcache();

			if (($testStat && $testStat['mime'] !== 'directory') || (! $testStat && ! $testStat = $this->mkdir($this->encode($dst), $name))) {
				return $this->setError(elFinder::ERROR_COPY, $this->path($srcStat['hash']));
			}

			$dst = $this->decode($testStat['hash']);

			// start time
			$stime = microtime(true);

			foreach ($this->getScandir($src) as $stat) {
				if (empty($stat['hidden'])) {
					// current time
					$ctime = microtime(true);

					if (($ctime - $stime) > 2) {
						$stime = $ctime;
						elFinder::checkAborted();
					}
					$name = $stat['name'];
					$_src = $this->decode($stat['hash']);

					if (! $this->copy($_src, $dst, $name)) {
						$this->remove($dst, true); // fall back

						return $this->setError($this->error, elFinder::ERROR_COPY, $this->_path($src));
					}
				}
			}

			$this->added[] = $testStat;

			return $dst;
		}

		if ($this->options['copyJoin']) {
			$test = $this->joinPathCE($dst, $name);

			if ($this->isNameExists($test)) {
				$this->remove($test);
			}
		}

		if ($res = $this->convEncOut($this->_copy($this->convEncIn($src), $this->convEncIn($dst), $this->convEncIn($name)))) {
			$path = is_string($res) ? $res : $this->joinPathCE($dst, $name);
			$this->clearstatcache();
			$this->added[] = $this->stat($path);

			return $path;
		}

		return $this->setError(elFinder::ERROR_COPY, $this->path($srcStat['hash']));
	}

	/**
	 * Move file
	 * Return new file path or false.
	 *
	 * @param  string $src  source path
	 * @param  string $dst  destination dir path
	 * @param  string $name new file name
	 *
	 * @return string|false
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	protected function move($src, $dst, $name) {
		$stat             = $this->stat($src);
		$stat['realpath'] = $src;
		$this->rmTmb($stat); // can not do rmTmb() after _move()
		$this->clearcache();

		$res = $this->convEncOut($this->_move($this->convEncIn($src), $this->convEncIn($dst), $this->convEncIn($name)));
		// if moving it didn't work try to copy / delete
		if (! $res) {
			if ($this->copy($src, $dst, $name)) {
				$res = $this->remove($src);
			}
		}

		if ($res) {
			$this->clearstatcache();

			if ($stat['mime'] === 'directory') {
				$this->updateSubdirsCache($dst, true);
			}
			$path            = is_string($res) ? $res : $this->joinPathCE($dst, $name);
			$this->added[]   = $this->stat($path);
			$this->removed[] = $stat;

			return $path;
		}

		return $this->setError(elFinder::ERROR_MOVE, $this->path($stat['hash']));
	}

	/**
	 * Copy file from another volume.
	 * Return new file path or false.
	 *
	 * @param  Object $volume      source volume
	 * @param  string $src         source file hash
	 * @param  string $destination destination dir path
	 * @param  string $name        file name
	 *
	 * @return string|false
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	protected function copyFrom($volume, $src, $destination, $name) {
		elFinder::checkAborted();

		if (($source = $volume->file($src)) == false) {
			return $this->addError(elFinder::ERROR_COPY, '#' . $src, $volume->error());
		}

		$srcIsDir = ($source['mime'] === 'directory');

		$errpath = $volume->path($source['hash']);

		$errors = [];

		try {
			$thash = $this->encode($destination);
			elFinder::$instance->trigger('paste.copyfrom', [&$thash, &$name, '', elFinder::$instance, $this], $errors);
		} catch (elFinderTriggerException $e) {
			return $this->addError(elFinder::ERROR_COPY, $name, $errors);
		}

		if (! $this->nameAccepted($name, $srcIsDir)) {
			return $this->addError(elFinder::ERROR_COPY, $name, $srcIsDir ? elFinder::ERROR_INVALID_DIRNAME : elFinder::ERROR_INVALID_NAME);
		}

		if (! $this->allowCreate($destination, $name, $srcIsDir)) {
			return $this->addError(elFinder::ERROR_COPY, $name, elFinder::ERROR_PERM_DENIED);
		}

		if (! $source['read']) {
			return $this->addError(elFinder::ERROR_COPY, $errpath, elFinder::ERROR_PERM_DENIED);
		}

		if ($srcIsDir) {
			$test = $this->isNameExists($this->joinPathCE($destination, $name));
			$this->clearcache();

			if (($test && $test['mime'] != 'directory') || (! $test && ! $test = $this->mkdir($this->encode($destination), $name))) {
				return $this->addError(elFinder::ERROR_COPY, $errpath);
			}

			//$path = $this->joinPathCE($destination, $name);
			$path = $this->decode($test['hash']);

			foreach ($volume->scandir($src) as $entr) {
				$this->copyFrom($volume, $entr['hash'], $path, $entr['name']);
			}

			$this->added[] = $test;
		} else {
			// size check
			if (! isset($source['size']) || $source['size'] > $this->uploadMaxSize) {
				return $this->setError(elFinder::ERROR_UPLOAD_FILE_SIZE);
			}

			// MIME check
			$mimeByName = $this->mimetype($source['name'], true);

			if ($source['mime'] === $mimeByName) {
				$mimeByName = '';
			}

			if (! $this->allowPutMime($source['mime']) || ($mimeByName && ! $this->allowPutMime($mimeByName))) {
				return $this->addError(elFinder::ERROR_UPLOAD_FILE_MIME, $errpath);
			}

			if (strpos($source['mime'], 'image') === 0 && ($dim = $volume->dimensions($src))) {
				if (is_array($dim)) {
					$dim = $dim['dim'] ?? null;
				}

				if ($dim) {
					$s                = explode('x', $dim);
					$source['width']  = $s[0];
					$source['height'] = $s[1];
				}
			}

			if (($fp = $volume->open($src)) == false
				|| ($path = $this->saveCE($fp, $destination, $name, $source)) == false) {
				$fp && $volume->close($fp, $src);

				return $this->addError(elFinder::ERROR_COPY, $errpath);
			}
			$volume->close($fp, $src);

			$this->added[] = $this->stat($path);
		}

		return $path;
	}

	/**
	 * Remove file/ recursive remove dir.
	 *
	 * @param  string $path  file path
	 * @param  bool   $force try to remove even if file locked
	 *
	 * @return bool
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 */
	protected function remove($path, $force = false) {
		$stat = $this->stat($path);

		if (empty($stat)) {
			return $this->setError(elFinder::ERROR_RM, $this->relpathCE($path), elFinder::ERROR_FILE_NOT_FOUND);
		}

		$stat['realpath'] = $path;
		$this->rmTmb($stat);
		$this->clearcache();

		if (! $force && ! empty($stat['locked'])) {
			return $this->setError(elFinder::ERROR_LOCKED, $this->path($stat['hash']));
		}

		if ($stat['mime'] == 'directory' && empty($stat['thash'])) {
			$ret = $this->delTree($this->convEncIn($path));
			$this->convEncOut();

			if (! $ret) {
				return $this->setError(elFinder::ERROR_RM, $this->path($stat['hash']));
			}
		} else {
			if ($this->convEncOut(! $this->_unlink($this->convEncIn($path)))) {
				return $this->setError(elFinder::ERROR_RM, $this->path($stat['hash']));
			}
			$this->clearstatcache();
		}

		$this->removed[] = $stat;

		return true;
	}

	/************************* thumbnails **************************/

	/**
	 * Return thumbnail file name for required file.
	 *
	 * @param  array $stat file stat
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	protected function tmbname($stat) {
		$name = $stat['hash'] . ($stat['ts'] ?? '') . '.png';

		if (strlen($name) > 255) {
			$name = $this->id . md5($stat['hash']) . $stat['ts'] . '.png';
		}

		return $name;
	}

	/**
	 * Return thumnbnail name if exists.
	 *
	 * @param  string $path file path
	 * @param  array  $stat file stat
	 *
	 * @return string|false
	 * @author Dmitry (dio) Levashov
	 **/
	protected function gettmb($path, $stat) {
		if ($this->tmbURL && $this->tmbPath) {
			// file itself thumnbnail
			if (strpos($path, $this->tmbPath) === 0) {
				return basename($path);
			}

			$name = $this->tmbname($stat);
			$tmb  = $this->tmbPath . DIRECTORY_SEPARATOR . $name;

			if (file_exists($tmb)) {
				if ($this->options['tmbGcMaxlifeHour'] && $this->options['tmbGcPercentage'] > 0) {
					touch($tmb);
				}

				return $name;
			}
		}

		return false;
	}

	/**
	 * Return true if thumnbnail for required file can be created.
	 *
	 * @param  string $path thumnbnail path
	 * @param  array  $stat file stat
	 * @param  bool   $checkTmbPath
	 *
	 * @return string|bool
	 * @author Dmitry (dio) Levashov
	 **/
	protected function canCreateTmb($path, $stat, $checkTmbPath = true) {
		static $gdMimes = null;
		static $imgmgPS = null;

		if ($gdMimes === null) {
			$_mimes = ['image/jpeg', 'image/png', 'image/gif', 'image/x-ms-bmp'];

			if (function_exists('imagecreatefromwebp')) {
				$_mimes[] = 'image/webp';
			}
			$gdMimes = array_flip($_mimes);
			$imgmgPS = array_flip(['application/postscript', 'application/pdf']);
		}

		if ((! $checkTmbPath || $this->tmbPathWritable)
			&& (! $this->tmbPath || strpos($path, $this->tmbPath) === false) // do not create thumnbnail for thumnbnail
		) {
			$mime       = strtolower($stat['mime']);
			list($type) = explode('/', $mime);

			if (! empty($this->imgConverter)) {
				if (isset($this->imgConverter[$mime])) {
					return true;
				}

				if (isset($this->imgConverter[$type])) {
					return true;
				}
			}

			return $this->imgLib
				&& (
					($type === 'image' && ($this->imgLib === 'gd' ? isset($gdMimes[$stat['mime']]) : true))
					||
					(ELFINDER_IMAGEMAGICK_PS && isset($imgmgPS[$stat['mime']]) && $this->imgLib !== 'gd')
				);
		}

		return false;
	}

	/**
	 * Return true if required file can be resized.
	 * By default - the same as canCreateTmb.
	 *
	 * @param  string $path thumnbnail path
	 * @param  array  $stat file stat
	 *
	 * @return string|bool
	 * @author Dmitry (dio) Levashov
	 **/
	protected function canResize($path, $stat) {
		return $this->canCreateTmb($path, $stat, false);
	}

	/**
	 * Create thumnbnail and return it's URL on success.
	 *
	 * @param  string $path file path
	 * @param         $stat
	 *
	 * @return false|string
	 * @internal param string $mime file mime type
	 * @throws elFinderAbortException
	 * @throws ImagickException
	 * @author   Dmitry (dio) Levashov
	 */
	protected function createTmb($path, $stat) {
		if (! $stat || ! $this->canCreateTmb($path, $stat)) {
			return false;
		}

		$name = $this->tmbname($stat);
		$tmb  = $this->tmbPath . DIRECTORY_SEPARATOR . $name;

		$maxlength    = -1;
		$imgConverter = null;

		// check imgConverter
		$mime       = strtolower($stat['mime']);
		list($type) = explode('/', $mime);

		if (isset($this->imgConverter[$mime])) {
			$imgConverter = $this->imgConverter[$mime]['func'];

			if (! empty($this->imgConverter[$mime]['maxlen'])) {
				$maxlength = intval($this->imgConverter[$mime]['maxlen']);
			}
		} else {
			if (isset($this->imgConverter[$type])) {
				$imgConverter = $this->imgConverter[$type]['func'];

				if (! empty($this->imgConverter[$type]['maxlen'])) {
					$maxlength = intval($this->imgConverter[$type]['maxlen']);
				}
			}
		}

		if ($imgConverter && ! is_callable($imgConverter)) {
			return false;
		}

		// copy image into tmbPath so some drivers does not store files on local fs
		if (($src = $this->fopenCE($path, 'rb')) == false) {
			return false;
		}

		if (($trg = fopen($tmb, 'wb')) == false) {
			$this->fcloseCE($src, $path);

			return false;
		}

		stream_copy_to_stream($src, $trg, $maxlength);

		$this->fcloseCE($src, $path);
		fclose($trg);

		// call imgConverter
		if ($imgConverter) {
			if (! call_user_func_array($imgConverter, [$tmb, $stat, $this])) {
				file_exists($tmb) && unlink($tmb);

				return false;
			}
		}

		$result = false;

		$tmbSize = $this->tmbSize;

		if ($this->imgLib === 'imagick') {
			try {
				$imagickTest = new imagick($tmb . '[0]');
				$imagickTest->clear();
				$imagickTest = true;
			} catch (Exception $e) {
				$imagickTest = false;
			}
		}

		if (($this->imgLib === 'imagick' && ! $imagickTest) || ($s = getimagesize($tmb)) === false) {
			if ($this->imgLib === 'imagick') {
				$bgcolor = $this->options['tmbBgColor'];

				if ($bgcolor === 'transparent') {
					$bgcolor = 'rgba(255, 255, 255, 0.0)';
				}

				try {
					$imagick = new imagick();
					$imagick->setBackgroundColor(new ImagickPixel($bgcolor));
					$imagick->readImage($this->getExtentionByMime($stat['mime'], ':') . $tmb . '[0]');

					try {
						$imagick->trimImage(0);
					} catch (Exception $e) {
					}
					$imagick->setImageFormat('png');
					$imagick->writeImage($tmb);
					$imagick->clear();

					if (($s = getimagesize($tmb)) !== false) {
						$result = true;
					}
				} catch (Exception $e) {
				}
			} else {
				if ($this->imgLib === 'convert') {
					$convParams = $this->imageMagickConvertPrepare($tmb, 'png', 100, [], $stat['mime']);
					$cmd        = sprintf('%s -colorspace sRGB -trim -- %s %s', ELFINDER_CONVERT_PATH, $convParams['quotedPath'], $convParams['quotedDstPath']);
					$result     = false;

					if ($this->procExec($cmd) === 0) {
						if (($s = getimagesize($tmb)) !== false) {
							$result = true;
						}
					}
				}
			}

			if (! $result) {
				// fallback imgLib to GD
				if (function_exists('gd_info') && ($s = getimagesize($tmb))) {
					$this->imgLib = 'gd';
				} else {
					file_exists($tmb) && unlink($tmb);

					return false;
				}
			}
		}

		/* If image smaller or equal thumbnail size - just fitting to thumbnail square */
		if ($s[0] <= $tmbSize && $s[1] <= $tmbSize) {
			$result = $this->imgSquareFit($tmb, $tmbSize, $tmbSize, 'center', 'middle', $this->options['tmbBgColor'], 'png');
		} else {
			if ($this->options['tmbCrop']) {
				$result = $tmb;
				/* Resize and crop if image bigger than thumbnail */
				if (! (($s[0] > $tmbSize && $s[1] <= $tmbSize) || ($s[0] <= $tmbSize && $s[1] > $tmbSize)) || ($s[0] > $tmbSize && $s[1] > $tmbSize)) {
					$result = $this->imgResize($tmb, $tmbSize, $tmbSize, true, false, 'png');
				}

				if ($result && ($s = getimagesize($tmb)) != false) {
					$x      = $s[0] > $tmbSize ? intval(($s[0] - $tmbSize) / 2) : 0;
					$y      = $s[1] > $tmbSize ? intval(($s[1] - $tmbSize) / 2) : 0;
					$result = $this->imgCrop($result, $tmbSize, $tmbSize, $x, $y, 'png');
				} else {
					$result = false;
				}
			} else {
				$result = $this->imgResize($tmb, $tmbSize, $tmbSize, true, true, 'png');
			}

			if ($result) {
				if ($s = getimagesize($tmb)) {
					if ($s[0] !== $tmbSize || $s[1] !== $tmbSize) {
						$result = $this->imgSquareFit($result, $tmbSize, $tmbSize, 'center', 'middle', $this->options['tmbBgColor'], 'png');
					}
				}
			}
		}

		if (! $result) {
			unlink($tmb);

			return false;
		}

		return $name;
	}

	/**
	 * Resize image.
	 *
	 * @param  string $path               image file
	 * @param  int    $width              new width
	 * @param  int    $height             new height
	 * @param  bool   $keepProportions    crop image
	 * @param  bool   $resizeByBiggerSide resize image based on bigger side if true
	 * @param  string $destformat         image destination format
	 * @param  int    $jpgQuality         JEPG quality (1-100)
	 * @param  array  $options            Other extra options
	 *
	 * @return string|false
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 * @author Alexey Sukhotin
	 */
	protected function imgResize($path, $width, $height, $keepProportions = false, $resizeByBiggerSide = true, $destformat = null, $jpgQuality = null, $options = []) {
		if (($s = getimagesize($path)) == false) {
			return false;
		}

		if (! $jpgQuality) {
			$jpgQuality = $this->options['jpgQuality'];
		}

		list($orig_w, $orig_h) = [$s[0], $s[1]];
		list($size_w, $size_h) = [$width, $height];

		if (empty($options['unenlarge']) || $orig_w > $size_w || $orig_h > $size_h) {
			if ($keepProportions == true) {
				/* Resizing by biggest side */
				if ($resizeByBiggerSide) {
					if ($orig_w > $orig_h) {
						$size_h = round($orig_h * $width / $orig_w);
						$size_w = $width;
					} else {
						$size_w = round($orig_w * $height / $orig_h);
						$size_h = $height;
					}
				} else {
					if ($orig_w > $orig_h) {
						$size_w = round($orig_w * $height / $orig_h);
						$size_h = $height;
					} else {
						$size_h = round($orig_h * $width / $orig_w);
						$size_w = $width;
					}
				}
			}
		} else {
			$size_w = $orig_w;
			$size_h = $orig_h;
		}

		elFinder::extendTimeLimit(300);

		switch ($this->imgLib) {
			case 'imagick':
				try {
					$img = new imagick($path);
				} catch (Exception $e) {
					return false;
				}

				// Imagick::FILTER_BOX faster than FILTER_LANCZOS so use for createTmb
				// resize bench: http://app-mgng.rhcloud.com/9
				// resize sample: http://www.dylanbeattie.net/magick/filters/result.html
				$filter = ($destformat === 'png' /* createTmb */) ? Imagick::FILTER_BOX : Imagick::FILTER_LANCZOS;

				$ani = ($img->getNumberImages() > 1);

				if ($ani && is_null($destformat)) {
					$img = $img->coalesceImages();

					do {
						$img->resizeImage($size_w, $size_h, $filter, 1);
					} while ($img->nextImage());
					$img->optimizeImageLayers();
					$result = $img->writeImages($path, true);
				} else {
					if ($ani) {
						$img->setFirstIterator();
					}

					if (strtoupper($img->getImageFormat()) === 'JPEG') {
						$img->setImageCompression(imagick::COMPRESSION_JPEG);
						$img->setImageCompressionQuality($jpgQuality);

						if (isset($options['preserveExif']) && ! $options['preserveExif']) {
							try {
								$orientation = $img->getImageOrientation();
							} catch (ImagickException $e) {
								$orientation = 0;
							}
							$img->stripImage();

							if ($orientation) {
								$img->setImageOrientation($orientation);
							}
						}

						if ($this->options['jpgProgressive']) {
							$img->setInterlaceScheme(Imagick::INTERLACE_PLANE);
						}
					}
					$img->resizeImage($size_w, $size_h, $filter, true);

					if ($destformat) {
						$result = $this->imagickImage($img, $path, $destformat, $jpgQuality);
					} else {
						$result = $img->writeImage($path);
					}
				}

				$img->clear();

				return $result ? $path : false;

				break;

			case 'convert':
				extract($this->imageMagickConvertPrepare($path, $destformat, $jpgQuality, $s));
				/**
				 * @var string $ani
				 * @var string $index
				 * @var string $coalesce
				 * @var string $deconstruct
				 * @var string $jpgQuality
				 * @var string $quotedPath
				 * @var string $quotedDstPath
				 * @var string $interlace
				 */
				$filter = ($destformat === 'png' /* createTmb */) ? '-filter Box' : '-filter Lanczos';
				$strip  = (isset($options['preserveExif']) && ! $options['preserveExif']) ? ' -strip' : '';
				$cmd    = sprintf('%s %s%s%s%s%s %s -geometry %dx%d! %s %s', ELFINDER_CONVERT_PATH, $quotedPath, $coalesce, $jpgQuality, $strip, $interlace, $filter, $size_w, $size_h, $deconstruct, $quotedDstPath);

				$result = false;

				if ($this->procExec($cmd) === 0) {
					$result = true;
				}

				return $result ? $path : false;

				break;

			case 'gd':
				elFinder::expandMemoryForGD([$s, [$size_w, $size_h]]);
				$img = $this->gdImageCreate($path, $s['mime']);

				if ($img && false != ($tmp = imagecreatetruecolor($size_w, $size_h))) {
					$bgNum = false;

					if ($s[2] === IMAGETYPE_GIF && (! $destformat || $destformat === 'gif')) {
						$bgIdx = imagecolortransparent($img);

						if ($bgIdx !== -1) {
							$c     = imagecolorsforindex($img, $bgIdx);
							$bgNum = imagecolorallocate($tmp, $c['red'], $c['green'], $c['blue']);
							imagefill($tmp, 0, 0, $bgNum);
							imagecolortransparent($tmp, $bgNum);
						}
					}

					if ($bgNum === false) {
						$this->gdImageBackground($tmp, 'transparent');
					}

					if (! imagecopyresampled($tmp, $img, 0, 0, 0, 0, $size_w, $size_h, $s[0], $s[1])) {
						return false;
					}

					$result = $this->gdImage($tmp, $path, $destformat, $s['mime'], $jpgQuality);

					imagedestroy($img);
					imagedestroy($tmp);

					return $result ? $path : false;
				}

				break;
		}

		return false;
	}

	/**
	 * Crop image.
	 *
	 * @param  string $path       image file
	 * @param  int    $width      crop width
	 * @param  int    $height     crop height
	 * @param  bool   $x          crop left offset
	 * @param  bool   $y          crop top offset
	 * @param  string $destformat image destination format
	 * @param  int    $jpgQuality JEPG quality (1-100)
	 *
	 * @return string|false
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 * @author Alexey Sukhotin
	 */
	protected function imgCrop($path, $width, $height, $x, $y, $destformat = null, $jpgQuality = null) {
		if (($s = getimagesize($path)) == false) {
			return false;
		}

		if (! $jpgQuality) {
			$jpgQuality = $this->options['jpgQuality'];
		}

		elFinder::extendTimeLimit(300);

		switch ($this->imgLib) {
			case 'imagick':
				try {
					$img = new imagick($path);
				} catch (Exception $e) {
					return false;
				}

				$ani = ($img->getNumberImages() > 1);

				if ($ani && is_null($destformat)) {
					$img = $img->coalesceImages();

					do {
						$img->setImagePage($s[0], $s[1], 0, 0);
						$img->cropImage($width, $height, $x, $y);
						$img->setImagePage($width, $height, 0, 0);
					} while ($img->nextImage());
					$img->optimizeImageLayers();
					$result = $img->writeImages($path, true);
				} else {
					if ($ani) {
						$img->setFirstIterator();
					}
					$img->setImagePage($s[0], $s[1], 0, 0);
					$img->cropImage($width, $height, $x, $y);
					$img->setImagePage($width, $height, 0, 0);
					$result = $this->imagickImage($img, $path, $destformat, $jpgQuality);
				}

				$img->clear();

				return $result ? $path : false;

				break;

			case 'convert':
				extract($this->imageMagickConvertPrepare($path, $destformat, $jpgQuality, $s));
				/**
				 * @var string $ani
				 * @var string $index
				 * @var string $coalesce
				 * @var string $deconstruct
				 * @var string $jpgQuality
				 * @var string $quotedPath
				 * @var string $quotedDstPath
				 * @var string $interlace
				 */
				$cmd = sprintf('%s %s%s%s%s -crop %dx%d+%d+%d%s %s', ELFINDER_CONVERT_PATH, $quotedPath, $coalesce, $jpgQuality, $interlace, $width, $height, $x, $y, $deconstruct, $quotedDstPath);

				$result = false;

				if ($this->procExec($cmd) === 0) {
					$result = true;
				}

				return $result ? $path : false;

				break;

			case 'gd':
				elFinder::expandMemoryForGD([$s, [$width, $height]]);
				$img = $this->gdImageCreate($path, $s['mime']);

				if ($img && false != ($tmp = imagecreatetruecolor($width, $height))) {
					$bgNum = false;

					if ($s[2] === IMAGETYPE_GIF && (! $destformat || $destformat === 'gif')) {
						$bgIdx = imagecolortransparent($img);

						if ($bgIdx !== -1) {
							$c     = imagecolorsforindex($img, $bgIdx);
							$bgNum = imagecolorallocate($tmp, $c['red'], $c['green'], $c['blue']);
							imagefill($tmp, 0, 0, $bgNum);
							imagecolortransparent($tmp, $bgNum);
						}
					}

					if ($bgNum === false) {
						$this->gdImageBackground($tmp, 'transparent');
					}

					$size_w = $width;
					$size_h = $height;

					if ($s[0] < $width || $s[1] < $height) {
						$size_w = $s[0];
						$size_h = $s[1];
					}

					if (! imagecopy($tmp, $img, 0, 0, $x, $y, $size_w, $size_h)) {
						return false;
					}

					$result = $this->gdImage($tmp, $path, $destformat, $s['mime'], $jpgQuality);

					imagedestroy($img);
					imagedestroy($tmp);

					return $result ? $path : false;
				}

				break;
		}

		return false;
	}

	/**
	 * Put image to square.
	 *
	 * @param  string    $path       image file
	 * @param  int       $width      square width
	 * @param  int       $height     square height
	 * @param int|string $align      reserved
	 * @param int|string $valign     reserved
	 * @param  string    $bgcolor    square background color in #rrggbb format
	 * @param  string    $destformat image destination format
	 * @param  int       $jpgQuality JEPG quality (1-100)
	 *
	 * @return false|string
	 * @throws ImagickException
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 * @author Alexey Sukhotin
	 */
	protected function imgSquareFit($path, $width, $height, $align = 'center', $valign = 'middle', $bgcolor = '#0000ff', $destformat = null, $jpgQuality = null) {
		if (($s = getimagesize($path)) == false) {
			return false;
		}

		$result = false;

		/* Coordinates for image over square aligning */
		$y = ceil(abs($height - $s[1]) / 2);
		$x = ceil(abs($width - $s[0]) / 2);

		if (! $jpgQuality) {
			$jpgQuality = $this->options['jpgQuality'];
		}

		elFinder::extendTimeLimit(300);

		switch ($this->imgLib) {
			case 'imagick':
				try {
					$img = new imagick($path);
				} catch (Exception $e) {
					return false;
				}

				if ($bgcolor === 'transparent') {
					$bgcolor = 'rgba(255, 255, 255, 0.0)';
				}
				$ani = ($img->getNumberImages() > 1);

				if ($ani && is_null($destformat)) {
					$img1 = new Imagick();
					$img1->setFormat('gif');
					$img = $img->coalesceImages();

					do {
						$gif = new Imagick();
						$gif->newImage($width, $height, new ImagickPixel($bgcolor));
						$gif->setImageColorspace($img->getImageColorspace());
						$gif->setImageFormat('gif');
						$gif->compositeImage($img, imagick::COMPOSITE_OVER, $x, $y);
						$gif->setImageDelay($img->getImageDelay());
						$gif->setImageIterations($img->getImageIterations());
						$img1->addImage($gif);
						$gif->clear();
					} while ($img->nextImage());
					$img1->optimizeImageLayers();
					$result = $img1->writeImages($path, true);
				} else {
					if ($ani) {
						$img->setFirstIterator();
					}
					$img1 = new Imagick();
					$img1->newImage($width, $height, new ImagickPixel($bgcolor));
					$img1->setImageColorspace($img->getImageColorspace());
					$img1->compositeImage($img, imagick::COMPOSITE_OVER, $x, $y);
					$result = $this->imagickImage($img1, $path, $destformat, $jpgQuality);
				}

				$img1->clear();
				$img->clear();

				return $result ? $path : false;

				break;

			case 'convert':
				extract($this->imageMagickConvertPrepare($path, $destformat, $jpgQuality, $s));
				/**
				 * @var string $ani
				 * @var string $index
				 * @var string $coalesce
				 * @var string $deconstruct
				 * @var string $jpgQuality
				 * @var string $quotedPath
				 * @var string $quotedDstPath
				 * @var string $interlace
				 */
				if ($bgcolor === 'transparent') {
					$bgcolor = 'rgba(255, 255, 255, 0.0)';
				}
				$cmd = sprintf('%s -size %dx%d "xc:%s" png:- | convert%s%s%s png:-  %s -geometry +%d+%d -compose over -composite%s %s', ELFINDER_CONVERT_PATH, $width, $height, $bgcolor, $coalesce, $jpgQuality, $interlace, $quotedPath, $x, $y, $deconstruct, $quotedDstPath);

				$result = false;

				if ($this->procExec($cmd) === 0) {
					$result = true;
				}

				return $result ? $path : false;

				break;

			case 'gd':
				elFinder::expandMemoryForGD([$s, [$width, $height]]);
				$img = $this->gdImageCreate($path, $s['mime']);

				if ($img && false != ($tmp = imagecreatetruecolor($width, $height))) {
					$this->gdImageBackground($tmp, $bgcolor);

					if ($bgcolor === 'transparent' && ($destformat === 'png' || $s[2] === IMAGETYPE_PNG)) {
						$bgNum = imagecolorallocatealpha($tmp, 255, 255, 255, 127);
						imagefill($tmp, 0, 0, $bgNum);
					}

					if (! imagecopy($tmp, $img, $x, $y, 0, 0, $s[0], $s[1])) {
						return false;
					}

					$result = $this->gdImage($tmp, $path, $destformat, $s['mime'], $jpgQuality);

					imagedestroy($img);
					imagedestroy($tmp);

					return $result ? $path : false;
				}

				break;
		}

		return false;
	}

	/**
	 * Rotate image.
	 *
	 * @param  string $path       image file
	 * @param  int    $degree     rotete degrees
	 * @param  string $bgcolor    square background color in #rrggbb format
	 * @param  string $destformat image destination format
	 * @param  int    $jpgQuality JEPG quality (1-100)
	 *
	 * @return string|false
	 * @throws elFinderAbortException
	 * @author nao-pon
	 * @author Troex Nevelin
	 */
	protected function imgRotate($path, $degree, $bgcolor = '#ffffff', $destformat = null, $jpgQuality = null) {
		if (($s = getimagesize($path)) == false || $degree % 360 === 0) {
			return false;
		}

		$result = false;

		// try lossless rotate
		if ($degree % 90 === 0 && in_array($s[2], [IMAGETYPE_JPEG, IMAGETYPE_JPEG2000])) {
			$count    = ($degree / 90) % 4;
			$exiftran = [
				1 => '-9',
				2 => '-1',
				3 => '-2',
			];
			$jpegtran = [
				1 => '90',
				2 => '180',
				3 => '270',
			];
			$quotedPath = escapeshellarg($path);
			$cmds       = [];

			if ($this->procExec(ELFINDER_EXIFTRAN_PATH . ' -h') === 0) {
				$cmds[] = ELFINDER_EXIFTRAN_PATH . ' -i ' . $exiftran[$count] . ' -- ' . $quotedPath;
			}

			if ($this->procExec(ELFINDER_JPEGTRAN_PATH . ' -version') === 0) {
				$cmds[] = ELFINDER_JPEGTRAN_PATH . ' -rotate ' . $jpegtran[$count] . ' -copy all -outfile ' . $quotedPath . ' -- ' . $quotedPath;
			}

			foreach ($cmds as $cmd) {
				if ($this->procExec($cmd) === 0) {
					$result = true;

					break;
				}
			}

			if ($result) {
				return $path;
			}
		}

		if (! $jpgQuality) {
			$jpgQuality = $this->options['jpgQuality'];
		}

		elFinder::extendTimeLimit(300);

		switch ($this->imgLib) {
			case 'imagick':
				try {
					$img = new imagick($path);
				} catch (Exception $e) {
					return false;
				}

				if ($s[2] === IMAGETYPE_GIF || $s[2] === IMAGETYPE_PNG) {
					$bgcolor = 'rgba(255, 255, 255, 0.0)';
				}

				if ($img->getNumberImages() > 1) {
					$img = $img->coalesceImages();

					do {
						$img->rotateImage(new ImagickPixel($bgcolor), $degree);
					} while ($img->nextImage());
					$img->optimizeImageLayers();
					$result = $img->writeImages($path, true);
				} else {
					$img->rotateImage(new ImagickPixel($bgcolor), $degree);
					$result = $this->imagickImage($img, $path, $destformat, $jpgQuality);
				}
				$img->clear();

				return $result ? $path : false;

				break;

			case 'convert':
				extract($this->imageMagickConvertPrepare($path, $destformat, $jpgQuality, $s));
				/**
				 * @var string $ani
				 * @var string $index
				 * @var string $coalesce
				 * @var string $deconstruct
				 * @var string $jpgQuality
				 * @var string $quotedPath
				 * @var string $quotedDstPath
				 * @var string $interlace
				 */
				if ($s[2] === IMAGETYPE_GIF || $s[2] === IMAGETYPE_PNG) {
					$bgcolor = 'rgba(255, 255, 255, 0.0)';
				}
				$cmd = sprintf('%s%s%s%s -background "%s" -rotate %d%s -- %s %s', ELFINDER_CONVERT_PATH, $coalesce, $jpgQuality, $interlace, $bgcolor, $degree, $deconstruct, $quotedPath, $quotedDstPath);

				$result = false;

				if ($this->procExec($cmd) === 0) {
					$result = true;
				}

				return $result ? $path : false;

				break;

			case 'gd':
				elFinder::expandMemoryForGD([$s, $s]);
				$img = $this->gdImageCreate($path, $s['mime']);

				$degree = 360 - $degree;

				$bgNum = -1;
				$bgIdx = false;

				if ($s[2] === IMAGETYPE_GIF) {
					$bgIdx = imagecolortransparent($img);

					if ($bgIdx !== -1) {
						$c      = imagecolorsforindex($img, $bgIdx);
						$w      = imagesx($img);
						$h      = imagesy($img);
						$newImg = imagecreatetruecolor($w, $h);
						imagepalettecopy($newImg, $img);
						$bgNum = imagecolorallocate($newImg, $c['red'], $c['green'], $c['blue']);
						imagefill($newImg, 0, 0, $bgNum);
						imagecolortransparent($newImg, $bgNum);
						imagecopy($newImg, $img, 0, 0, 0, 0, $w, $h);
						imagedestroy($img);
						$img    = $newImg;
						$newImg = null;
					}
				} else {
					if ($s[2] === IMAGETYPE_PNG) {
						$bgNum = imagecolorallocatealpha($img, 255, 255, 255, 127);
					}
				}

				if ($bgNum === -1) {
					list($r, $g, $b) = sscanf($bgcolor, '#%02x%02x%02x');
					$bgNum           = imagecolorallocate($img, $r, $g, $b);
				}

				$tmp = imageRotate($img, $degree, $bgNum);

				if ($bgIdx !== -1) {
					imagecolortransparent($tmp, $bgNum);
				}

				$result = $this->gdImage($tmp, $path, $destformat, $s['mime'], $jpgQuality);

				imageDestroy($img);
				imageDestroy($tmp);

				return $result ? $path : false;

				break;
		}

		return false;
	}

	/**
	 * Execute shell command.
	 *
	 * @param  string $command      command line
	 * @param  string $output       stdout strings
	 * @param  int    $return_var   process exit code
	 * @param  string $error_output stderr strings
	 * @param null|mixed $cwd
	 *
	 * @return int exit code
	 * @throws elFinderAbortException
	 * @author Alexey Sukhotin
	 */
	protected function procExec($command, &$output = '', &$return_var = -1, &$error_output = '', $cwd = null) {
		return elFinder::procExec($command, $output, $return_var, $error_output);
	}

	/**
	 * Remove thumbnail, also remove recursively if stat is directory.
	 *
	 * @param  array $stat file stat
	 *
	 * @return void
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 * @author Naoki Sawada
	 * @author Troex Nevelin
	 */
	protected function rmTmb($stat) {
		if ($this->tmbPathWritable) {
			if ($stat['mime'] === 'directory') {
				foreach ($this->scandirCE($this->decode($stat['hash'])) as $p) {
					elFinder::extendTimeLimit(30);
					$name = $this->basenameCE($p);
					$name != '.' && $name != '..' && $this->rmTmb($this->stat($p));
				}
			} else {
				if (! empty($stat['tmb']) && $stat['tmb'] != '1') {
					$tmb = $this->tmbPath . DIRECTORY_SEPARATOR . rawurldecode($stat['tmb']);
					file_exists($tmb) && unlink($tmb);
					clearstatcache();
				}
			}
		}
	}

	/**
	 * Create an gd image according to the specified mime type.
	 *
	 * @param string $path image file
	 * @param string $mime
	 *
	 * @return resource|false GD image resource identifier
	 */
	protected function gdImageCreate($path, $mime) {
		switch ($mime) {
			case 'image/jpeg':
				return imagecreatefromjpeg($path);

			case 'image/png':
				return imagecreatefrompng($path);

			case 'image/gif':
				return imagecreatefromgif($path);

			case 'image/x-ms-bmp':
				if (! function_exists('imagecreatefrombmp')) {
					include_once dirname(__FILE__) . '/libs/GdBmp.php';
				}

				return imagecreatefrombmp($path);

			case 'image/xbm':
				return imagecreatefromxbm($path);

			case 'image/xpm':
				return imagecreatefromxpm($path);

			case 'image/webp':
				return imagecreatefromwebp($path);
		}

		return false;
	}

	/**
	 * Output gd image to file.
	 *
	 * @param resource $image      gd image resource
	 * @param string   $filename   The path to save the file to.
	 * @param string   $destformat The Image type to use for $filename
	 * @param string   $mime       The original image mime type
	 * @param int      $jpgQuality JEPG quality (1-100)
	 *
	 * @return bool
	 */
	protected function gdImage($image, $filename, $destformat, $mime, $jpgQuality = null) {
		if (! $jpgQuality) {
			$jpgQuality = $this->options['jpgQuality'];
		}

		if ($destformat) {
			switch ($destformat) {
				case 'jpg':
					$mime = 'image/jpeg';

					break;

				case 'gif':
					$mime = 'image/gif';

					break;

				case 'png':
				default:
					$mime = 'image/png';

					break;
			}
		}

		switch ($mime) {
			case 'image/gif':
				return imagegif($image, $filename);

			case 'image/jpeg':
				if ($this->options['jpgProgressive']) {
					imageinterlace($image, true);
				}

				return imagejpeg($image, $filename, $jpgQuality);

			case 'image/wbmp':
				return imagewbmp($image, $filename);

			case 'image/png':
			default:
				return imagepng($image, $filename);
		}
	}

	/**
	 * Output imagick image to file.
	 *
	 * @param imagick $img        imagick image resource
	 * @param string  $filename   The path to save the file to.
	 * @param string  $destformat The Image type to use for $filename
	 * @param int     $jpgQuality JEPG quality (1-100)
	 *
	 * @return bool
	 */
	protected function imagickImage($img, $filename, $destformat, $jpgQuality = null) {
		if (! $jpgQuality) {
			$jpgQuality = $this->options['jpgQuality'];
		}

		try {
			if ($destformat) {
				if ($destformat === 'gif') {
					$img->setImageFormat('gif');
				} else {
					if ($destformat === 'png') {
						$img->setImageFormat('png');
					} else {
						if ($destformat === 'jpg') {
							$img->setImageFormat('jpeg');
						}
					}
				}
			}

			if (strtoupper($img->getImageFormat()) === 'JPEG') {
				$img->setImageCompression(imagick::COMPRESSION_JPEG);
				$img->setImageCompressionQuality($jpgQuality);

				if ($this->options['jpgProgressive']) {
					$img->setInterlaceScheme(Imagick::INTERLACE_PLANE);
				}

				try {
					$orientation = $img->getImageOrientation();
				} catch (ImagickException $e) {
					$orientation = 0;
				}
				$img->stripImage();

				if ($orientation) {
					$img->setImageOrientation($orientation);
				}
			}
			$result = $img->writeImage($filename);
		} catch (Exception $e) {
			$result = false;
		}

		return $result;
	}

	/**
	 * Assign the proper background to a gd image.
	 *
	 * @param resource $image   gd image resource
	 * @param string   $bgcolor background color in #rrggbb format
	 */
	protected function gdImageBackground($image, $bgcolor) {
		if ($bgcolor === 'transparent') {
			imagealphablending($image, false);
			imagesavealpha($image, true);
		} else {
			list($r, $g, $b) = sscanf($bgcolor, '#%02x%02x%02x');
			$bgcolor1        = imagecolorallocate($image, $r, $g, $b);
			imagefill($image, 0, 0, $bgcolor1);
		}
	}

	/**
	 * Prepare variables for exec convert of ImageMagick.
	 *
	 * @param  string $path
	 * @param  string $destformat
	 * @param  int    $jpgQuality
	 * @param  array  $imageSize
	 * @param null    $mime
	 *
	 * @return array
	 * @throws elFinderAbortException
	 */
	protected function imageMagickConvertPrepare($path, $destformat, $jpgQuality, $imageSize = null, $mime = null) {
		if (is_null($imageSize)) {
			$imageSize = getimagesize($path);
		}

		if (is_null($mime)) {
			$mime = $this->mimetype($path);
		}
		$srcType = $this->getExtentionByMime($mime, ':');
		$ani     = false;

		if (preg_match('/^(?:gif|png|ico)/', $srcType)) {
			$cmd = ELFINDER_IDENTIFY_PATH . ' -- ' . escapeshellarg($srcType . $path);

			if ($this->procExec($cmd, $o) === 0) {
				$ani = preg_split('/(?:\r\n|\n|\r)/', trim($o));

				if (count($ani) < 2) {
					$ani = false;
				}
			}
		}
		$coalesce    = $index    = $interlace    = '';
		$deconstruct = ' +repage';

		if ($ani && $destformat !== 'png'/* not createTmb */) {
			if (is_null($destformat)) {
				$coalesce    = ' -coalesce -repage 0x0';
				$deconstruct = ' +repage -deconstruct -layers optimize';
			} else {
				if ($imageSize) {
					if ($srcType === 'ico:') {
						$index = '[0]';

						foreach ($ani as $_i => $_info) {
							if (preg_match('/ (\d+)x(\d+) /', $_info, $m)) {
								if ($m[1] == $imageSize[0] && $m[2] == $imageSize[1]) {
									$index = '[' . $_i . ']';

									break;
								}
							}
						}
					}
				}
			}
		} else {
			$index = '[0]';
		}

		if ($imageSize && ($imageSize[2] === IMAGETYPE_JPEG || $imageSize[2] === IMAGETYPE_JPEG2000)) {
			$jpgQuality = ' -quality ' . $jpgQuality;

			if ($this->options['jpgProgressive']) {
				$interlace = ' -interlace Plane';
			}
		} else {
			$jpgQuality = '';
		}
		$quotedPath    = escapeshellarg($srcType . $path . $index);
		$quotedDstPath = escapeshellarg(($destformat ? ($destformat . ':') : $srcType) . $path);

		return compact('ani', 'index', 'coalesce', 'deconstruct', 'jpgQuality', 'quotedPath', 'quotedDstPath', 'interlace');
	}

	/*********************** misc *************************/

	/**
	 * Find position of first occurrence of string in a string with multibyte support.
	 *
	 * @param  string $haystack The string being checked.
	 * @param  string $needle   The string to find in haystack.
	 * @param  int    $offset   The search offset. If it is not specified, 0 is used.
	 *
	 * @return int|bool
	 * @author Alexey Sukhotin
	 **/
	protected function stripos($haystack, $needle, $offset = 0) {
		if (function_exists('mb_stripos')) {
			return mb_stripos($haystack, $needle, $offset, 'UTF-8');
		} else {
			if (function_exists('mb_strtolower') && function_exists('mb_strpos')) {
				return mb_strpos(mb_strtolower($haystack, 'UTF-8'), mb_strtolower($needle, 'UTF-8'), $offset);
			}
		}

		return stripos($haystack, $needle, $offset);
	}

	/**
	 * Default serach match method (name match).
	 *
	 * @param  String $name  Item name
	 * @param  String $query Query word
	 * @param  String $path  Item path
	 *
	 * @return bool @return bool
	 */
	protected function searchMatchName($name, $query, $path) {
		return $this->stripos($name, $query) !== false;
	}

	/**
	 * Get server side available archivers.
	 *
	 * @param bool $use_cache
	 *
	 * @return array
	 * @throws elFinderAbortException
	 */
	protected function getArchivers($use_cache = true) {
		$sessionKey = 'archivers';

		if ($use_cache) {
			if (isset($this->options['archivers']) && is_array($this->options['archivers']) && $this->options['archivers']) {
				$cache = $this->options['archivers'];
			} else {
				$cache = elFinder::$archivers;
			}

			if ($cache) {
				return $cache;
			} else {
				if ($cache = $this->session->get($sessionKey, [])) {
					return elFinder::$archivers = $cache;
				}
			}
		}

		$arcs = [
			'create'  => [],
			'extract' => [],
		];

		if ($this->procExec('') === 0) {
			$this->procExec(ELFINDER_TAR_PATH . ' --version', $o, $ctar);

			if ($ctar == 0) {
				$arcs['create']['application/x-tar']  = ['cmd' => ELFINDER_TAR_PATH, 'argc' => '-chf', 'ext' => 'tar'];
				$arcs['extract']['application/x-tar'] = ['cmd' => ELFINDER_TAR_PATH, 'argc' => '-xf', 'ext' => 'tar', 'toSpec' => '-C ', 'getsize' => ['argc' => '-xvf', 'toSpec' => '--to-stdout|wc -c', 'regex' => '/^.+(?:\r\n|\n|\r)[^\r\n0-9]*([0-9]+)[^\r\n]*$/s', 'replace' => '$1']];
				unset($o);
				$this->procExec(ELFINDER_GZIP_PATH . ' --version', $o, $c);

				if ($c == 0) {
					$arcs['create']['application/x-gzip']  = ['cmd' => ELFINDER_TAR_PATH, 'argc' => '-czhf', 'ext' => 'tgz'];
					$arcs['extract']['application/x-gzip'] = ['cmd' => ELFINDER_TAR_PATH, 'argc' => '-xzf', 'ext' => 'tgz', 'toSpec' => '-C ', 'getsize' => ['argc' => '-xvf', 'toSpec' => '--to-stdout|wc -c', 'regex' => '/^.+(?:\r\n|\n|\r)[^\r\n0-9]*([0-9]+)[^\r\n]*$/s', 'replace' => '$1']];
				}
				unset($o);
				$this->procExec(ELFINDER_BZIP2_PATH . ' --version', $o, $c);

				if ($c == 0) {
					$arcs['create']['application/x-bzip2']  = ['cmd' => ELFINDER_TAR_PATH, 'argc' => '-cjhf', 'ext' => 'tbz'];
					$arcs['extract']['application/x-bzip2'] = ['cmd' => ELFINDER_TAR_PATH, 'argc' => '-xjf', 'ext' => 'tbz', 'toSpec' => '-C ', 'getsize' => ['argc' => '-xvf', 'toSpec' => '--to-stdout|wc -c', 'regex' => '/^.+(?:\r\n|\n|\r)[^\r\n0-9]*([0-9]+)[^\r\n]*$/s', 'replace' => '$1']];
				}
				unset($o);
				$this->procExec(ELFINDER_XZ_PATH . ' --version', $o, $c);

				if ($c == 0) {
					$arcs['create']['application/x-xz']  = ['cmd' => ELFINDER_TAR_PATH, 'argc' => '-cJhf', 'ext' => 'xz'];
					$arcs['extract']['application/x-xz'] = ['cmd' => ELFINDER_TAR_PATH, 'argc' => '-xJf', 'ext' => 'xz', 'toSpec' => '-C ', 'getsize' => ['argc' => '-xvf', 'toSpec' => '--to-stdout|wc -c', 'regex' => '/^.+(?:\r\n|\n|\r)[^\r\n0-9]*([0-9]+)[^\r\n]*$/s', 'replace' => '$1']];
				}
			}
			unset($o);
			$this->procExec(ELFINDER_ZIP_PATH . ' -h', $o, $c);

			if ($c == 0) {
				$arcs['create']['application/zip'] = ['cmd' => ELFINDER_ZIP_PATH, 'argc' => '-r9 -q', 'ext' => 'zip'];
			}
			unset($o);
			$this->procExec(ELFINDER_UNZIP_PATH . ' --help', $o, $c);

			if ($c == 0) {
				$arcs['extract']['application/zip'] = ['cmd' => ELFINDER_UNZIP_PATH, 'argc' => '-q', 'ext' => 'zip', 'toSpec' => '-d ', 'getsize' => ['argc' => '-Z -t', 'regex' => '/^.+?,\s?([0-9]+).+$/', 'replace' => '$1']];
			}
			unset($o);
			$this->procExec(ELFINDER_RAR_PATH, $o, $c);

			if ($c == 0 || $c == 7) {
				$arcs['create']['application/x-rar'] = ['cmd' => ELFINDER_RAR_PATH, 'argc' => 'a -inul' . (defined('ELFINDER_RAR_MA4') && ELFINDER_RAR_MA4 ? ' -ma4' : '') . ' --', 'ext' => 'rar'];
			}
			unset($o);
			$this->procExec(ELFINDER_UNRAR_PATH, $o, $c);

			if ($c == 0 || $c == 7) {
				$arcs['extract']['application/x-rar'] = ['cmd' => ELFINDER_UNRAR_PATH, 'argc' => 'x -y', 'ext' => 'rar', 'toSpec' => '', 'getsize' => ['argc' => 'l', 'regex' => '/^.+(?:\r\n|\n|\r)(?:(?:[^\r\n0-9]+[0-9]+[^\r\n0-9]+([0-9]+)[^\r\n]+)|(?:[^\r\n0-9]+([0-9]+)[^\r\n0-9]+[0-9]+[^\r\n]*))$/s', 'replace' => '$1']];
			}
			unset($o);
			$this->procExec(ELFINDER_7Z_PATH, $o, $c);

			if ($c == 0) {
				$arcs['create']['application/x-7z-compressed']  = ['cmd' => ELFINDER_7Z_PATH, 'argc' => 'a --', 'ext' => '7z'];
				$arcs['extract']['application/x-7z-compressed'] = ['cmd' => ELFINDER_7Z_PATH, 'argc' => 'x -y', 'ext' => '7z', 'toSpec' => '-o', 'getsize' => ['argc' => 'l', 'regex' => '/^.+(?:\r\n|\n|\r)[^\r\n0-9]+([0-9]+)[^\r\n]+$/s', 'replace' => '$1']];

				if (empty($arcs['create']['application/zip'])) {
					$arcs['create']['application/zip'] = ['cmd' => ELFINDER_7Z_PATH, 'argc' => 'a -tzip --', 'ext' => 'zip'];
				}

				if (empty($arcs['extract']['application/zip'])) {
					$arcs['extract']['application/zip'] = ['cmd' => ELFINDER_7Z_PATH, 'argc' => 'x -tzip -y', 'ext' => 'zip', 'toSpec' => '-o', 'getsize' => ['argc' => 'l', 'regex' => '/^.+(?:\r\n|\n|\r)[^\r\n0-9]+([0-9]+)[^\r\n]+$/s', 'replace' => '$1']];
				}

				if (empty($arcs['create']['application/x-tar'])) {
					$arcs['create']['application/x-tar'] = ['cmd' => ELFINDER_7Z_PATH, 'argc' => 'a -ttar --', 'ext' => 'tar'];
				}

				if (empty($arcs['extract']['application/x-tar'])) {
					$arcs['extract']['application/x-tar'] = ['cmd' => ELFINDER_7Z_PATH, 'argc' => 'x -ttar -y', 'ext' => 'tar', 'toSpec' => '-o', 'getsize' => ['argc' => 'l', 'regex' => '/^.+(?:\r\n|\n|\r)[^\r\n0-9]+([0-9]+)[^\r\n]+$/s', 'replace' => '$1']];
				}

				if (substr(PHP_OS, 0, 3) === 'WIN' && empty($arcs['extract']['application/x-rar'])) {
					$arcs['extract']['application/x-rar'] = ['cmd' => ELFINDER_7Z_PATH, 'argc' => 'x -trar -y', 'ext' => 'rar', 'toSpec' => '-o', 'getsize' => ['argc' => 'l', 'regex' => '/^.+(?:\r\n|\n|\r)[^\r\n0-9]+([0-9]+)[^\r\n]+$/s', 'replace' => '$1']];
				}
			}
		}

		// Use PHP ZipArchive Class
		if (class_exists('ZipArchive', false)) {
			if (empty($arcs['create']['application/zip'])) {
				$arcs['create']['application/zip'] = ['cmd' => 'phpfunction', 'argc' => ['self', 'zipArchiveZip'], 'ext' => 'zip'];
			}

			if (empty($arcs['extract']['application/zip'])) {
				$arcs['extract']['application/zip'] = ['cmd' => 'phpfunction', 'argc' => ['self', 'zipArchiveUnzip'], 'ext' => 'zip'];
			}
		}

		$this->session->set($sessionKey, $arcs);

		return elFinder::$archivers = $arcs;
	}

	/**
	 * Resolve relative / (Unix-like)absolute path.
	 *
	 * @param string $path target path
	 * @param string $base base path
	 *
	 * @return string
	 */
	protected function getFullPath($path, $base) {
		$separator  = $this->separator;
		$systemroot = $this->systemRoot;
		$base       = (string)$base;

		if ($base[0] === $separator && substr($base, 0, strlen($systemroot)) !== $systemroot) {
			$base = $systemroot . substr($base, 1);
		}

		if ($base !== $systemroot) {
			$base = rtrim($base, $separator);
		}

		$sepquoted = preg_quote($separator, '#');

		// normalize `//` to `/`
		$path = preg_replace('#' . $sepquoted . '+#', $separator, $path); // '#/+#'

		// remove `./`
		$path = preg_replace('#(?<=^|' . $sepquoted . ')\.' . $sepquoted . '#', '', $path); // '#(?<=^|/)\./#'

		// 'Here'
		if ($path === '') {
			return $base;
		}
		// join $base to $path if $path start `../`
		if (substr($path, 0, 3) === '..' . $separator) {
			$path = $base . $separator . $path;
		}

		// normalize `/../`
		$normreg = '#(' . $sepquoted . ')[^' . $sepquoted . ']+' . $sepquoted . '\.\.' . $sepquoted . '#'; // '#(/)[^\/]+/\.\./#'

		while (preg_match($normreg, $path)) {
			$path = preg_replace($normreg, '$1', $path, 1);
		}

		if ($path !== $systemroot) {
			$path = rtrim($path, $separator);
		}

		// discard the surplus `../`
		$path = str_replace('..' . $separator, '', $path);

		// Absolute path
		if ($path[0] === $separator || strpos($path, $systemroot) === 0) {
			return $path;
		}

		$preg_separator = '#' . $sepquoted . '#';

		// Relative path from 'Here'
		if (substr($path, 0, 2) === '.' . $separator || $path[0] !== '.') {
			$arrn = preg_split($preg_separator, $path, -1, PREG_SPLIT_NO_EMPTY);

			if ($arrn[0] !== '.') {
				array_unshift($arrn, '.');
			}
			$arrn[0] = rtrim($base, $separator);

			return join($separator, $arrn);
		}

		return $path;
	}

	/**
	 * Remove directory recursive on local file system.
	 *
	 * @param string $dir Target dirctory path
	 *
	 * @return boolean
	 * @throws elFinderAbortException
	 * @author Naoki Sawada
	 */
	public function rmdirRecursive($dir) {
		return self::localRmdirRecursive($dir);
	}

	/**
	 * Create archive and return its path.
	 *
	 * @param  string $dir   target dir
	 * @param  array  $files files names list
	 * @param  string $name  archive name
	 * @param  array  $arc   archiver options
	 *
	 * @return string|bool
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov,
	 * @author Alexey Sukhotin
	 * @author Naoki Sawada
	 */
	protected function makeArchive($dir, $files, $name, $arc) {
		if ($arc['cmd'] === 'phpfunction') {
			if (is_callable($arc['argc'])) {
				call_user_func_array($arc['argc'], [$dir, $files, $name]);
			}
		} else {
			$cwd = getcwd();

			if (chdir($dir)) {
				foreach ($files as $i => $file) {
					$files[$i] = '.' . DIRECTORY_SEPARATOR . basename($file);
				}
				$files  = array_map('escapeshellarg', $files);
				$prefix = $switch = '';
				// The zip command accepts the "-" at the beginning of the file name as a command switch,
				// and can't use '--' before archive name, so add "./" to name for security reasons.
				if ($arc['ext'] === 'zip' && strpos($arc['argc'], '-tzip') === false) {
					$prefix = './';
					$switch = '-- ';
				}
				$cmd     = $arc['cmd'] . ' ' . $arc['argc'] . ' ' . $prefix . escapeshellarg($name) . ' ' . $switch . implode(' ', $files);
				$err_out = '';
				$this->procExec($cmd, $o, $c, $err_out, $dir);
				chdir($cwd);
			} else {
				return false;
			}
		}
		$path = $dir . DIRECTORY_SEPARATOR . $name;

		return file_exists($path) ? $path : false;
	}

	/**
	 * Unpack archive.
	 *
	 * @param  string      $path archive path
	 * @param  array       $arc  archiver command and arguments (same as in $this->archivers)
	 * @param  bool|string $mode bool: remove archive ( unlink($path) ) | string: extract to directory
	 *
	 * @return void
	 * @throws elFinderAbortException
	 * @author Dmitry (dio) Levashov
	 * @author Alexey Sukhotin
	 * @author Naoki Sawada
	 */
	protected function unpackArchive($path, $arc, $mode = true) {
		if (is_string($mode)) {
			$dir    = $mode;
			$chdir  = null;
			$remove = false;
		} else {
			$dir    = dirname($path);
			$chdir  = $dir;
			$remove = $mode;
		}
		$dir  = realpath($dir);
		$path = realpath($path);

		if ($arc['cmd'] === 'phpfunction') {
			if (is_callable($arc['argc'])) {
				call_user_func_array($arc['argc'], [$path, $dir]);
			}
		} else {
			$cwd = getcwd();

			if (! $chdir || chdir($dir)) {
				if (! empty($arc['getsize'])) {
					// Check total file size after extraction
					$getsize = $arc['getsize'];

					if (is_array($getsize) && ! empty($getsize['regex']) && ! empty($getsize['replace'])) {
						$cmd = $arc['cmd'] . ' ' . $getsize['argc'] . ' ' . escapeshellarg($path) . (! empty($getsize['toSpec']) ? (' ' . $getsize['toSpec']) : '');
						$this->procExec($cmd, $o, $c);

						if ($o) {
							$size = preg_replace($getsize['regex'], $getsize['replace'], trim($o));
							$comp = function_exists('bccomp') ? 'bccomp' : 'strnatcmp';

							if (! empty($this->options['maxArcFilesSize'])) {
								if ($comp($size, (string)$this->options['maxArcFilesSize']) > 0) {
									throw new Exception(elFinder::ERROR_ARC_MAXSIZE);
								}
							}
						}
						unset($o, $c);
					}
				}

				if ($chdir) {
					$cmd = $arc['cmd'] . ' ' . $arc['argc'] . ' ' . escapeshellarg(basename($path));
				} else {
					$cmd = $arc['cmd'] . ' ' . $arc['argc'] . ' ' . escapeshellarg($path) . ' ' . $arc['toSpec'] . escapeshellarg($dir);
				}
				$this->procExec($cmd, $o, $c);
				$chdir && chdir($cwd);
			}
		}
		$remove && unlink($path);
	}

	/**
	 * Check and filter the extracted items.
	 *
	 * @param  string $path   target local path
	 * @param  array  $checks types to check default: ['symlink', 'name', 'writable', 'mime']
	 *
	 * @return array  ['symlinks' => [], 'names' => [], 'writables' => [], 'mimes' => [], 'rmNames' => [], 'totalSize' => 0]
	 * @throws elFinderAbortException
	 * @throws Exception
	 * @author Naoki Sawada
	 */
	protected function checkExtractItems($path, $checks = null) {
		if (is_null($checks) || ! is_array($checks)) {
			$checks = ['symlink', 'name', 'writable', 'mime'];
		}
		$chkSymlink  = in_array('symlink', $checks);
		$chkName     = in_array('name', $checks);
		$chkWritable = in_array('writable', $checks);
		$chkMime     = in_array('mime', $checks);

		$res = [
			'symlinks'  => [],
			'names'     => [],
			'writables' => [],
			'mimes'     => [],
			'rmNames'   => [],
			'totalSize' => 0,
		];

		if (is_dir($path)) {
			$files = self::localScandir($path);
		} else {
			$files = [basename($path)];
			$path  = dirname($path);
		}

		foreach ($files as $name) {
			$p        = $path . DIRECTORY_SEPARATOR . $name;
			$utf8Name = elFinder::$instance->utf8Encode($name);

			if ($name !== $utf8Name) {
				$fsSame = false;

				if ($this->encoding) {
					// test as fs encoding
					$_utf8 = @iconv($this->encoding, 'utf-8//IGNORE', $name);

					if (@iconv('utf-8', $this->encoding . '//IGNORE', $_utf8) === $name) {
						$fsSame   = true;
						$utf8Name = $_utf8;
					} else {
						$_name = $this->convEncIn($utf8Name, true);
					}
				} else {
					$_name = $utf8Name;
				}

				if (! $fsSame && rename($p, $path . DIRECTORY_SEPARATOR . $_name)) {
					$name = $_name;
					$p    = $path . DIRECTORY_SEPARATOR . $name;
				}
			}

			if (! is_readable($p)) {
				// Perhaps a symbolic link to open_basedir restricted location
				self::localRmdirRecursive($p);
				$res['symlinks'][] = $p;
				$res['rmNames'][]  = $utf8Name;

				continue;
			}

			if ($chkSymlink && is_link($p)) {
				self::localRmdirRecursive($p);
				$res['symlinks'][] = $p;
				$res['rmNames'][]  = $utf8Name;

				continue;
			}
			$isDir = is_dir($p);

			if ($chkName && ! $this->nameAccepted($name, $isDir)) {
				self::localRmdirRecursive($p);
				$res['names'][]   = $p;
				$res['rmNames'][] = $utf8Name;

				continue;
			}

			if ($chkWritable && ! $this->attr($p, 'write', null, $isDir)) {
				self::localRmdirRecursive($p);
				$res['writables'][] = $p;
				$res['rmNames'][]   = $utf8Name;

				continue;
			}

			if ($isDir) {
				$cRes = $this->checkExtractItems($p, $checks);

				foreach ($cRes as $k => $v) {
					if (is_array($v)) {
						$res[$k] = array_merge($res[$k], $cRes[$k]);
					} else {
						$res[$k] += $cRes[$k];
					}
				}
			} else {
				if ($chkMime && ($mimeByName = elFinderVolumeDriver::mimetypeInternalDetect($name)) && ! $this->allowPutMime($mimeByName)) {
					self::localRmdirRecursive($p);
					$res['mimes'][]   = $p;
					$res['rmNames'][] = $utf8Name;

					continue;
				}
				$res['totalSize'] += (int)sprintf('%u', filesize($p));
			}
		}
		$res['rmNames'] = array_unique($res['rmNames']);

		return $res;
	}

	/**
	 * Return files of target directory that is dotfiles excludes.
	 *
	 * @param  string $dir target directory path
	 *
	 * @return array
	 * @throws Exception
	 * @author Naoki Sawada
	 */
	protected static function localScandir($dir) {
		// PHP function scandir() is not work well in specific environment. I dont know why.
		// ref. https://github.com/Studio-42/elFinder/issues/1248
		$files = [];

		if ($dh = opendir($dir)) {
			while (false !== ($file = readdir($dh))) {
				if ($file !== '.' && $file !== '..') {
					$files[] = $file;
				}
			}
			closedir($dh);
		} else {
			throw new Exception('Can not open local directory.');
		}

		return $files;
	}

	/**
	 * Remove directory recursive on local file system.
	 *
	 * @param string $dir Target dirctory path
	 *
	 * @return boolean
	 * @throws elFinderAbortException
	 * @author Naoki Sawada
	 */
	protected static function localRmdirRecursive($dir) {
		// try system command
		if (is_callable('exec')) {
			$o = '';
			$r = 1;

			if (substr(PHP_OS, 0, 3) === 'WIN') {
				if (! is_link($dir) && is_dir($dir)) {
					exec('rd /S /Q ' . escapeshellarg($dir), $o, $r);
				} else {
					exec('del /F /Q ' . escapeshellarg($dir), $o, $r);
				}
			} else {
				exec('rm -rf ' . escapeshellarg($dir), $o, $r);
			}

			if ($r === 0) {
				return true;
			}
		}

		if (! is_link($dir) && is_dir($dir)) {
			chmod($dir, 0777);

			if ($handle = opendir($dir)) {
				while (false !== ($file = readdir($handle))) {
					if ($file === '.' || $file === '..') {
						continue;
					}
					elFinder::extendTimeLimit(30);
					$path = $dir . DIRECTORY_SEPARATOR . $file;

					if (! is_link($dir) && is_dir($path)) {
						self::localRmdirRecursive($path);
					} else {
						chmod($path, 0666);
						unlink($path);
					}
				}
				closedir($handle);
			}

			return rmdir($dir);
		} else {
			chmod($dir, 0666);

			return unlink($dir);
		}
	}

	/**
	 * Move item recursive on local file system.
	 *
	 * @param string $src
	 * @param string $target
	 * @param bool   $overWrite
	 * @param bool   $copyJoin
	 *
	 * @return boolean
	 * @throws elFinderAbortException
	 * @throws Exception
	 * @author Naoki Sawada
	 */
	protected static function localMoveRecursive($src, $target, $overWrite = true, $copyJoin = true) {
		$res = false;

		if (! file_exists($target)) {
			return rename($src, $target);
		}

		if (! $copyJoin || ! is_dir($target)) {
			if ($overWrite) {
				if (is_dir($target)) {
					$del = self::localRmdirRecursive($target);
				} else {
					$del = unlink($target);
				}

				if ($del) {
					return rename($src, $target);
				}
			}
		} else {
			foreach (self::localScandir($src) as $item) {
				$res |= self::localMoveRecursive($src . DIRECTORY_SEPARATOR . $item, $target . DIRECTORY_SEPARATOR . $item, $overWrite, $copyJoin);
			}
		}

		return (bool)$res;
	}

	/**
	 * Create Zip archive using PHP class ZipArchive.
	 *
	 * @param  string        $dir     target dir
	 * @param  array         $files   files names list
	 * @param  string|object $zipPath Zip archive name
	 *
	 * @return bool
	 * @author Naoki Sawada
	 */
	protected static function zipArchiveZip($dir, $files, $zipPath) {
		try {
			if ($start = is_string($zipPath)) {
				$zip = new ZipArchive();

				if ($zip->open($dir . DIRECTORY_SEPARATOR . $zipPath, ZipArchive::CREATE) !== true) {
					$zip = false;
				}
			} else {
				$zip = $zipPath;
			}

			if ($zip) {
				foreach ($files as $file) {
					$path = $dir . DIRECTORY_SEPARATOR . $file;

					if (is_dir($path)) {
						$zip->addEmptyDir($file);
						$_files = [];

						if ($handle = opendir($path)) {
							while (false !== ($entry = readdir($handle))) {
								if ($entry !== '.' && $entry !== '..') {
									$_files[] = $file . DIRECTORY_SEPARATOR . $entry;
								}
							}
							closedir($handle);
						}

						if ($_files) {
							self::zipArchiveZip($dir, $_files, $zip);
						}
					} else {
						$zip->addFile($path, $file);
					}
				}
				$start && $zip->close();
			}
		} catch (Exception $e) {
			return false;
		}

		return true;
	}

	/**
	 * Unpack Zip archive using PHP class ZipArchive.
	 *
	 * @param  string $zipPath Zip archive name
	 * @param  string $toDir   Extract to path
	 *
	 * @return bool
	 * @author Naoki Sawada
	 */
	protected static function zipArchiveUnzip($zipPath, $toDir) {
		try {
			$zip = new ZipArchive();

			if ($zip->open($zipPath) === true) {
				// Check total file size after extraction
				$num     = $zip->numFiles;
				$size    = 0;
				$maxSize = empty(self::$maxArcFilesSize) ? '' : (string)self::$maxArcFilesSize;
				$comp    = function_exists('bccomp') ? 'bccomp' : 'strnatcmp';

				for ($i = 0; $i < $num; $i++) {
					$stat = $zip->statIndex($i);
					$size += $stat['size'];

					if (strpos((string)$size, 'E') !== false) {
						// Cannot handle values exceeding PHP_INT_MAX
						throw new Exception(elFinder::ERROR_ARC_MAXSIZE);
					}

					if (! $maxSize) {
						if ($comp($size, $maxSize) > 0) {
							throw new Exception(elFinder::ERROR_ARC_MAXSIZE);
						}
					}
				}
				// do extract
				$zip->extractTo($toDir);
				$zip->close();
			}
		} catch (Exception $e) {
			throw $e;
		}

		return true;
	}

	/**
	 * Recursive symlinks search.
	 *
	 * @param  string $path file/dir path
	 *
	 * @return bool
	 * @throws Exception
	 * @author Dmitry (dio) Levashov
	 */
	protected static function localFindSymlinks($path) {
		if (is_link($path)) {
			return true;
		}

		if (is_dir($path)) {
			foreach (self::localScandir($path) as $name) {
				$p = $path . DIRECTORY_SEPARATOR . $name;

				if (is_link($p)) {
					return true;
				}

				if (is_dir($p) && self::localFindSymlinks($p)) {
					return true;
				}
			}
		}

		return false;
	}

	/**==================================* abstract methods *====================================**/

	/*********************** paths/urls *************************/

	/**
	 * Return parent directory path.
	 *
	 * @param  string $path file path
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _dirname($path);

	/**
	 * Return file name.
	 *
	 * @param  string $path file path
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _basename($path);

	/**
	 * Join dir name and file name and return full path.
	 * Some drivers (db) use int as path - so we give to concat path to driver itself.
	 *
	 * @param  string $dir  dir path
	 * @param  string $name file name
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _joinPath($dir, $name);

	/**
	 * Return normalized path.
	 *
	 * @param  string $path file path
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _normpath($path);

	/**
	 * Return file path related to root dir.
	 *
	 * @param  string $path file path
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _relpath($path);

	/**
	 * Convert path related to root dir into real path.
	 *
	 * @param  string $path rel file path
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _abspath($path);

	/**
	 * Return fake path started from root dir.
	 * Required to show path on client side.
	 *
	 * @param  string $path file path
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _path($path);

	/**
	 * Return true if $path is children of $parent.
	 *
	 * @param  string $path   path to check
	 * @param  string $parent parent path
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _inpath($path, $parent);

	/**
	 * Return stat for given path.
	 * Stat contains following fields:
	 * - (int)    size    file size in b. required
	 * - (int)    ts      file modification time in unix time. required
	 * - (string) mime    mimetype. required for folders, others - optionally
	 * - (bool)   read    read permissions. required
	 * - (bool)   write   write permissions. required
	 * - (bool)   locked  is object locked. optionally
	 * - (bool)   hidden  is object hidden. optionally
	 * - (string) alias   for symlinks - link target path relative to root path. optionally
	 * - (string) target  for symlinks - link target path. optionally
	 * If file does not exists - returns empty array or false.
	 *
	 * @param  string $path file path
	 *
	 * @return array|false
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _stat($path);

	/***************** file stat ********************/

	/**
	 * Return true if path is dir and has at least one childs directory.
	 *
	 * @param  string $path dir path
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _subdirs($path);

	/**
	 * Return object width and height
	 * Ususaly used for images, but can be realize for video etc...
	 *
	 * @param  string $path file path
	 * @param  string $mime file mime type
	 *
	 * @return string
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _dimensions($path, $mime);

	/******************** file/dir content *********************/

	/**
	 * Return files list in directory.
	 *
	 * @param  string $path dir path
	 *
	 * @return array
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _scandir($path);

	/**
	 * Open file and return file pointer.
	 *
	 * @param  string $path file path
	 * @param  string $mode open mode
	 *
	 * @return resource|false
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _fopen($path, $mode = 'rb');

	/**
	 * Close opened file.
	 *
	 * @param  resource $fp   file pointer
	 * @param  string   $path file path
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _fclose($fp, $path = '');

	/********************  file/dir manipulations *************************/

	/**
	 * Create dir and return created dir path or false on failed.
	 *
	 * @param  string $path parent dir path
	 * @param string  $name new directory name
	 *
	 * @return string|bool
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _mkdir($path, $name);

	/**
	 * Create file and return it's path or false on failed.
	 *
	 * @param  string $path parent dir path
	 * @param string  $name new file name
	 *
	 * @return string|bool
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _mkfile($path, $name);

	/**
	 * Create symlink.
	 *
	 * @param  string $source    file to link to
	 * @param  string $targetDir folder to create link in
	 * @param  string $name      symlink name
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _symlink($source, $targetDir, $name);

	/**
	 * Copy file into another file (only inside one volume).
	 *
	 * @param  string $source source file path
	 * @param         $targetDir
	 * @param  string $name   file name
	 *
	 * @return bool|string
	 * @internal param string $target target dir path
	 * @author   Dmitry (dio) Levashov
	 */
	abstract protected function _copy($source, $targetDir, $name);

	/**
	 * Move file into another parent dir.
	 * Return new file path or false.
	 *
	 * @param  string $source source file path
	 * @param         $targetDir
	 * @param  string $name   file name
	 *
	 * @return bool|string
	 * @internal param string $target target dir path
	 * @author   Dmitry (dio) Levashov
	 */
	abstract protected function _move($source, $targetDir, $name);

	/**
	 * Remove file.
	 *
	 * @param  string $path file path
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _unlink($path);

	/**
	 * Remove dir.
	 *
	 * @param  string $path dir path
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _rmdir($path);

	/**
	 * Create new file and write into it from file pointer.
	 * Return new file path or false on error.
	 *
	 * @param  resource $fp   file pointer
	 * @param  string   $dir  target dir path
	 * @param  string   $name file name
	 * @param  array    $stat file stat (required by some virtual fs)
	 *
	 * @return bool|string
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _save($fp, $dir, $name, $stat);

	/**
	 * Get file contents.
	 *
	 * @param  string $path file path
	 *
	 * @return string|false
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _getContents($path);

	/**
	 * Write a string to a file.
	 *
	 * @param  string $path    file path
	 * @param  string $content new file content
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov
	 **/
	abstract protected function _filePutContents($path, $content);

	/**
	 * Extract files from archive.
	 *
	 * @param  string $path file path
	 * @param  array  $arc  archiver options
	 *
	 * @return bool
	 * @author Dmitry (dio) Levashov,
	 * @author Alexey Sukhotin
	 **/
	abstract protected function _extract($path, $arc);

	/**
	 * Create archive and return its path.
	 *
	 * @param  string $dir   target dir
	 * @param  array  $files files names list
	 * @param  string $name  archive name
	 * @param  array  $arc   archiver options
	 *
	 * @return string|bool
	 * @author Dmitry (dio) Levashov,
	 * @author Alexey Sukhotin
	 **/
	abstract protected function _archive($dir, $files, $name, $arc);

	/**
	 * Detect available archivers.
	 *
	 * @return void
	 * @author Dmitry (dio) Levashov,
	 * @author Alexey Sukhotin
	 **/
	abstract protected function _checkArchivers();

	/**
	 * Change file mode (chmod).
	 *
	 * @param  string $path file path
	 * @param  string $mode octal string such as '0755'
	 *
	 * @return bool
	 * @author David Bartle,
	 **/
	abstract protected function _chmod($path, $mode);
} // END class
