name : elFinderVolumeFTP.class.php <?php /** * Simple elFinder driver for FTP * * @author Dmitry (dio) Levashov * @author Cem (discofever) **/ class elFinderVolumeFTP extends elFinderVolumeDriver { /** * Driver id * Must be started from letter and contains [a-z0-9] * Used as part of volume id * * @var string **/ protected $driverId = 'f'; /** * FTP Connection Instance * * @var resource a FTP stream **/ protected $connect = null; /** * Directory for tmp files * If not set driver will try to use tmbDir as tmpDir * * @var string **/ protected $tmpPath = ''; /** * Last FTP error message * * @var string **/ protected $ftpError = ''; /** * FTP server output list as ftp on linux * * @var bool **/ protected $ftpOsUnix; /** * FTP LIST command option * * @var string */ protected $ftpListOption = '-al'; /** * Is connected server Pure FTPd? * * @var bool */ protected $isPureFtpd = false; /** * Is connected server with FTPS? * * @var bool */ protected $isFTPS = false; /** * Tmp folder path * * @var string **/ protected $tmp = ''; /** * FTP command `MLST` support * * @var bool */ private $MLSTsupprt = false; /** * Calling cacheDir() target path with non-MLST * * @var string */ private $cacheDirTarget = ''; /** * Constructor * Extend options with required fields * * @author Dmitry (dio) Levashov * @author Cem (DiscoFever) */ public function __construct() { $opts = array( 'host' => 'localhost', 'user' => '', 'pass' => '', 'port' => 21, 'mode' => 'passive', 'ssl' => false, 'path' => '/', 'timeout' => 20, 'owner' => true, 'tmbPath' => '', 'tmpPath' => '', 'separator' => '/', 'checkSubfolders' => -1, 'dirMode' => 0755, 'fileMode' => 0644, 'rootCssClass' => 'elfinder-navbar-root-ftp', 'ftpListOption' => '-al', ); $this->options = array_merge($this->options, $opts); $this->options['mimeDetect'] = 'internal'; } /** * Prepare * Call from elFinder::netmout() before volume->mount() * * @param $options * * @return array volume root options * @author Naoki Sawada */ public function netmountPrepare($options) { if (!empty($_REQUEST['encoding']) && iconv('UTF-8', $_REQUEST['encoding'], '') !== false) { $options['encoding'] = $_REQUEST['encoding']; if (!empty($_REQUEST['locale']) && setlocale(LC_ALL, $_REQUEST['locale'])) { setlocale(LC_ALL, elFinder::$locale); $options['locale'] = $_REQUEST['locale']; } } if (!empty($_REQUEST['FTPS'])) { $options['ssl'] = true; } $options['statOwner'] = true; $options['allowChmodReadOnly'] = true; $options['acceptedName'] = '#^[^/\\?*:|"<>]*[^./\\?*:|"<>]$#'; return $options; } /*********************************************************************/ /* INIT AND CONFIGURE */ /*********************************************************************/ /** * Prepare FTP connection * Connect to remote server and check if credentials are correct, if so, store the connection id in $ftp_conn * * @return bool * @author Dmitry (dio) Levashov * @author Cem (DiscoFever) **/ protected function init() { if (!$this->options['host'] || !$this->options['port']) { return $this->setError('Required options undefined.'); } if (!$this->options['user']) { $this->options['user'] = 'anonymous'; $this->options['pass'] = ''; } if (!$this->options['path']) { $this->options['path'] = '/'; } // make ney mount key $this->netMountKey = md5(join('-', array('ftp', $this->options['host'], $this->options['port'], $this->options['path'], $this->options['user']))); if (!function_exists('ftp_connect')) { return $this->setError('FTP extension not loaded.'); } // remove protocol from host $scheme = parse_url($this->options['host'], PHP_URL_SCHEME); if ($scheme) { $this->options['host'] = substr($this->options['host'], strlen($scheme) + 3); } // normalize root path $this->root = $this->options['path'] = $this->_normpath($this->options['path']); if (empty($this->options['alias'])) { $this->options['alias'] = $this->options['user'] . '@' . $this->options['host']; if (!empty($this->options['netkey'])) { elFinder::$instance->updateNetVolumeOption($this->options['netkey'], 'alias', $this->options['alias']); } } $this->rootName = $this->options['alias']; $this->options['separator'] = '/'; if (is_null($this->options['syncChkAsTs'])) { $this->options['syncChkAsTs'] = true; } if (isset($this->options['ftpListOption'])) { $this->ftpListOption = $this->options['ftpListOption']; } return $this->needOnline? $this->connect() : true; } /** * Configure after successfull mount. * * @return void * @throws elFinderAbortException * @author Dmitry (dio) Levashov */ protected function configure() { parent::configure(); if (!empty($this->options['tmpPath'])) { if ((is_dir($this->options['tmpPath']) || mkdir($this->options['tmpPath'], 0755, true)) && is_writable($this->options['tmpPath'])) { $this->tmp = $this->options['tmpPath']; } } if (!$this->tmp && ($tmp = elFinder::getStaticVar('commonTempPath'))) { $this->tmp = $tmp; } // fallback of $this->tmp if (!$this->tmp && $this->tmbPathWritable) { $this->tmp = $this->tmbPath; } if (!$this->tmp) { $this->disabled[] = 'mkfile'; $this->disabled[] = 'paste'; $this->disabled[] = 'duplicate'; $this->disabled[] = 'upload'; $this->disabled[] = 'edit'; $this->disabled[] = 'archive'; $this->disabled[] = 'extract'; } // echo $this->tmp; } /** * Connect to ftp server * * @return bool * @author Dmitry (dio) Levashov **/ protected function connect() { $withSSL = empty($this->options['ssl']) ? '' : ' with SSL'; if ($withSSL) { if (!function_exists('ftp_ssl_connect') || !($this->connect = ftp_ssl_connect($this->options['host'], $this->options['port'], $this->options['timeout']))) { return $this->setError('Unable to connect to FTP server ' . $this->options['host'] . $withSSL); } $this->isFTPS = true; } else { if (!($this->connect = ftp_connect($this->options['host'], $this->options['port'], $this->options['timeout']))) { return $this->setError('Unable to connect to FTP server ' . $this->options['host']); } } if (!ftp_login($this->connect, $this->options['user'], $this->options['pass'])) { $this->umount(); return $this->setError('Unable to login into ' . $this->options['host'] . $withSSL); } // try switch utf8 mode if ($this->encoding) { ftp_raw($this->connect, 'OPTS UTF8 OFF'); } else { ftp_raw($this->connect, 'OPTS UTF8 ON'); } $help = ftp_raw($this->connect, 'HELP'); $this->isPureFtpd = stripos(implode(' ', $help), 'Pure-FTPd') !== false; if (!$this->isPureFtpd) { // switch off extended passive mode - may be usefull for some servers // this command, for pure-ftpd, doesn't work and takes a timeout in some pure-ftpd versions ftp_raw($this->connect, 'epsv4 off'); } // enter passive mode if required $pasv = ($this->options['mode'] == 'passive'); if (!ftp_pasv($this->connect, $pasv)) { if ($pasv) { $this->options['mode'] = 'active'; } } // enter root folder if (!ftp_chdir($this->connect, $this->root) || $this->root != ftp_pwd($this->connect)) { $this->umount(); return $this->setError('Unable to open root folder.'); } // check for MLST support $features = ftp_raw($this->connect, 'FEAT'); if (!is_array($features)) { $this->umount(); return $this->setError('Server does not support command FEAT.'); } foreach ($features as $feat) { if (strpos(trim($feat), 'MLST') === 0) { $this->MLSTsupprt = true; break; } } return true; } /** * Call ftp_rawlist with option prefix * * @param string $path * * @return array */ protected function ftpRawList($path) { if ($this->isPureFtpd) { $path = str_replace(' ', '\ ', $path); } if ($this->ftpListOption) { $path = $this->ftpListOption . ' ' . $path; } $res = ftp_rawlist($this->connect, $path); if ($res === false) { $res = array(); } return $res; } /*********************************************************************/ /* FS API */ /*********************************************************************/ /** * Close opened connection * * @return void * @author Dmitry (dio) Levashov **/ public function umount() { $this->connect && ftp_close($this->connect); } /** * Parse line from ftp_rawlist() output and return file stat (array) * * @param string $raw line from ftp_rawlist() output * @param $base * @param bool $nameOnly * * @return array * @author Dmitry Levashov */ protected function parseRaw($raw, $base, $nameOnly = false) { static $now; static $lastyear; if (!$now) { $now = time(); $lastyear = date('Y') - 1; } $info = preg_split("/\s+/", $raw, 8); if (isset($info[7])) { list($info[7], $info[8]) = explode(' ', $info[7], 2); } $stat = array(); if (!isset($this->ftpOsUnix)) { $this->ftpOsUnix = !preg_match('/\d/', substr($info[0], 0, 1)); } if (!$this->ftpOsUnix) { $info = $this->normalizeRawWindows($raw); } if (count($info) < 9 || $info[8] == '.' || $info[8] == '..') { return false; } $name = $info[8]; if (preg_match('|(.+)\-\>(.+)|', $name, $m)) { $name = trim($m[1]); // check recursive processing if ($this->cacheDirTarget && $this->_joinPath($base, $name) !== $this->cacheDirTarget) { return array(); } if (!$nameOnly) { $target = trim($m[2]); if (substr($target, 0, 1) !== $this->separator) { $target = $this->getFullPath($target, $base); } $target = $this->_normpath($target); $stat['name'] = $name; $stat['target'] = $target; return $stat; } } if ($nameOnly) { return array('name' => $name); } if (is_numeric($info[5]) && !$info[6] && !$info[7]) { // by normalizeRawWindows() $stat['ts'] = $info[5]; } else { $stat['ts'] = strtotime($info[5] . ' ' . $info[6] . ' ' . $info[7]); if ($stat['ts'] && $stat['ts'] > $now && strpos($info[7], ':') !== false) { $stat['ts'] = strtotime($info[5] . ' ' . $info[6] . ' ' . $lastyear . ' ' . $info[7]); } if (empty($stat['ts'])) { $stat['ts'] = strtotime($info[6] . ' ' . $info[5] . ' ' . $info[7]); if ($stat['ts'] && $stat['ts'] > $now && strpos($info[7], ':') !== false) { $stat['ts'] = strtotime($info[6] . ' ' . $info[5] . ' ' . $lastyear . ' ' . $info[7]); } } } if ($this->options['statOwner']) { $stat['owner'] = $info[2]; $stat['group'] = $info[3]; $stat['perm'] = substr($info[0], 1); // // if not exists owner in LS ftp ==> isowner = true // if is defined as option : 'owner' => true isowner = true // // if exist owner in LS ftp and 'owner' => False isowner = result of owner(file) == user(logged with ftp) // $stat['isowner'] = isset($stat['owner']) ? ($this->options['owner'] ? true : ($stat['owner'] == $this->options['user'])) : true; } $owner_computed = isset($stat['isowner']) ? $stat['isowner'] : $this->options['owner']; $perm = $this->parsePermissions($info[0], $owner_computed); $stat['name'] = $name; $stat['mime'] = substr(strtolower($info[0]), 0, 1) == 'd' ? 'directory' : $this->mimetype($stat['name'], true); $stat['size'] = $stat['mime'] == 'directory' ? 0 : $info[4]; $stat['read'] = $perm['read']; $stat['write'] = $perm['write']; return $stat; } /** * Normalize MS-DOS style FTP LIST Raw line * * @param string $raw line from FTP LIST (MS-DOS style) * * @return array * @author Naoki Sawada **/ protected function normalizeRawWindows($raw) { $info = array_pad(array(), 9, ''); $item = preg_replace('#\s+#', ' ', trim($raw), 3); list($date, $time, $size, $name) = explode(' ', $item, 4); $format = strlen($date) === 8 ? 'm-d-yH:iA' : 'Y-m-dH:i'; $dateObj = DateTime::createFromFormat($format, $date . $time); $info[5] = strtotime($dateObj->format('Y-m-d H:i')); $info[8] = $name; if ($size === '<DIR>') { $info[4] = 0; $info[0] = 'drwxr-xr-x'; } else { $info[4] = (int)$size; $info[0] = '-rw-r--r--'; } return $info; } /** * Parse permissions string. Return array(read => true/false, write => true/false) * * @param string $perm permissions string 'rwx' + 'rwx' + 'rwx' * ^ ^ ^ * | | +-> others * | +---------> group * +-----------------> owner * The isowner parameter is computed by the caller. * If the owner parameter in the options is true, the user is the actual owner of all objects even if che user used in the ftp Login * is different from the file owner id. * If the owner parameter is false to understand if the user is the file owner we compare the ftp user with the file owner id. * @param Boolean $isowner . Tell if the current user is the owner of the object. * * @return array * @author Dmitry (dio) Levashov * @author Ugo Vierucci */ protected function parsePermissions($perm, $isowner = true) { $res = array(); $parts = array(); for ($i = 0, $l = strlen($perm); $i < $l; $i++) { $parts[] = substr($perm, $i, 1); } $read = ($isowner && $parts[1] == 'r') || $parts[4] == 'r' || $parts[7] == 'r'; return array( 'read' => $parts[0] == 'd' ? $read && (($isowner && $parts[3] == 'x') || $parts[6] == 'x' || $parts[9] == 'x') : $read, 'write' => ($isowner && $parts[2] == 'w') || $parts[5] == 'w' || $parts[8] == 'w' ); } /** * Cache dir contents * * @param string $path dir path * * @return void * @author Dmitry Levashov **/ protected function cacheDir($path) { $this->dirsCache[$path] = array(); $hasDir = false; $list = array(); $encPath = $this->convEncIn($path); foreach ($this->ftpRawList($encPath) as $raw) { if (($stat = $this->parseRaw($raw, $encPath))) { $list[] = $stat; } } $list = $this->convEncOut($list); $prefix = ($path === $this->separator) ? $this->separator : $path . $this->separator; $targets = array(); foreach ($list as $stat) { $p = $prefix . $stat['name']; if (isset($stat['target'])) { // stat later $targets[$stat['name']] = $stat['target']; } else { $stat = $this->updateCache($p, $stat); if (empty($stat['hidden'])) { if (!$hasDir && $stat['mime'] === 'directory') { $hasDir = true; } $this->dirsCache[$path][] = $p; } } } // stat link targets foreach ($targets as $name => $target) { $stat = array(); $stat['name'] = $name; $p = $prefix . $name; $cacheDirTarget = $this->cacheDirTarget; $this->cacheDirTarget = $this->convEncIn($target, true); if ($tstat = $this->stat($target)) { $stat['size'] = $tstat['size']; $stat['alias'] = $target; $stat['thash'] = $tstat['hash']; $stat['mime'] = $tstat['mime']; $stat['read'] = $tstat['read']; $stat['write'] = $tstat['write']; if (isset($tstat['ts'])) { $stat['ts'] = $tstat['ts']; } if (isset($tstat['owner'])) { $stat['owner'] = $tstat['owner']; } if (isset($tstat['group'])) { $stat['group'] = $tstat['group']; } if (isset($tstat['perm'])) { $stat['perm'] = $tstat['perm']; } if (isset($tstat['isowner'])) { $stat['isowner'] = $tstat['isowner']; } } else { $stat['mime'] = 'symlink-broken'; $stat['read'] = false; $stat['write'] = false; $stat['size'] = 0; } $this->cacheDirTarget = $cacheDirTarget; $stat = $this->updateCache($p, $stat); if (empty($stat['hidden'])) { if (!$hasDir && $stat['mime'] === 'directory') { $hasDir = true; } $this->dirsCache[$path][] = $p; } } if (isset($this->sessionCache['subdirs'])) { $this->sessionCache['subdirs'][$path] = $hasDir; } } /** * Return ftp transfer mode for file * * @param string $path file path * * @return string * @author Dmitry (dio) Levashov **/ protected function ftpMode($path) { return strpos($this->mimetype($path), 'text/') === 0 ? FTP_ASCII : FTP_BINARY; } /*********************** paths/urls *************************/ /** * Return parent directory path * * @param string $path file path * * @return string * @author Naoki Sawada **/ protected function _dirname($path) { $parts = explode($this->separator, trim($path, $this->separator)); array_pop($parts); return $this->separator . join($this->separator, $parts); } /** * Return file name * * @param string $path file path * * @return string * @author Naoki Sawada **/ protected function _basename($path) { $parts = explode($this->separator, trim($path, $this->separator)); return array_pop($parts); } /** * Join dir name and file name and retur full path * * @param string $dir * @param string $name * * @return string * @author Dmitry (dio) Levashov **/ protected function _joinPath($dir, $name) { return rtrim($dir, $this->separator) . $this->separator . $name; } /** * Return normalized path, this works the same as os.path.normpath() in Python * * @param string $path path * * @return string * @author Troex Nevelin **/ protected function _normpath($path) { if (empty($path)) { $path = '.'; } // path must be start with / $path = preg_replace('|^\.\/?|', $this->separator, $path); $path = preg_replace('/^([^\/])/', "/$1", $path); if ($path[0] === $this->separator) { $initial_slashes = true; } else { $initial_slashes = false; } if (($initial_slashes) && (strpos($path, '//') === 0) && (strpos($path, '///') === false)) { $initial_slashes = 2; } $initial_slashes = (int)$initial_slashes; $comps = explode($this->separator, $path); $new_comps = array(); foreach ($comps as $comp) { if (in_array($comp, array('', '.'))) { continue; } if (($comp != '..') || (!$initial_slashes && !$new_comps) || ($new_comps && (end($new_comps) == '..'))) { array_push($new_comps, $comp); } elseif ($new_comps) { array_pop($new_comps); } } $comps = $new_comps; $path = implode($this->separator, $comps); if ($initial_slashes) { $path = str_repeat($this->separator, $initial_slashes) . $path; } return $path ? $path : '.'; } /** * Return file path related to root dir * * @param string $path file path * * @return string * @author Dmitry (dio) Levashov **/ protected function _relpath($path) { if ($path === $this->root) { return ''; } else { if (strpos($path, $this->root) === 0) { return ltrim(substr($path, strlen($this->root)), $this->separator); } else { // for link return $path; } } } /** * Convert path related to root dir into real path * * @param string $path file path * * @return string * @author Dmitry (dio) Levashov **/ protected function _abspath($path) { if ($path === $this->separator) { return $this->root; } else { if ($path[0] === $this->separator) { // for link return $path; } else { return $this->_joinPath($this->root, $path); } } } /** * Return fake path started from root dir * * @param string $path file path * * @return string * @author Dmitry (dio) Levashov **/ protected function _path($path) { return $this->rootName . ($path == $this->root ? '' : $this->separator . $this->_relpath($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 **/ protected function _inpath($path, $parent) { return $path == $parent || strpos($path, rtrim($parent, $this->separator) . $this->separator) === 0; } /***************** file stat ********************/ /** * 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 **/ protected function _stat($path) { $outPath = $this->convEncOut($path); if (isset($this->cache[$outPath])) { return $this->convEncIn($this->cache[$outPath]); } else { $this->convEncIn(); } if (!$this->MLSTsupprt) { if ($path === $this->root) { $res = array( 'name' => $this->root, 'mime' => 'directory', 'dirs' => -1 ); if ($this->needOnline && (($this->ARGS['cmd'] === 'open' && $this->ARGS['target'] === $this->encode($this->root)) || $this->isMyReload())) { $check = array( 'ts' => true, 'dirs' => true, ); $ts = 0; foreach ($this->ftpRawList($path) as $str) { $info = preg_split('/\s+/', $str, 9); if ($info[8] === '.') { $info[8] = 'root'; if ($stat = $this->parseRaw(join(' ', $info), $path)) { unset($stat['name']); $res = array_merge($res, $stat); if ($res['ts']) { $ts = 0; unset($check['ts']); } } } if ($check && ($stat = $this->parseRaw($str, $path))) { if (isset($stat['ts']) && !empty($stat['ts'])) { $ts = max($ts, $stat['ts']); } if (isset($stat['dirs']) && $stat['mime'] === 'directory') { $res['dirs'] = 1; unset($stat['dirs']); } if (!$check) { break; } } } if ($ts) { $res['ts'] = $ts; } $this->cache[$outPath] = $res; } return $res; } $pPath = $this->_dirname($path); if ($this->_inPath($pPath, $this->root)) { $outPPpath = $this->convEncOut($pPath); if (!isset($this->dirsCache[$outPPpath])) { $parentSubdirs = null; if (isset($this->sessionCache['subdirs']) && isset($this->sessionCache['subdirs'][$outPPpath])) { $parentSubdirs = $this->sessionCache['subdirs'][$outPPpath]; } $this->cacheDir($outPPpath); if ($parentSubdirs) { $this->sessionCache['subdirs'][$outPPpath] = $parentSubdirs; } } } $stat = $this->convEncIn(isset($this->cache[$outPath]) ? $this->cache[$outPath] : array()); if (!$this->mounted) { // dispose incomplete cache made by calling `stat` by 'startPath' option $this->cache = array(); } return $stat; } $raw = ftp_raw($this->connect, 'MLST ' . $path); if (is_array($raw) && count($raw) > 1 && substr(trim($raw[0]), 0, 1) == 2) { $parts = explode(';', trim($raw[1])); array_pop($parts); $parts = array_map('strtolower', $parts); $stat = array(); $mode = ''; foreach ($parts as $part) { list($key, $val) = explode('=', $part, 2); switch ($key) { case 'type': if (strpos($val, 'dir') !== false) { $stat['mime'] = 'directory'; } else if (strpos($val, 'link') !== false) { $stat['mime'] = 'symlink'; break(2); } else { $stat['mime'] = $this->mimetype($path); } break; case 'size': $stat['size'] = $val; break; case 'modify': $ts = mktime(intval(substr($val, 8, 2)), intval(substr($val, 10, 2)), intval(substr($val, 12, 2)), intval(substr($val, 4, 2)), intval(substr($val, 6, 2)), substr($val, 0, 4)); $stat['ts'] = $ts; break; case 'unix.mode': $mode = strval($val); break; case 'unix.uid': $stat['owner'] = $val; break; case 'unix.gid': $stat['group'] = $val; break; case 'perm': $val = strtolower($val); $stat['read'] = (int)preg_match('/e|l|r/', $val); $stat['write'] = (int)preg_match('/w|m|c/', $val); if (!preg_match('/f|d/', $val)) { $stat['locked'] = 1; } break; } } if (empty($stat['mime'])) { return array(); } // do not use MLST to get stat of symlink if ($stat['mime'] === 'symlink') { $this->MLSTsupprt = false; $res = $this->_stat($path); $this->MLSTsupprt = true; return $res; } if ($stat['mime'] === 'directory') { $stat['size'] = 0; } if ($mode) { $stat['perm'] = ''; if ($mode[0] === '0') { $mode = substr($mode, 1); } $perm = array(); for ($i = 0; $i <= 2; $i++) { $perm[$i] = array(false, false, false); $n = isset($mode[$i]) ? $mode[$i] : 0; if ($n - 4 >= 0) { $perm[$i][0] = true; $n = $n - 4; $stat['perm'] .= 'r'; } else { $stat['perm'] .= '-'; } if ($n - 2 >= 0) { $perm[$i][1] = true; $n = $n - 2; $stat['perm'] .= 'w'; } else { $stat['perm'] .= '-'; } if ($n - 1 == 0) { $perm[$i][2] = true; $stat['perm'] .= 'x'; } else { $stat['perm'] .= '-'; } } $stat['perm'] = trim($stat['perm']); // // if not exists owner in LS ftp ==> isowner = true // if is defined as option : 'owner' => true isowner = true // // if exist owner in LS ftp and 'owner' => False isowner = result of owner(file) == user(logged with ftp) $owner_computed = isset($stat['owner']) ? ($this->options['owner'] ? true : ($stat['owner'] == $this->options['user'])) : true; $read = ($owner_computed && $perm[0][0]) || $perm[1][0] || $perm[2][0]; $stat['read'] = $stat['mime'] == 'directory' ? $read && (($owner_computed && $perm[0][2]) || $perm[1][2] || $perm[2][2]) : $read; $stat['write'] = ($owner_computed && $perm[0][1]) || $perm[1][1] || $perm[2][1]; if ($this->options['statOwner']) { $stat['isowner'] = $owner_computed; } else { unset($stat['owner'], $stat['group'], $stat['perm']); } } return $stat; } return array(); } /** * Return true if path is dir and has at least one childs directory * * @param string $path dir path * * @return bool * @author Dmitry (dio) Levashov **/ protected function _subdirs($path) { foreach ($this->ftpRawList($path) as $str) { $info = preg_split('/\s+/', $str, 9); if (!isset($this->ftpOsUnix)) { $this->ftpOsUnix = !preg_match('/\d/', substr($info[0], 0, 1)); } if (!$this->ftpOsUnix) { $info = $this->normalizeRawWindows($str); } $name = isset($info[8]) ? trim($info[8]) : ''; if ($name && $name !== '.' && $name !== '..' && substr(strtolower($info[0]), 0, 1) === 'd') { return true; } } return false; } /** * 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|false * @throws ImagickException * @throws elFinderAbortException * @author Dmitry (dio) Levashov */ protected function _dimensions($path, $mime) { $ret = false; if ($imgsize = $this->getImageSize($path, $mime)) { $ret = array('dim' => $imgsize['dimensions']); if (!empty($imgsize['url'])) { $ret['url'] = $imgsize['url']; } } return $ret; } /******************** file/dir content *********************/ /** * Return files list in directory. * * @param string $path dir path * * @return array * @author Dmitry (dio) Levashov * @author Cem (DiscoFever) **/ protected function _scandir($path) { $files = array(); foreach ($this->ftpRawList($path) as $str) { if (($stat = $this->parseRaw($str, $path, true))) { $files[] = $this->_joinPath($path, $stat['name']); } } return $files; } /** * Open file and return file pointer * * @param string $path file path * @param string $mode * * @return false|resource * @throws elFinderAbortException * @internal param bool $write open file for writing * @author Dmitry (dio) Levashov */ protected function _fopen($path, $mode = 'rb') { // try ftp stream wrapper if ($this->options['mode'] === 'passive' && ini_get('allow_url_fopen')) { $url = ($this->isFTPS ? 'ftps' : 'ftp') . '://' . $this->options['user'] . ':' . $this->options['pass'] . '@' . $this->options['host'] . ':' . $this->options['port'] . $path; if (strtolower($mode[0]) === 'w') { $context = stream_context_create(array('ftp' => array('overwrite' => true))); $fp = fopen($url, $mode, false, $context); } else { $fp = fopen($url, $mode); } if ($fp) { return $fp; } } if ($this->tmp) { $local = $this->getTempFile($path); $fp = fopen($local, 'wb'); $ret = ftp_nb_fget($this->connect, $fp, $path, FTP_BINARY); while ($ret === FTP_MOREDATA) { elFinder::extendTimeLimit(); $ret = ftp_nb_continue($this->connect); } if ($ret === FTP_FINISHED) { fclose($fp); $fp = fopen($local, $mode); return $fp; } fclose($fp); is_file($local) && unlink($local); } return false; } /** * Close opened file * * @param resource $fp file pointer * @param string $path * * @return void * @author Dmitry (dio) Levashov */ protected function _fclose($fp, $path = '') { is_resource($fp) && fclose($fp); if ($path) { unlink($this->getTempFile($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 **/ protected function _mkdir($path, $name) { $path = $this->_joinPath($path, $name); if (ftp_mkdir($this->connect, $path) === false) { return false; } $this->options['dirMode'] && ftp_chmod($this->connect, $this->options['dirMode'], $path); return $path; } /** * 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 **/ protected function _mkfile($path, $name) { if ($this->tmp) { $path = $this->_joinPath($path, $name); $local = $this->getTempFile(); $res = touch($local) && ftp_put($this->connect, $path, $local, FTP_ASCII); unlink($local); return $res ? $path : false; } return false; } /** * Create symlink. FTP driver does not support symlinks. * * @param string $target link target * @param string $path symlink path * @param string $name * * @return bool * @author Dmitry (dio) Levashov */ protected function _symlink($target, $path, $name) { return false; } /** * Copy file into another file * * @param string $source source file path * @param string $targetDir target directory path * @param string $name new file name * * @return bool * @author Dmitry (dio) Levashov **/ protected function _copy($source, $targetDir, $name) { $res = false; if ($this->tmp) { $local = $this->getTempFile(); $target = $this->_joinPath($targetDir, $name); if (ftp_get($this->connect, $local, $source, FTP_BINARY) && ftp_put($this->connect, $target, $local, $this->ftpMode($target))) { $res = $target; } unlink($local); } return $res; } /** * 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 */ protected function _move($source, $targetDir, $name) { $target = $this->_joinPath($targetDir, $name); return ftp_rename($this->connect, $source, $target) ? $target : false; } /** * Remove file * * @param string $path file path * * @return bool * @author Dmitry (dio) Levashov **/ protected function _unlink($path) { return ftp_delete($this->connect, $path); } /** * Remove dir * * @param string $path dir path * * @return bool * @author Dmitry (dio) Levashov **/ protected function _rmdir($path) { return ftp_rmdir($this->connect, $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 **/ protected function _save($fp, $dir, $name, $stat) { $path = $this->_joinPath($dir, $name); return ftp_fput($this->connect, $path, $fp, $this->ftpMode($path)) ? $path : false; } /** * Get file contents * * @param string $path file path * * @return string|false * @throws elFinderAbortException * @author Dmitry (dio) Levashov */ protected function _getContents($path) { $contents = ''; if (($fp = $this->_fopen($path))) { while (!feof($fp)) { $contents .= fread($fp, 8192); } $this->_fclose($fp, $path); return $contents; } return false; } /** * Write a string to a file * * @param string $path file path * @param string $content new file content * * @return bool * @author Dmitry (dio) Levashov **/ protected function _filePutContents($path, $content) { $res = false; if ($this->tmp) { $local = $this->getTempFile(); if (file_put_contents($local, $content, LOCK_EX) !== false && ($fp = fopen($local, 'rb'))) { $file = $this->stat($this->convEncOut($path, false)); if (!empty($file['thash'])) { $path = $this->decode($file['thash']); } clearstatcache(); $res = ftp_fput($this->connect, $path, $fp, $this->ftpMode($path)); fclose($fp); } file_exists($local) && unlink($local); } return $res; } /** * Detect available archivers * * @return void * @throws elFinderAbortException */ protected function _checkArchivers() { $this->archivers = $this->getArchivers(); return; } /** * chmod availability * * @param string $path * @param string $mode * * @return bool */ protected function _chmod($path, $mode) { $modeOct = is_string($mode) ? octdec($mode) : octdec(sprintf("%04o", $mode)); return ftp_chmod($this->connect, $modeOct, $path); } /** * Extract files from archive * * @param string $path archive path * @param array $arc archiver command and arguments (same as in $this->archivers) * * @return true * @throws elFinderAbortException * @author Dmitry (dio) Levashov, * @author Alexey Sukhotin */ protected function _extract($path, $arc) { $dir = $this->tempDir(); if (!$dir) { return false; } $basename = $this->_basename($path); $localPath = $dir . DIRECTORY_SEPARATOR . $basename; if (!ftp_get($this->connect, $localPath, $path, FTP_BINARY)) { //cleanup $this->rmdirRecursive($dir); return false; } $this->unpackArchive($localPath, $arc); $this->archiveSize = 0; // find symlinks and check extracted items $checkRes = $this->checkExtractItems($dir); if ($checkRes['symlinks']) { $this->rmdirRecursive($dir); return $this->setError(array_merge($this->error, array(elFinder::ERROR_ARC_SYMLINKS))); } $this->archiveSize = $checkRes['totalSize']; if ($checkRes['rmNames']) { foreach ($checkRes['rmNames'] as $name) { $this->addError(elFinder::ERROR_SAVE, $name); } } $filesToProcess = self::listFilesInDirectory($dir, true); // no files - extract error ? if (empty($filesToProcess)) { $this->rmdirRecursive($dir); return false; } // check max files size if ($this->options['maxArcFilesSize'] > 0 && $this->options['maxArcFilesSize'] < $this->archiveSize) { $this->rmdirRecursive($dir); return $this->setError(elFinder::ERROR_ARC_MAXSIZE); } $extractTo = $this->extractToNewdir; // 'auto', ture or false // archive contains one item - extract in archive dir $name = ''; $src = $dir . DIRECTORY_SEPARATOR . $filesToProcess[0]; if (($extractTo === 'auto' || !$extractTo) && count($filesToProcess) === 1 && is_file($src)) { $name = $filesToProcess[0]; } else if ($extractTo === 'auto' || $extractTo) { // for several files - create new directory // create unique name for directory $src = $dir; $splits = elFinder::splitFileExtention(basename($path)); $name = $splits[0]; $test = $this->_joinPath(dirname($path), $name); if ($this->stat($test)) { $name = $this->uniqueName(dirname($path), $name, '-', false); } } if ($name !== '' && is_file($src)) { $result = $this->_joinPath(dirname($path), $name); if (!ftp_put($this->connect, $result, $src, FTP_BINARY)) { $this->rmdirRecursive($dir); return false; } } else { $dstDir = $this->_dirname($path); $result = array(); if (is_dir($src) && $name) { $target = $this->_joinPath($dstDir, $name); $_stat = $this->_stat($target); if ($_stat) { if (!$this->options['copyJoin']) { if ($_stat['mime'] === 'directory') { $this->delTree($target); } else { $this->_unlink($target); } $_stat = false; } else { $dstDir = $target; } } if (!$_stat && (!$dstDir = $this->_mkdir($dstDir, $name))) { $this->rmdirRecursive($dir); return false; } $result[] = $dstDir; } foreach ($filesToProcess as $name) { $name = rtrim($name, DIRECTORY_SEPARATOR); $src = $dir . DIRECTORY_SEPARATOR . $name; if (is_dir($src)) { $p = dirname($name); if ($p === '.') { $p = ''; } $name = basename($name); $target = $this->_joinPath($this->_joinPath($dstDir, $p), $name); $_stat = $this->_stat($target); if ($_stat) { if (!$this->options['copyJoin']) { if ($_stat['mime'] === 'directory') { $this->delTree($target); } else { $this->_unlink($target); } $_stat = false; } } if (!$_stat && (!$target = $this->_mkdir($this->_joinPath($dstDir, $p), $name))) { $this->rmdirRecursive($dir); return false; } } else { $target = $this->_joinPath($dstDir, $name); if (!ftp_put($this->connect, $target, $src, FTP_BINARY)) { $this->rmdirRecursive($dir); return false; } } $result[] = $target; } if (!$result) { $this->rmdirRecursive($dir); return false; } } is_dir($dir) && $this->rmdirRecursive($dir); $this->clearcache(); return $result ? $result : false; } /** * 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 */ protected function _archive($dir, $files, $name, $arc) { // get current directory $cwd = getcwd(); $tmpDir = $this->tempDir(); if (!$tmpDir) { return false; } //download data if (!$this->ftp_download_files($dir, $files, $tmpDir)) { //cleanup $this->rmdirRecursive($tmpDir); return false; } $remoteArchiveFile = false; if ($path = $this->makeArchive($tmpDir, $files, $name, $arc)) { $remoteArchiveFile = $this->_joinPath($dir, $name); if (!ftp_put($this->connect, $remoteArchiveFile, $path, FTP_BINARY)) { $remoteArchiveFile = false; } } //cleanup if (!$this->rmdirRecursive($tmpDir)) { return false; } return $remoteArchiveFile; } /** * Create writable temporary directory and return path to it. * * @return string path to the new temporary directory or false in case of error. */ private function tempDir() { $tempPath = tempnam($this->tmp, 'elFinder'); if (!$tempPath) { $this->setError(elFinder::ERROR_CREATING_TEMP_DIR, $this->tmp); return false; } $success = unlink($tempPath); if (!$success) { $this->setError(elFinder::ERROR_CREATING_TEMP_DIR, $this->tmp); return false; } $success = mkdir($tempPath, 0700, true); if (!$success) { $this->setError(elFinder::ERROR_CREATING_TEMP_DIR, $this->tmp); return false; } return $tempPath; } /** * Gets an array of absolute remote FTP paths of files and * folders in $remote_directory omitting symbolic links. * * @param $remote_directory string remote FTP path to scan for file and folders recursively * @param $targets array Array of target item. `null` is to get all of items * * @return array of elements each of which is an array of two elements: * <ul> * <li>$item['path'] - absolute remote FTP path</li> * <li>$item['type'] - either 'f' for file or 'd' for directory</li> * </ul> */ protected function ftp_scan_dir($remote_directory, $targets = null) { $buff = $this->ftpRawList($remote_directory); $items = array(); if ($targets && is_array($targets)) { $targets = array_flip($targets); } else { $targets = false; } foreach ($buff as $str) { $info = preg_split("/\s+/", $str, 9); if (!isset($this->ftpOsUnix)) { $this->ftpOsUnix = !preg_match('/\d/', substr($info[0], 0, 1)); } if (!$this->ftpOsUnix) { $info = $this->normalizeRawWindows($str); } $type = substr($info[0], 0, 1); $name = trim($info[8]); if ($name !== '.' && $name !== '..' && (!$targets || isset($targets[$name]))) { switch ($type) { case 'l' : //omit symbolic links case 'd' : $remote_file_path = $this->_joinPath($remote_directory, $name); $item = array(); $item['path'] = $remote_file_path; $item['type'] = 'd'; // normal file $items[] = $item; $items = array_merge($items, $this->ftp_scan_dir($remote_file_path)); break; default: $remote_file_path = $this->_joinPath($remote_directory, $name); $item = array(); $item['path'] = $remote_file_path; $item['type'] = 'f'; // normal file $items[] = $item; } } } return $items; } /** * Downloads specified files from remote directory * if there is a directory among files it is downloaded recursively (omitting symbolic links). * * @param $remote_directory string remote FTP path to a source directory to download from. * @param array $files list of files to download from remote directory. * @param $dest_local_directory string destination folder to store downloaded files. * * @return bool true on success and false on failure. */ private function ftp_download_files($remote_directory, array $files, $dest_local_directory) { $contents = $this->ftp_scan_dir($remote_directory, $files); if (!isset($contents)) { $this->setError(elFinder::ERROR_FTP_DOWNLOAD_FILE, $remote_directory); return false; } $remoteDirLen = strlen($remote_directory); foreach ($contents as $item) { $relative_path = substr($item['path'], $remoteDirLen); $local_path = $dest_local_directory . DIRECTORY_SEPARATOR . $relative_path; switch ($item['type']) { case 'd': $success = mkdir($local_path); break; case 'f': $success = ftp_get($this->connect, $local_path, $item['path'], FTP_BINARY); break; default: $success = true; } if (!$success) { $this->setError(elFinder::ERROR_FTP_DOWNLOAD_FILE, $remote_directory); return false; } } return true; } /** * Delete local directory recursively. * * @param $dirPath string to directory to be erased. * * @return bool true on success and false on failure. * @throws Exception */ private function deleteDir($dirPath) { if (!is_dir($dirPath)) { $success = unlink($dirPath); } else { $success = true; foreach (array_reverse(elFinderVolumeFTP::listFilesInDirectory($dirPath, false)) as $path) { $path = $dirPath . DIRECTORY_SEPARATOR . $path; if (is_link($path)) { unlink($path); } else if (is_dir($path)) { $success = rmdir($path); } else { $success = unlink($path); } if (!$success) { break; } } if ($success) { $success = rmdir($dirPath); } } if (!$success) { $this->setError(elFinder::ERROR_RM, $dirPath); return false; } return $success; } /** * Returns array of strings containing all files and folders in the specified local directory. * * @param $dir * @param $omitSymlinks * @param string $prefix * * @return array array of files and folders names relative to the $path * or an empty array if the directory $path is empty, * <br /> * false if $path is not a directory or does not exist. * @throws Exception * @internal param string $path path to directory to scan. */ private static function listFilesInDirectory($dir, $omitSymlinks, $prefix = '') { if (!is_dir($dir)) { return false; } $excludes = array(".", ".."); $result = array(); $files = self::localScandir($dir); if (!$files) { return array(); } foreach ($files as $file) { if (!in_array($file, $excludes)) { $path = $dir . DIRECTORY_SEPARATOR . $file; if (is_link($path)) { if ($omitSymlinks) { continue; } else { $result[] = $prefix . $file; } } else if (is_dir($path)) { $result[] = $prefix . $file . DIRECTORY_SEPARATOR; $subs = elFinderVolumeFTP::listFilesInDirectory($path, $omitSymlinks, $prefix . $file . DIRECTORY_SEPARATOR); if ($subs) { $result = array_merge($result, $subs); } } else { $result[] = $prefix . $file; } } } return $result; } } // END class