drg_elfinder 0.1.0

data/app/assets/javascripts/elfinder/php/elFinderVolumeDropbox2.class.php

@@ -0,0 +1,1516 @@
+<?php
+
+use Kunnu\Dropbox\Dropbox;
+use Kunnu\Dropbox\DropboxApp;
+use Kunnu\Dropbox\DropboxFile;
+use Kunnu\Dropbox\Exceptions\DropboxClientException;
+use Kunnu\Dropbox\Models\FileMetadata;
+use Kunnu\Dropbox\Models\FolderMetadata;
+
+/**
+ * Simple elFinder driver for Dropbox
+ * kunalvarma05/dropbox-php-sdk:0.1.5 or above.
+ *
+ * @author Naoki Sawada
+ **/
+class elFinderVolumeDropbox2 extends elFinderVolumeDriver
+{
+    /**
+     * Driver id
+     * Must be started from letter and contains [a-z0-9]
+     * Used as part of volume id.
+     *
+     * @var string
+     **/
+    protected $driverId = 'db';
+
+    /**
+     * Dropbox service object.
+     *
+     * @var object
+     **/
+    protected $service = null;
+
+    /**
+     * Fetch options.
+     *
+     * @var string
+     */
+    private $FETCH_OPTIONS = [];
+
+    /**
+     * Directory for tmp files
+     * If not set driver will try to use tmbDir as tmpDir.
+     *
+     * @var string
+     **/
+    protected $tmp = '';
+
+    /**
+     * Net mount key.
+     *
+     * @var string
+     **/
+    public $netMountKey = '';
+
+    /**
+     * Constructor
+     * Extend options with required fields.
+     *
+     * @author Naoki Sawada
+     **/
+    public function __construct()
+    {
+        $opts = [
+            'app_key' => '',
+            'app_secret' => '',
+            'access_token' => '',
+            'aliasFormat' => '%s@Dropbox',
+            'path' => '/',
+            'separator' => '/',
+            'acceptedName' => '#^[^\\\/]+$#',
+            'rootCssClass' => 'elfinder-navbar-root-dropbox',
+            'publishPermission' => [
+                'requested_visibility' => 'public',
+                //'link_password' => '',
+                //'expires' => '',
+            ],
+            'getThumbSize' => 'medium', // Available sizes: 'thumb', 'small', 'medium', 'large', 'huge'
+        ];
+        $this->options = array_merge($this->options, $opts);
+        $this->options['mimeDetect'] = 'internal';
+    }
+
+    /*********************************************************************/
+    /*                        ORIGINAL FUNCTIONS                         */
+    /*********************************************************************/
+
+    /**
+     * Get Parent ID, Item ID, Parent Path as an array from path.
+     *
+     * @param string $path
+     *
+     * @return array
+     */
+    protected function _db_splitPath($path)
+    {
+        $path = trim($path, '/');
+        if ($path === '') {
+            $dirname = '/';
+            $basename = '';
+        } else {
+            $pos = strrpos($path, '/');
+            if ($pos === false) {
+                $dirname = '/';
+                $basename = $path;
+            } else {
+                $dirname = '/' . substr($path, 0, $pos);
+                $basename = substr($path, $pos + 1);
+            }
+        }
+
+        return [$dirname, $basename];
+    }
+
+    /**
+     * Get dat(Dropbox metadata) from Dropbox.
+     *
+     * @param string $path
+     *
+     * @return boolean|object Dropbox metadata
+     */
+    private function _db_getFile($path)
+    {
+        if ($path === '/') {
+            return true;
+        }
+
+        $res = false;
+        try {
+            $file = $this->service->getMetadata($path, $this->FETCH_OPTIONS);
+            if ($file instanceof FolderMetadata || $file instanceof FileMetadata) {
+                $res = $file;
+            }
+
+            return $res;
+        } catch (DropboxClientException $e) {
+            return false;
+        }
+    }
+
+    /**
+     * Parse line from Dropbox metadata output and return file stat (array).
+     *
+     * @param object $raw line from ftp_rawlist() output
+     *
+     * @return array
+     * @author Naoki Sawada
+     **/
+    protected function _db_parseRaw($raw)
+    {
+        $stat = [];
+        $isFolder = false;
+        if ($raw === true) {
+            // root folder
+            $isFolder = true;
+            $stat['name'] = '';
+            $stat['iid'] = '0';
+        }
+
+        $data = [];
+        if (is_object($raw)) {
+            $isFolder = $raw instanceof FolderMetadata;
+            $data = $raw->getData();
+        } elseif (is_array($raw)) {
+            $isFolder = $raw['.tag'] === 'folder';
+            $data = $raw;
+        }
+
+        if (isset($data['path_lower'])) {
+            $stat['path'] = $data['path_lower'];
+        }
+
+        if (isset($data['name'])) {
+            $stat['name'] = $data['name'];
+        }
+
+        if (isset($data['id'])) {
+            $stat['iid'] = substr($data['id'], 3);
+        }
+
+        if ($isFolder) {
+            $stat['mime'] = 'directory';
+            $stat['size'] = 0;
+            $stat['ts'] = 0;
+            $stat['dirs'] = -1;
+        } else {
+            $stat['size'] = isset($data['size']) ? (int)$data['size'] : 0;
+            if (isset($data['server_modified'])) {
+                $stat['ts'] = strtotime($data['server_modified']);
+            } elseif (isset($data['client_modified'])) {
+                $stat['ts'] = strtotime($data['client_modified']);
+            } else {
+                $stat['ts'] = 0;
+            }
+            $stat['url'] = '1';
+        }
+
+        return $stat;
+    }
+
+    /**
+     * Get thumbnail from Dropbox.
+     *
+     * @param string $path
+     * @param string $size
+     *
+     * @return string | boolean
+     */
+    protected function _db_getThumbnail($path)
+    {
+        try {
+            return $this->service->getThumbnail($path, $this->options['getThumbSize'])->getContents();
+        } catch (DropboxClientException $e) {
+            return false;
+        }
+    }
+
+    /**
+     * Join dir name and file name(display name) and retur full path.
+     *
+     * @param string $dir
+     * @param string $displayName
+     *
+     * @return string
+     */
+    protected function _db_joinName($dir, $displayName)
+    {
+        return rtrim($dir, '/') . '/' . $displayName;
+    }
+
+    /**
+     * Get OAuth2 access token form OAuth1 tokens.
+     *
+     * @param string $app_key
+     * @param string $app_secret
+     * @param string $oauth1_token
+     * @param string $oauth1_secret
+     *
+     * @return string|false
+     */
+    public static function getTokenFromOauth1($app_key, $app_secret, $oauth1_token, $oauth1_secret)
+    {
+        $data = [
+            'oauth1_token' => $oauth1_token,
+            'oauth1_token_secret' => $oauth1_secret,
+        ];
+        $auth = base64_encode($app_key . ':' . $app_secret);
+
+        $ch = curl_init('https://api.dropboxapi.com/2/auth/token/from_oauth1');
+        curl_setopt($ch, CURLOPT_POST, true);
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+        curl_setopt($ch, CURLOPT_HTTPHEADER, [
+            'Content-Type: application/json',
+            'Authorization: Basic ' . $auth,
+        ]);
+        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
+        $result = curl_exec($ch);
+        curl_close($ch);
+
+        $res = $result ? json_decode($result, true) : [];
+
+        return isset($res['oauth2_token']) ? $res['oauth2_token'] : false;
+    }
+
+    /*********************************************************************/
+    /*                        EXTENDED FUNCTIONS                         */
+    /*********************************************************************/
+
+    /**
+     * Prepare
+     * Call from elFinder::netmout() before volume->mount().
+     *
+     * @return array
+     * @author Naoki Sawada
+     **/
+    public function netmountPrepare($options)
+    {
+        if (empty($options['app_key']) && defined('ELFINDER_DROPBOX_APPKEY')) {
+            $options['app_key'] = ELFINDER_DROPBOX_APPKEY;
+        }
+        if (empty($options['app_secret']) && defined('ELFINDER_DROPBOX_APPSECRET')) {
+            $options['app_secret'] = ELFINDER_DROPBOX_APPSECRET;
+        }
+
+        if (!isset($options['pass'])) {
+            $options['pass'] = '';
+        }
+
+        try {
+            $app = new DropboxApp($options['app_key'], $options['app_secret']);
+            $dropbox = new Dropbox($app);
+            $authHelper = $dropbox->getAuthHelper();
+
+            if ($options['pass'] === 'reauth') {
+                $options['pass'] = '';
+                $this->session->set('Dropbox2AuthParams', [])->set('Dropbox2Tokens', []);
+            } elseif ($options['pass'] === 'dropbox2') {
+                $options['pass'] = '';
+            }
+
+            $options = array_merge($this->session->get('Dropbox2AuthParams', []), $options);
+
+            if (!isset($options['tokens'])) {
+                $options['tokens'] = $this->session->get('Dropbox2Tokens', []);
+                $this->session->remove('Dropbox2Tokens');
+            }
+            $aToken = $options['tokens'];
+            if (!is_array($aToken) || !isset($aToken['access_token'])) {
+                $aToken = [];
+            }
+
+            $service = null;
+            if ($aToken) {
+                try {
+                    $dropbox->setAccessToken($aToken['access_token']);
+                    $this->session->set('Dropbox2AuthParams', $options);
+                } catch (DropboxClientException $e) {
+                    $aToken = [];
+                    $options['tokens'] = [];
+                    if ($options['user'] !== 'init') {
+                        $this->session->set('Dropbox2AuthParams', $options);
+
+                        return ['exit' => true, 'error' => elFinder::ERROR_REAUTH_REQUIRE];
+                    }
+                }
+            }
+
+            if ((isset($options['user']) && $options['user'] === 'init') || (isset($_GET['host']) && $_GET['host'] == '1')) {
+                if (empty($options['url'])) {
+                    $options['url'] = elFinder::getConnectorUrl();
+                }
+
+                if (!empty($options['id'])) {
+                    $callback = $options['url']
+                            . (strpos($options['url'], '?') !== false? '&' : '?') . 'cmd=netmount&protocol=dropbox2&host=' . ($options['id'] === 'elfinder'? '1' : $options['id']);
+                }
+
+                $itpCare = isset($options['code']);
+                $code = $itpCare? $options['code'] : (isset($_GET['code'])? $_GET['code'] : '');
+                $state = $itpCare? $options['state'] : (isset($_GET['state'])? $_GET['state'] : '');
+                if (!$aToken && empty($code)) {
+                    $url = $authHelper->getAuthUrl($callback);
+
+                    $html = '<input id="elf-volumedriver-dropbox2-host-btn" class="ui-button ui-widget ui-state-default ui-corner-all ui-button-text-only" value="{msg:btnApprove}" type="button">';
+                    $html .= '<script>
+                        $("#' . $options['id'] . '").elfinder("instance").trigger("netmount", {protocol: "dropbox2", mode: "makebtn", url: "' . $url . '"});
+                    </script>';
+                    if (empty($options['pass']) && $options['host'] !== '1') {
+                        $options['pass'] = 'return';
+                        $this->session->set('Dropbox2AuthParams', $options);
+
+                        return ['exit' => true, 'body' => $html];
+                    } else {
+                        $out = [
+                            'node' => $options['id'],
+                            'json' => '{"protocol": "dropbox2", "mode": "makebtn", "body" : "' . str_replace($html, '"', '\\"') . '", "error" : "' . elFinder::ERROR_ACCESS_DENIED . '"}',
+                            'bind' => 'netmount',
+                        ];
+
+                        return ['exit' => 'callback', 'out' => $out];
+                    }
+                } else {
+                    if ($code && $state) {
+                        if (!empty($options['id'])) {
+                            // see https://github.com/kunalvarma05/dropbox-php-sdk/issues/115
+                            $authHelper->getPersistentDataStore()->set('state', filter_var($state, FILTER_SANITIZE_STRING));
+                            $tokenObj = $authHelper->getAccessToken($code, $state, $callback);
+                            $options['tokens'] = [
+                                'access_token' => $tokenObj->getToken(),
+                                'uid' => $tokenObj->getUid(),
+                            ];
+                            unset($options['code'], $options['state']);
+                            $this->session->set('Dropbox2Tokens', $options['tokens'])->set('Dropbox2AuthParams', $options);
+                            $out = [
+                                'node' => $options['id'],
+                                'json' => '{"protocol": "dropbox2", "mode": "done", "reset": 1}',
+                                'bind' => 'netmount',
+                            ];
+                        } else {
+                            $nodeid = ($_GET['host'] === '1')? 'elfinder' : $_GET['host'];
+                            $out = [
+                                'node' => $nodeid,
+                                'json' => json_encode(array(
+                                    'protocol' => 'dropbox2',
+                                    'host' => $nodeid,
+                                    'mode' => 'redirect',
+                                    'options' => array(
+                                        'id' => $nodeid,
+                                        'code' => $code,
+                                        'state' => $state
+                                    )
+                                )),
+                                'bind' => 'netmount'
+                            ];
+                        }
+                        if (!$itpCare) {
+                            return array('exit' => 'callback', 'out' => $out);
+                        } else {
+                            return array('exit' => true, 'body' => $out['json']);
+                        }
+                    }
+                    $path = $options['path'];
+                    $folders = [];
+                    $listFolderContents = $dropbox->listFolder($path);
+                    $items = $listFolderContents->getItems();
+                    foreach ($items as $item) {
+                        $data = $item->getData();
+                        if ($data['.tag'] === 'folder') {
+                            $folders[$data['path_lower']] = $data['name'];
+                        }
+                    }
+                    natcasesort($folders);
+
+                    if ($options['pass'] === 'folders') {
+                        return ['exit' => true, 'folders' => $folders];
+                    }
+
+                    $folders = ['/' => '/'] + $folders;
+                    $folders = json_encode($folders);
+                    $json = '{"protocol": "dropbox2", "mode": "done", "folders": ' . $folders . '}';
+                    $options['pass'] = 'return';
+                    $html = 'Dropbox.com';
+                    $html .= '<script>
+                        $("#' . $options['id'] . '").elfinder("instance").trigger("netmount", ' . $json . ');
+                    </script>';
+                    $this->session->set('Dropbox2AuthParams', $options);
+
+                    return ['exit' => true, 'body' => $html];
+                }
+            }
+        } catch (DropboxClientException $e) {
+            $this->session->remove('Dropbox2AuthParams')->remove('Dropbox2Tokens');
+            if (empty($options['pass'])) {
+                return ['exit' => true, 'body' => '{msg:' . elFinder::ERROR_ACCESS_DENIED . '}' . ' ' . $e->getMessage()];
+            } else {
+                return ['exit' => true, 'error' => [elFinder::ERROR_ACCESS_DENIED, $e->getMessage()]];
+            }
+        }
+
+        if (!$aToken) {
+            return ['exit' => true, 'error' => elFinder::ERROR_REAUTH_REQUIRE];
+        }
+
+        if ($options['path'] === 'root') {
+            $options['path'] = '/';
+        }
+
+        try {
+            if ($options['path'] !== '/') {
+                $file = $dropbox->getMetadata($options['path']);
+                $name = $file->getName();
+            } else {
+                $name = 'root';
+            }
+            $options['alias'] = sprintf($this->options['aliasFormat'], $name);
+        } catch (DropboxClientException $e) {
+            return ['exit' => true, 'error' => $e->getMessage()];
+        }
+
+        foreach (['host', 'user', 'pass', 'id', 'offline'] as $key) {
+            unset($options[$key]);
+        }
+
+        return $options;
+    }
+
+    /**
+     * process of on netunmount
+     * Drop `Dropbox` & rm thumbs.
+     *
+     * @param array $options
+     *
+     * @return bool
+     */
+    public function netunmount($netVolumes, $key)
+    {
+        if ($tmbs = glob(rtrim($this->options['tmbPath'], '\\/') . DIRECTORY_SEPARATOR . $this->driverId . '_' . $this->options['tokens']['uid'] . '*.png')) {
+            foreach ($tmbs as $file) {
+                unlink($file);
+            }
+        }
+
+        return true;
+    }
+
+    /*********************************************************************/
+    /*                        INIT AND CONFIGURE                         */
+    /*********************************************************************/
+
+    /**
+     * Prepare Dropbox connection
+     * Connect to remote server and check if credentials are correct, if so, store the connection id in $this->service.
+     *
+     * @return bool
+     * @author Naoki Sawada
+     **/
+    protected function init()
+    {
+        if (empty($this->options['app_key'])) {
+            if (defined('ELFINDER_DROPBOX_APPKEY') && ELFINDER_DROPBOX_APPKEY) {
+                $this->options['app_key'] = ELFINDER_DROPBOX_APPKEY;
+            } else {
+                return $this->setError('Required option "app_key" is undefined.');
+            }
+        }
+        if (empty($this->options['app_secret'])) {
+            if (defined('ELFINDER_DROPBOX_APPSECRET') && ELFINDER_DROPBOX_APPSECRET) {
+                $this->options['app_secret'] = ELFINDER_DROPBOX_APPSECRET;
+            } else {
+                return $this->setError('Required option "app_secret" is undefined.');
+            }
+        }
+        if (isset($this->options['tokens']) && is_array($this->options['tokens']) && !empty($this->options['tokens']['access_token'])) {
+            $this->options['access_token'] = $this->options['tokens']['access_token'];
+        }
+        if (!$this->options['access_token']) {
+            return $this->setError('Required option "access_token" or "refresh_token" is undefined.');
+        }
+
+        try {
+            // make net mount key for network mount
+            $aToken = $this->options['access_token'];
+            $this->netMountKey = md5($aToken . '-' . $this->options['path']);
+
+            $errors = [];
+            if ($this->needOnline && !$this->service) {
+                $app = new DropboxApp($this->options['app_key'], $this->options['app_secret'], $aToken);
+                $this->service = new Dropbox($app);
+                // to check access_token
+                $this->service->getCurrentAccount();
+            }
+        } catch (DropboxClientException $e) {
+            $errors[] = 'Dropbox error: ' . $e->getMessage();
+        } catch (Exception $e) {
+            $errors[] = $e->getMessage();
+        }
+
+        if ($this->needOnline && !$this->service) {
+            $errors[] = 'Dropbox Service could not be loaded.';
+        }
+
+        if ($errors) {
+            return $this->setError($errors);
+        }
+
+        // normalize root path
+        $this->options['path'] = strtolower($this->options['path']);
+        if ($this->options['path'] == 'root') {
+            $this->options['path'] = '/';
+        }
+        $this->root = $this->options['path'] = $this->_normpath($this->options['path']);
+
+        if (empty($this->options['alias'])) {
+            $this->options['alias'] = sprintf($this->options['aliasFormat'], ($this->options['path'] === '/') ? 'Root' : $this->_basename($this->options['path']));
+            if (!empty($this->options['netkey'])) {
+                elFinder::$instance->updateNetVolumeOption($this->options['netkey'], 'alias', $this->options['alias']);
+            }
+        }
+
+        $this->rootName = $this->options['alias'];
+
+        if (!empty($this->options['tmpPath'])) {
+            if ((is_dir($this->options['tmpPath']) || mkdir($this->options['tmpPath'])) && is_writable($this->options['tmpPath'])) {
+                $this->tmp = $this->options['tmpPath'];
+            }
+        }
+
+        if (!$this->tmp && ($tmp = elFinder::getStaticVar('commonTempPath'))) {
+            $this->tmp = $tmp;
+        }
+
+        // This driver dose not support `syncChkAsTs`
+        $this->options['syncChkAsTs'] = false;
+
+        // 'lsPlSleep' minmum 10 sec
+        $this->options['lsPlSleep'] = max(10, $this->options['lsPlSleep']);
+
+        // enable command archive
+        $this->options['useRemoteArchive'] = true;
+
+        return true;
+    }
+
+    /**
+     * Configure after successfull mount.
+     *
+     * @author Naoki Sawada
+     * @throws elFinderAbortException
+     */
+    protected function configure()
+    {
+        parent::configure();
+
+        // fallback of $this->tmp
+        if (!$this->tmp && $this->tmbPathWritable) {
+            $this->tmp = $this->tmbPath;
+        }
+
+        if ($this->isMyReload()) {
+            //$this->_db_getDirectoryData(false);
+        }
+    }
+
+    /*********************************************************************/
+    /*                               FS API                              */
+    /*********************************************************************/
+
+    /**
+     * Close opened connection.
+     **/
+    public function umount()
+    {
+    }
+
+    /**
+     * Cache dir contents.
+     *
+     * @param string $path dir path
+     *
+     * @return
+     * @author Naoki Sawada
+     */
+    protected function cacheDir($path)
+    {
+        $this->dirsCache[$path] = [];
+        $hasDir = false;
+
+        $res = $this->service->listFolder($path, $this->FETCH_OPTIONS);
+
+        if ($res) {
+            $items = $res->getItems()->all();
+            foreach ($items as $raw) {
+                if ($stat = $this->_db_parseRaw($raw)) {
+                    $mountPath = $this->_joinPath($path, $stat['name']);
+                    $stat = $this->updateCache($mountPath, $stat);
+                    if (empty($stat['hidden']) && $path !== $mountPath) {
+                        if (!$hasDir && $stat['mime'] === 'directory') {
+                            $hasDir = true;
+                        }
+                        $this->dirsCache[$path][] = $mountPath;
+                    }
+                }
+            }
+        }
+
+        if (isset($this->sessionCache['subdirs'])) {
+            $this->sessionCache['subdirs'][$path] = $hasDir;
+        }
+
+        return $this->dirsCache[$path];
+    }
+
+    /**
+     * Recursive files search.
+     *
+     * @param string $path dir path
+     * @param string $q    search string
+     * @param array  $mimes
+     *
+     * @return array
+     * @throws elFinderAbortException
+     * @author Naoki Sawada
+     */
+    protected function doSearch($path, $q, $mimes)
+    {
+        if (!empty($this->doSearchCurrentQuery['matchMethod']) || $mimes) {
+            // has custom match method or mimes, use elFinderVolumeDriver::doSearch()
+            return parent::doSearch($path, $q, $mimes);
+        }
+
+        $timeout = $this->options['searchTimeout'] ? $this->searchStart + $this->options['searchTimeout'] : 0;
+
+        $searchRes = $this->service->search($path, $q, ['start' => 0, 'max_results' => 1000]);
+        $items = $searchRes->getItems();
+        $more = $searchRes->hasMoreItems();
+        while ($more) {
+            if ($timeout && $timeout < time()) {
+                $this->setError(elFinder::ERROR_SEARCH_TIMEOUT, $this->_path($path));
+                break;
+            }
+            $searchRes = $this->service->search($path, $q, ['start' => $searchRes->getCursor(), 'max_results' => 1000]);
+            $more = $searchRes->hasMoreItems();
+            $items = $items->merge($searchRes->getItems());
+        }
+
+        $result = [];
+        foreach ($items as $raw) {
+            if ($stat = $this->_db_parseRaw($raw->getMetadata())) {
+                $stat = $this->updateCache($stat['path'], $stat);
+                if (empty($stat['hidden'])) {
+                    $result[] = $stat;
+                }
+            }
+        }
+
+        return $result;
+    }
+
+    /**
+     * 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 Naoki Sawada
+     */
+    protected function copy($src, $dst, $name)
+    {
+        $srcStat = $this->stat($src);
+        $target = $this->_joinPath($dst, $name);
+        $tgtStat = $this->stat($target);
+        if ($tgtStat) {
+            if ($srcStat['mime'] === 'directory') {
+                return parent::copy($src, $dst, $name);
+            } else {
+                $this->_unlink($target);
+            }
+        }
+        $this->clearcache();
+        if ($res = $this->_copy($src, $dst, $name)) {
+            $this->added[] = $this->stat($target);
+            $res = $target;
+        }
+
+        return $res;
+    }
+
+    /**
+     * Remove file/ recursive remove dir.
+     *
+     * @param string $path  file path
+     * @param bool   $force try to remove even if file locked
+     * @param bool   $recursive
+     *
+     * @return bool
+     * @throws elFinderAbortException
+     * @author Naoki Sawada
+     */
+    protected function remove($path, $force = false, $recursive = false)
+    {
+        $stat = $this->stat($path);
+        $stat['realpath'] = $path;
+        $this->rmTmb($stat);
+        $this->clearcache();
+
+        if (empty($stat)) {
+            return $this->setError(elFinder::ERROR_RM, $this->_path($path), elFinder::ERROR_FILE_NOT_FOUND);
+        }
+
+        if (!$force && !empty($stat['locked'])) {
+            return $this->setError(elFinder::ERROR_LOCKED, $this->_path($path));
+        }
+
+        if ($stat['mime'] == 'directory') {
+            if (!$recursive && !$this->_rmdir($path)) {
+                return $this->setError(elFinder::ERROR_RM, $this->_path($path));
+            }
+        } else {
+            if (!$recursive && !$this->_unlink($path)) {
+                return $this->setError(elFinder::ERROR_RM, $this->_path($path));
+            }
+        }
+
+        $this->removed[] = $stat;
+
+        return true;
+    }
+
+    /**
+     * Create thumnbnail and return it's URL on success.
+     *
+     * @param string $path file path
+     * @param        $stat
+     *
+     * @return string|false
+     * @throws ImagickException
+     * @throws elFinderAbortException
+     * @author Naoki Sawada
+     */
+    protected function createTmb($path, $stat)
+    {
+        if (!$stat || !$this->canCreateTmb($path, $stat)) {
+            return false;
+        }
+
+        $name = $this->tmbname($stat);
+        $tmb = $this->tmbPath . DIRECTORY_SEPARATOR . $name;
+
+        // copy image into tmbPath so some drivers does not store files on local fs
+        if (!$data = $this->_db_getThumbnail($path)) {
+            return false;
+        }
+        if (!file_put_contents($tmb, $data)) {
+            return false;
+        }
+
+        $tmbSize = $this->tmbSize;
+
+        if (($s = getimagesize($tmb)) == false) {
+            return false;
+        }
+
+        $result = true;
+
+        /* 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']) {
+
+                /* 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($tmb, $tmbSize, $tmbSize, $x, $y, 'png');
+                }
+            } else {
+                $result = $this->imgResize($tmb, $tmbSize, $tmbSize, true, true, 'png');
+            }
+
+            if ($result) {
+                $result = $this->imgSquareFit($tmb, $tmbSize, $tmbSize, 'center', 'middle', $this->options['tmbBgColor'], 'png');
+
+            }
+        }
+
+        if (!$result) {
+            unlink($tmb);
+
+            return false;
+        }
+
+        return $name;
+    }
+
+    /**
+     * Return thumbnail file name for required file.
+     *
+     * @param array $stat file stat
+     *
+     * @return string
+     * @author Naoki Sawada
+     **/
+    protected function tmbname($stat)
+    {
+        $name = $this->driverId . '_';
+        if (isset($this->options['tokens']) && is_array($this->options['tokens'])) {
+            $name .= $this->options['tokens']['uid'];
+        }
+
+        return $name . md5($stat['iid']) . $stat['ts'] . '.png';
+    }
+
+    /**
+     * 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 bool|string
+     * @author Naoki Sawada
+     */
+    public function getContentUrl($hash, $options = [])
+    {
+        if (!empty($options['onetime']) && $this->options['onetimeUrl']) {
+            return parent::getContentUrl($hash, $options);
+        }
+        if (!empty($options['temporary'])) {
+            // try make temporary file
+            $url = parent::getContentUrl($hash, $options);
+            if ($url) {
+                return $url;
+            }
+        }
+        $file = $this->file($hash);
+        if (($file = $this->file($hash)) !== false && (!$file['url'] || $file['url'] == 1)) {
+            $path = $this->decode($hash);
+            $url = '';
+            try {
+                $res = $this->service->postToAPI('/sharing/list_shared_links', ['path' => $path, 'direct_only' => true])->getDecodedBody();
+                if ($res && !empty($res['links'])) {
+                    foreach ($res['links'] as $link) {
+                        if (isset($link['link_permissions'])
+                            && isset($link['link_permissions']['requested_visibility'])
+                            && $link['link_permissions']['requested_visibility']['.tag'] === $this->options['publishPermission']['requested_visibility']) {
+                            $url = $link['url'];
+                            break;
+                        }
+                    }
+                }
+                if (!$url) {
+                    $res = $this->service->postToAPI('/sharing/create_shared_link_with_settings', ['path' => $path, 'settings' => $this->options['publishPermission']])->getDecodedBody();
+                    if (isset($res['url'])) {
+                        $url = $res['url'];
+                    }
+                }
+                if ($url) {
+                    $url = str_replace('www.dropbox.com', 'dl.dropboxusercontent.com', $url);
+                    $url = str_replace('?dl=0', '', $url);
+
+                    return $url;
+                }
+            } catch (DropboxClientException $e) {
+                return $this->setError('Dropbox error: ' . $e->getMessage());
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Return debug info for client.
+     *
+     * @return array
+     **/
+    public function debug()
+    {
+        $res = parent::debug();
+        if (!empty($this->options['netkey']) && isset($this->options['tokens']) && !empty($this->options['tokens']['uid'])) {
+            $res['Dropbox uid'] = $this->options['tokens']['uid'];
+            $res['access_token'] = $this->options['tokens']['access_token'];
+        }
+
+        return $res;
+    }
+
+    /*********************** paths/urls *************************/
+
+    /**
+     * Return parent directory path.
+     *
+     * @param string $path file path
+     *
+     * @return string
+     * @author Naoki Sawada
+     **/
+    protected function _dirname($path)
+    {
+        list($dirname) = $this->_db_splitPath($path);
+
+        return $dirname;
+    }
+
+    /**
+     * Return file name.
+     *
+     * @param string $path file path
+     *
+     * @return string
+     * @author Naoki Sawada
+     **/
+    protected function _basename($path)
+    {
+        list(, $basename) = $this->_db_splitPath($path);
+
+        return $basename;
+    }
+
+    /**
+     * 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, '/') . '/' . strtolower($name);
+    }
+
+    /**
+     * Return normalized path, this works the same as os.path.normpath() in Python.
+     *
+     * @param string $path path
+     *
+     * @return string
+     * @author Naoki Sawada
+     **/
+    protected function _normpath($path)
+    {
+        return '/' . ltrim($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 {
+            return ltrim(substr($path, strlen($this->root)), '/');
+        }
+    }
+
+    /**
+     * Convert path related to root dir into real path.
+     *
+     * @param string $path file path
+     *
+     * @return string
+     * @author Naoki Sawada
+     **/
+    protected function _abspath($path)
+    {
+        if ($path === '/') {
+            return $this->root;
+        } else {
+            return $this->_joinPath($this->root, $path);
+        }
+    }
+
+    /**
+     * Return fake path started from root dir.
+     *
+     * @param string $path file path
+     *
+     * @return string
+     * @author Naoki Sawada
+     **/
+    protected function _path($path)
+    {
+        $path = $this->_normpath(substr($path, strlen($this->root)));
+
+        return $path;
+    }
+
+    /**
+     * Return true if $path is children of $parent.
+     *
+     * @param string $path   path to check
+     * @param string $parent parent path
+     *
+     * @return bool
+     * @author Naoki Sawada
+     **/
+    protected function _inpath($path, $parent)
+    {
+        return $path == $parent || strpos($path, $parent . '/') === 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)
+    {
+        if ($raw = $this->_db_getFile($path)) {
+            return $this->_db_parseRaw($raw);
+        }
+
+        return false;
+    }
+
+    /**
+     * Return true if path is dir and has at least one childs directory.
+     *
+     * @param string $path dir path
+     *
+     * @return bool
+     * @author Naoki Sawada
+     **/
+    protected function _subdirs($path)
+    {
+        $hasdir = false;
+
+        try {
+            $res = $this->service->listFolder($path);
+            if ($res) {
+                $items = $res->getItems();
+                foreach ($items as $raw) {
+                    if ($raw instanceof FolderMetadata) {
+                        $hasdir = true;
+                        break;
+                    }
+                }
+            }
+        } catch (DropboxClientException $e) {
+            $this->setError('Dropbox error: ' . $e->getMessage());
+        }
+
+        return $hasdir;
+    }
+
+    /**
+     * 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
+     * @throws ImagickException
+     * @throws elFinderAbortException
+     * @author Naoki Sawada
+     */
+    protected function _dimensions($path, $mime)
+    {
+        if (strpos($mime, 'image') !== 0) {
+            return '';
+        }
+        $ret = '';
+
+        if ($data = $this->_getContents($path)) {
+            $tmp = $this->getTempFile();
+            file_put_contents($tmp, $data);
+            $size = getimagesize($tmp);
+            if ($size) {
+                $ret = array('dim' => $size[0] . 'x' . $size[1]);
+                $srcfp = fopen($tmp, 'rb');
+                $target = isset(elFinder::$currentArgs['target'])? elFinder::$currentArgs['target'] : '';
+                if ($subImgLink = $this->getSubstituteImgLink($target, $size, $srcfp)) {
+                    $ret['url'] = $subImgLink;
+                }
+            }
+        }
+
+        return $ret;
+    }
+
+    /******************** file/dir content *********************/
+
+    /**
+     * Return files list in directory.
+     *
+     * @param string $path dir path
+     *
+     * @return array
+     * @author Naoki Sawada
+     **/
+    protected function _scandir($path)
+    {
+        return isset($this->dirsCache[$path])
+            ? $this->dirsCache[$path]
+            : $this->cacheDir($path);
+    }
+
+    /**
+     * Open file and return file pointer.
+     *
+     * @param string $path  file path
+     * @param bool   $write open file for writing
+     *
+     * @return resource|false
+     * @author Naoki Sawada
+     **/
+    protected function _fopen($path, $mode = 'rb')
+    {
+        if ($mode === 'rb' || $mode === 'r') {
+            if ($link = $this->service->getTemporaryLink($path)) {
+                $access_token = $this->service->getAccessToken();
+                if ($access_token) {
+                    $data = array(
+                        'target' => $link->getLink(),
+                        'headers' => array('Authorization: Bearer ' . $access_token),
+                    );
+
+                    // to support range request
+                    if (func_num_args() > 2) {
+                        $opts = func_get_arg(2);
+                    } else {
+                        $opts = array();
+                    }
+                    if (!empty($opts['httpheaders'])) {
+                        $data['headers'] = array_merge($opts['httpheaders'], $data['headers']);
+                    }
+
+                    return elFinder::getStreamByUrl($data);
+                }
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Close opened file.
+     *
+     * @param resource $fp file pointer
+     *
+     * @return bool
+     * @author Naoki Sawada
+     **/
+    protected function _fclose($fp, $path = '')
+    {
+        is_resource($fp) && fclose($fp);
+    }
+
+    /********************  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 Naoki Sawada
+     **/
+    protected function _mkdir($path, $name)
+    {
+        try {
+            return $this->service->createFolder($this->_db_joinName($path, $name))->getPathLower();
+        } catch (DropboxClientException $e) {
+            return $this->setError('Dropbox error: ' . $e->getMessage());
+        }
+    }
+
+    /**
+     * 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 Naoki Sawada
+     **/
+    protected function _mkfile($path, $name)
+    {
+        return $this->_save($this->tmpfile(), $path, $name, []);
+    }
+
+    /**
+     * Create symlink. FTP driver does not support symlinks.
+     *
+     * @param string $target link target
+     * @param string $path   symlink path
+     *
+     * @return bool
+     * @author Naoki Sawada
+     **/
+    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 Naoki Sawada
+     **/
+    protected function _copy($source, $targetDir, $name)
+    {
+        try {
+            $this->service->copy($source, $this->_db_joinName($targetDir, $name))->getPathLower();
+        } catch (DropboxClientException $e) {
+            return $this->setError('Dropbox error: ' . $e->getMessage());
+        }
+
+        return true;
+    }
+
+    /**
+     * Move file into another parent dir.
+     * Return new file path or false.
+     *
+     * @param string $source source file path
+     * @param string $target target dir path
+     * @param string $name   file name
+     *
+     * @return string|bool
+     * @author Naoki Sawada
+     **/
+    protected function _move($source, $targetDir, $name)
+    {
+        try {
+            return $this->service->move($source, $this->_db_joinName($targetDir, $name))->getPathLower();
+        } catch (DropboxClientException $e) {
+            return $this->setError('Dropbox error: ' . $e->getMessage());
+        }
+    }
+
+    /**
+     * Remove file.
+     *
+     * @param string $path file path
+     *
+     * @return bool
+     * @author Naoki Sawada
+     **/
+    protected function _unlink($path)
+    {
+        try {
+            $this->service->delete($path);
+
+            return true;
+        } catch (DropboxClientException $e) {
+            return $this->setError('Dropbox error: ' . $e->getMessage());
+        }
+
+        return true;
+    }
+
+    /**
+     * Remove dir.
+     *
+     * @param string $path dir path
+     *
+     * @return bool
+     * @author Naoki Sawada
+     **/
+    protected function _rmdir($path)
+    {
+        return $this->_unlink($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 Naoki Sawada
+     **/
+    protected function _save($fp, $path, $name, $stat)
+    {
+        try {
+            $info = stream_get_meta_data($fp);
+            if (empty($info['uri']) || preg_match('#^[a-z0-9.-]+://#', $info['uri'])) {
+                if ($filepath = $this->getTempFile()) {
+                    $_fp = fopen($filepath, 'wb');
+                    stream_copy_to_stream($fp, $_fp);
+                    fclose($_fp);
+                }
+            } else {
+                $filepath = $info['uri'];
+            }
+            $dropboxFile = new DropboxFile($filepath);
+            if ($name === '') {
+                $fullpath = $path;
+            } else {
+                $fullpath = $this->_db_joinName($path, $name);
+            }
+
+            return $this->service->upload($dropboxFile, $fullpath, ['mode' => 'overwrite'])->getPathLower();
+        } catch (DropboxClientException $e) {
+            return $this->setError('Dropbox error: ' . $e->getMessage());
+        }
+    }
+
+    /**
+     * Get file contents.
+     *
+     * @param string $path file path
+     *
+     * @return string|false
+     * @author Naoki Sawada
+     **/
+    protected function _getContents($path)
+    {
+        $contents = '';
+
+        try {
+            $file = $this->service->download($path);
+            $contents = $file->getContents();
+        } catch (Exception $e) {
+            return $this->setError('Dropbox error: ' . $e->getMessage());
+        }
+
+        return $contents;
+    }
+
+    /**
+     * Write a string to a file.
+     *
+     * @param string $path    file path
+     * @param string $content new file content
+     *
+     * @return bool
+     * @author Naoki Sawada
+     **/
+    protected function _filePutContents($path, $content)
+    {
+        $res = false;
+
+        if ($local = $this->getTempFile($path)) {
+            if (file_put_contents($local, $content, LOCK_EX) !== false
+                && ($fp = fopen($local, 'rb'))) {
+                clearstatcache();
+                $name = '';
+                $stat = $this->stat($path);
+                if ($stat) {
+                    // keep real name
+                    $path = $this->_dirname($path);
+                    $name = $stat['name'];
+                }
+                $res = $this->_save($fp, $path, $name, []);
+                fclose($fp);
+            }
+            file_exists($local) && unlink($local);
+        }
+
+        return $res;
+    }
+
+    /**
+     * Detect available archivers.
+     **/
+    protected function _checkArchivers()
+    {
+        // die('Not yet implemented. (_checkArchivers)');
+        return [];
+    }
+
+    /**
+     * chmod implementation.
+     *
+     * @return bool
+     **/
+    protected function _chmod($path, $mode)
+    {
+        return false;
+    }
+
+    /**
+     * Unpack archive.
+     *
+     * @param string $path archive path
+     * @param array  $arc  archiver command and arguments (same as in $this->archivers)
+     *
+     * @return true
+     * @author Dmitry (dio) Levashov
+     * @author Alexey Sukhotin
+     **/
+    protected function _unpack($path, $arc)
+    {
+        die('Not yet implemented. (_unpack)');
+        //return false;
+    }
+
+    /**
+     * Recursive symlinks search.
+     *
+     * @param string $path file/dir path
+     *
+     * @return bool
+     * @author Dmitry (dio) Levashov
+     **/
+    protected function _findSymlinks($path)
+    {
+        die('Not yet implemented. (_findSymlinks)');
+    }
+
+    /**
+     * Extract files from archive.
+     *
+     * @param string $path archive path
+     * @param array  $arc  archiver command and arguments (same as in $this->archivers)
+     *
+     * @return true
+     * @author Dmitry (dio) Levashov,
+     * @author Alexey Sukhotin
+     **/
+    protected function _extract($path, $arc)
+    {
+        die('Not yet implemented. (_extract)');
+    }
+
+    /**
+     * 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
+     **/
+    protected function _archive($dir, $files, $name, $arc)
+    {
+        die('Not yet implemented. (_archive)');
+    }
+} // END class