name of each items. * * @var array */ protected $names = []; /** * MIME tyoe of directory. * * @var string */ const DIRMIME = 'application/vnd.google-apps.folder'; /** * Fetch fields for list. * * @var string */ const FETCHFIELDS_LIST = 'files(id,name,mimeType,modifiedTime,parents,permissions,size,imageMediaMetadata(height,width),thumbnailLink,webContentLink,webViewLink),nextPageToken'; /** * Fetch fields for get. * * @var string */ const FETCHFIELDS_GET = 'id,name,mimeType,modifiedTime,parents,permissions,size,imageMediaMetadata(height,width),thumbnailLink,webContentLink,webViewLink'; /** * 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 = ''; /** * Current token expires * * @var integer **/ private $expires; /** * Constructor * Extend options with required fields. * * @author Dmitry (dio) Levashov * @author Cem (DiscoFever) **/ public function __construct() { $opts = [ 'client_id' => '', 'client_secret' => '', 'access_token' => [], 'refresh_token' => '', 'serviceAccountConfigFile' => '', 'root' => 'My Drive', 'gdAlias' => '%s@GDrive', 'googleApiClient' => '', 'path' => '/', 'tmbPath' => '', 'separator' => '/', 'useGoogleTmb' => true, 'acceptedName' => '#.#', 'rootCssClass' => 'elfinder-navbar-root-googledrive', 'publishPermission' => [ 'type' => 'anyone', 'role' => 'reader', 'withLink' => true, ], 'appsExportMap' => [ 'application/vnd.google-apps.document' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'application/vnd.google-apps.spreadsheet' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', 'application/vnd.google-apps.drawing' => 'application/pdf', 'application/vnd.google-apps.presentation' => 'application/vnd.openxmlformats-officedocument.presentationml.presentation', 'application/vnd.google-apps.script' => 'application/vnd.google-apps.script+json', 'default' => 'application/pdf', ], ]; $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 _gd_splitPath($path) { $path = trim($path, '/'); $pid = ''; if ($path === '') { $id = 'root'; $parent = ''; } else { $path = str_replace('\\/', chr(0), $path); $paths = explode('/', $path); $id = array_pop($paths); $id = str_replace(chr(0), '/', $id); if ($paths) { $parent = '/' . implode('/', $paths); $pid = array_pop($paths); } else { $rootid = ($this->root === '/') ? 'root' : trim($this->root, '/'); if ($id === $rootid) { $parent = ''; } else { $parent = $this->root; $pid = $rootid; } } } return array($pid, $id, $parent); } /** * Drive query and fetchAll. * * @param string $sql * * @return bool|array */ private function _gd_query($opts) { $result = []; $pageToken = null; $parameters = [ 'fields' => self::FETCHFIELDS_LIST, 'pageSize' => 1000, 'spaces' => 'drive', ]; if (is_array($opts)) { $parameters = array_merge($parameters, $opts); } do { try { if ($pageToken) { $parameters['pageToken'] = $pageToken; } $files = $this->service->files->listFiles($parameters); $result = array_merge($result, $files->getFiles()); $pageToken = $files->getNextPageToken(); } catch (Exception $e) { $pageToken = null; } } while ($pageToken); return $result; } /** * Get dat(googledrive metadata) from GoogleDrive. * * @param string $path * * @return array googledrive metadata */ private function _gd_getFile($path, $fields = '') { list(, $itemId) = $this->_gd_splitPath($path); if (!$fields) { $fields = self::FETCHFIELDS_GET; } try { $file = $this->service->files->get($itemId, ['fields' => $fields]); if ($file instanceof Google_Service_Drive_DriveFile) { return $file; } else { return []; } } catch (Exception $e) { return []; } } /** * Parse line from googledrive metadata output and return file stat (array). * * @param array $raw line from ftp_rawlist() output * * @return array * @author Dmitry Levashov **/ protected function _gd_parseRaw($raw) { $stat = []; $stat['iid'] = isset($raw['id']) ? $raw['id'] : 'root'; $stat['name'] = isset($raw['name']) ? $raw['name'] : ''; if (isset($raw['modifiedTime'])) { $stat['ts'] = strtotime($raw['modifiedTime']); } if ($raw['mimeType'] === self::DIRMIME) { $stat['mime'] = 'directory'; $stat['size'] = 0; } else { $stat['mime'] = $raw['mimeType'] == 'image/bmp' ? 'image/x-ms-bmp' : $raw['mimeType']; $stat['size'] = (int)$raw['size']; if ($size = $raw->getImageMediaMetadata()) { $stat['width'] = $size['width']; $stat['height'] = $size['height']; } $published = $this->_gd_isPublished($raw); if ($this->options['useGoogleTmb']) { if (isset($raw['thumbnailLink'])) { if ($published) { $stat['tmb'] = 'drive.google.com/thumbnail?authuser=0&sz=s' . $this->options['tmbSize'] . '&id=' . $raw['id']; } else { $stat['tmb'] = substr($raw['thumbnailLink'], 8); // remove "https://" } } else { $stat['tmb'] = ''; } } if ($published) { $stat['url'] = $this->_gd_getLink($raw); } elseif (!$this->disabledGetUrl) { $stat['url'] = '1'; } } return $stat; } /** * Get dat(googledrive metadata) from GoogleDrive. * * @param string $path * * @return array googledrive metadata */ private function _gd_getNameByPath($path) { list(, $itemId) = $this->_gd_splitPath($path); if (!$this->names) { $this->_gd_getDirectoryData(); } return isset($this->names[$itemId]) ? $this->names[$itemId] : ''; } /** * Make cache of $parents, $names and $directories. * * @param bool $usecache */ protected function _gd_getDirectoryData($usecache = true) { if ($usecache) { $cache = $this->session->get($this->id . $this->netMountKey, []); if ($cache) { $this->parents = $cache['parents']; $this->names = $cache['names']; $this->directories = $cache['directories']; return; } } $root = ''; if ($this->root === '/') { // get root id if ($res = $this->_gd_getFile('/', 'id')) { $root = $res->getId(); } } $data = []; $opts = [ 'fields' => 'files(id, name, parents)', 'q' => sprintf('trashed=false and mimeType="%s"', self::DIRMIME), ]; $res = $this->_gd_query($opts); foreach ($res as $raw) { if ($parents = $raw->getParents()) { $id = $raw->getId(); $this->parents[$id] = $parents; $this->names[$id] = $raw->getName(); foreach ($parents as $p) { if (isset($data[$p])) { $data[$p][] = $id; } else { $data[$p] = [$id]; } } } } if ($root && isset($data[$root])) { $data['root'] = $data[$root]; } $this->directories = $data; $this->session->set($this->id . $this->netMountKey, [ 'parents' => $this->parents, 'names' => $this->names, 'directories' => $this->directories, ]); } /** * Get descendants directories. * * @param string $itemId * * @return array */ protected function _gd_getDirectories($itemId) { $ret = []; if ($this->directories === null) { $this->_gd_getDirectoryData(); } $data = $this->directories; if (isset($data[$itemId])) { $ret = $data[$itemId]; foreach ($data[$itemId] as $cid) { $ret = array_merge($ret, $this->_gd_getDirectories($cid)); } } return $ret; } /** * Get ID based path from item ID. * * @param string $id * * @return array */ protected function _gd_getMountPaths($id) { $root = false; if ($this->directories === null) { $this->_gd_getDirectoryData(); } list($pid) = explode('/', $id, 2); $path = $id; if ('/' . $pid === $this->root) { $root = true; } elseif (!isset($this->parents[$pid])) { $root = true; $path = ltrim(substr($path, strlen($pid)), '/'); } $res = []; if ($root) { if ($this->root === '/' || strpos('/' . $path, $this->root) === 0) { $res = [(strpos($path, '/') === false) ? '/' : ('/' . $path)]; } } else { foreach ($this->parents[$pid] as $p) { $_p = $p . '/' . $path; $res = array_merge($res, $this->_gd_getMountPaths($_p)); } } return $res; } /** * Return is published. * * @param object $file * * @return bool */ protected function _gd_isPublished($file) { $res = false; $pType = $this->options['publishPermission']['type']; $pRole = $this->options['publishPermission']['role']; if ($permissions = $file->getPermissions()) { foreach ($permissions as $permission) { if ($permission->type === $pType && $permission->role === $pRole) { $res = true; break; } } } return $res; } /** * return item URL link. * * @param object $file * * @return string */ protected function _gd_getLink($file) { if (strpos($file->mimeType, 'application/vnd.google-apps.') !== 0) { if ($url = $file->getWebContentLink()) { return str_replace('export=download', 'export=media', $url); } } if ($url = $file->getWebViewLink()) { return $url; } return ''; } /** * Get download url. * * @param Google_Service_Drive_DriveFile $file * * @return string|false */ protected function _gd_getDownloadUrl($file) { if (strpos($file->mimeType, 'application/vnd.google-apps.') !== 0) { return 'https://www.googleapis.com/drive/v3/files/' . $file->getId() . '?alt=media'; } else { $mimeMap = $this->options['appsExportMap']; if (isset($mimeMap[$file->getMimeType()])) { $mime = $mimeMap[$file->getMimeType()]; } else { $mime = $mimeMap['default']; } $mime = rawurlencode($mime); return 'https://www.googleapis.com/drive/v3/files/' . $file->getId() . '/export?mimeType=' . $mime; } return false; } /** * Get thumbnail from GoogleDrive.com. * * @param string $path * * @return string | boolean */ protected function _gd_getThumbnail($path) { list(, $itemId) = $this->_gd_splitPath($path); try { $contents = $this->service->files->get($itemId, [ 'alt' => 'media', ]); $contents = $contents->getBody()->detach(); rewind($contents); return $contents; } catch (Exception $e) { return false; } } /** * Publish permissions specified path item. * * @param string $path * * @return bool */ protected function _gd_publish($path) { if ($file = $this->_gd_getFile($path)) { if ($this->_gd_isPublished($file)) { return true; } try { if ($this->service->permissions->create($file->getId(), new \Google_Service_Drive_Permission($this->options['publishPermission']))) { return true; } } catch (Exception $e) { return false; } } return false; } /** * unPublish permissions specified path. * * @param string $path * * @return bool */ protected function _gd_unPublish($path) { if ($file = $this->_gd_getFile($path)) { if (!$this->_gd_isPublished($file)) { return true; } $permissions = $file->getPermissions(); $pType = $this->options['publishPermission']['type']; $pRole = $this->options['publishPermission']['role']; try { foreach ($permissions as $permission) { if ($permission->type === $pType && $permission->role === $pRole) { $this->service->permissions->delete($file->getId(), $permission->getId()); return true; break; } } } catch (Exception $e) { return false; } } return false; } /** * Read file chunk. * * @param resource $handle * @param int $chunkSize * * @return string */ protected function _gd_readFileChunk($handle, $chunkSize) { $byteCount = 0; $giantChunk = ''; while (!feof($handle)) { // fread will never return more than 8192 bytes if the stream is read buffered and it does not represent a plain file $chunk = fread($handle, 8192); $byteCount += strlen($chunk); $giantChunk .= $chunk; if ($byteCount >= $chunkSize) { return $giantChunk; } } return $giantChunk; } /*********************************************************************/ /* EXTENDED FUNCTIONS */ /*********************************************************************/ /** * Prepare * Call from elFinder::netmout() before volume->mount(). * * @return array * @author Naoki Sawada * @author Raja Sharma updating for GoogleDrive **/ public function netmountPrepare($options) { if (empty($options['client_id']) && defined('ELFINDER_GOOGLEDRIVE_CLIENTID')) { $options['client_id'] = ELFINDER_GOOGLEDRIVE_CLIENTID; } if (empty($options['client_secret']) && defined('ELFINDER_GOOGLEDRIVE_CLIENTSECRET')) { $options['client_secret'] = ELFINDER_GOOGLEDRIVE_CLIENTSECRET; } if (empty($options['googleApiClient']) && defined('ELFINDER_GOOGLEDRIVE_GOOGLEAPICLIENT')) { $options['googleApiClient'] = ELFINDER_GOOGLEDRIVE_GOOGLEAPICLIENT; include_once $options['googleApiClient']; } if (!isset($options['pass'])) { $options['pass'] = ''; } try { $client = new \Google_Client(); $client->setClientId($options['client_id']); $client->setClientSecret($options['client_secret']); if ($options['pass'] === 'reauth') { $options['pass'] = ''; $this->session->set('GoogleDriveAuthParams', [])->set('GoogleDriveTokens', []); } elseif ($options['pass'] === 'googledrive') { $options['pass'] = ''; } $options = array_merge($this->session->get('GoogleDriveAuthParams', []), $options); if (!isset($options['access_token'])) { $options['access_token'] = $this->session->get('GoogleDriveTokens', []); $this->session->remove('GoogleDriveTokens'); } $aToken = $options['access_token']; $rootObj = $service = null; if ($aToken) { try { $client->setAccessToken($aToken); if ($client->isAccessTokenExpired()) { $aToken = array_merge($aToken, $client->fetchAccessTokenWithRefreshToken()); $client->setAccessToken($aToken); } $service = new \Google_Service_Drive($client); $rootObj = $service->files->get('root'); $options['access_token'] = $aToken; $this->session->set('GoogleDriveAuthParams', $options); } catch (Exception $e) { $aToken = []; $options['access_token'] = []; if ($options['user'] !== 'init') { $this->session->set('GoogleDriveAuthParams', $options); return ['exit' => true, 'error' => elFinder::ERROR_REAUTH_REQUIRE]; } } } $itpCare = isset($options['code']); $code = $itpCare? $options['code'] : (isset($_GET['code'])? $_GET['code'] : ''); if ($code || (isset($options['user']) && $options['user'] === 'init')) { if (empty($options['url'])) { $options['url'] = elFinder::getConnectorUrl(); } if (isset($options['id'])) { $callback = $options['url'] . (strpos($options['url'], '?') !== false? '&' : '?') . 'cmd=netmount&protocol=googledrive&host=' . ($options['id'] === 'elfinder'? '1' : $options['id']); $client->setRedirectUri($callback); } if (!$aToken && empty($code)) { $client->setScopes([Google_Service_Drive::DRIVE]); if (!empty($options['offline'])) { $client->setApprovalPrompt('force'); $client->setAccessType('offline'); } $url = $client->createAuthUrl(); $html = ''; $html .= ''; if (empty($options['pass']) && $options['host'] !== '1') { $options['pass'] = 'return'; $this->session->set('GoogleDriveAuthParams', $options); return ['exit' => true, 'body' => $html]; } else { $out = [ 'node' => $options['id'], 'json' => '{"protocol": "googledrive", "mode": "makebtn", "body" : "' . str_replace($html, '"', '\\"') . '", "error" : "' . elFinder::ERROR_ACCESS_DENIED . '"}', 'bind' => 'netmount', ]; return ['exit' => 'callback', 'out' => $out]; } } else { if ($code) { if (!empty($options['id'])) { $aToken = $client->fetchAccessTokenWithAuthCode($code); $options['access_token'] = $aToken; unset($options['code']); $this->session->set('GoogleDriveTokens', $aToken)->set('GoogleDriveAuthParams', $options); $out = [ 'node' => $options['id'], 'json' => '{"protocol": "googledrive", "mode": "done", "reset": 1}', 'bind' => 'netmount', ]; } else { $nodeid = ($_GET['host'] === '1')? 'elfinder' : $_GET['host']; $out = array( 'node' => $nodeid, 'json' => json_encode(array( 'protocol' => 'googledrive', 'host' => $nodeid, 'mode' => 'redirect', 'options' => array( 'id' => $nodeid, 'code'=> $code ) )), 'bind' => 'netmount' ); } if (!$itpCare) { return array('exit' => 'callback', 'out' => $out); } else { return array('exit' => true, 'body' => $out['json']); } } $path = $options['path']; if ($path === '/') { $path = 'root'; } $folders = []; foreach ($service->files->listFiles([ 'pageSize' => 1000, 'q' => sprintf('trashed = false and "%s" in parents and mimeType = "application/vnd.google-apps.folder"', $path), ]) as $f) { $folders[$f->getId()] = $f->getName(); } natcasesort($folders); if ($options['pass'] === 'folders') { return ['exit' => true, 'folders' => $folders]; } $folders = ['root' => $rootObj->getName()] + $folders; $folders = json_encode($folders); $expires = empty($aToken['refresh_token']) ? $aToken['created'] + $aToken['expires_in'] - 30 : 0; $mnt2res = empty($aToken['refresh_token']) ? '' : ', "mnt2res": 1'; $json = '{"protocol": "googledrive", "mode": "done", "folders": ' . $folders . ', "expires": ' . $expires . $mnt2res . '}'; $options['pass'] = 'return'; $html = 'Google.com'; $html .= ''; $this->session->set('GoogleDriveAuthParams', $options); return ['exit' => true, 'body' => $html]; } } } catch (Exception $e) { $this->session->remove('GoogleDriveAuthParams')->remove('GoogleDriveTokens'); 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'] === '/') { $options['path'] = 'root'; } try { $file = $service->files->get($options['path']); $options['alias'] = sprintf($this->options['gdAlias'], $file->getName()); } catch (Google_Service_Exception $e) { $err = json_decode($e->getMessage(), true); if (isset($err['error']) && $err['error']['code'] == 404) { return ['exit' => true, 'error' => [elFinder::ERROR_TRGDIR_NOT_FOUND, $options['path']]]; } else { return ['exit' => true, 'error' => $e->getMessage()]; } } catch (Exception $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 `googledrive` & rm thumbs. * * @param $netVolumes * @param $key * * @return bool */ public function netunmount($netVolumes, $key) { if (!$this->options['useGoogleTmb']) { if ($tmbs = glob(rtrim($this->options['tmbPath'], '\\/') . DIRECTORY_SEPARATOR . $this->netMountKey . '*.png')) { foreach ($tmbs as $file) { unlink($file); } } } $this->session->remove($this->id . $this->netMountKey); return true; } /** * 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) { list($parentId, $name) = $this->_gd_splitPath($path); $opts = [ 'q' => sprintf('trashed=false and "%s" in parents and name="%s"', $parentId, $name), 'fields' => self::FETCHFIELDS_LIST, ]; $srcFile = $this->_gd_query($opts); return empty($srcFile) ? false : $this->_gd_parseRaw($srcFile[0]); } /*********************************************************************/ /* 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() { $serviceAccountConfig = ''; if (empty($this->options['serviceAccountConfigFile'])) { if (empty($options['client_id'])) { if (defined('ELFINDER_GOOGLEDRIVE_CLIENTID') && ELFINDER_GOOGLEDRIVE_CLIENTID) { $this->options['client_id'] = ELFINDER_GOOGLEDRIVE_CLIENTID; } else { return $this->setError('Required option "client_id" is undefined.'); } } if (empty($options['client_secret'])) { if (defined('ELFINDER_GOOGLEDRIVE_CLIENTSECRET') && ELFINDER_GOOGLEDRIVE_CLIENTSECRET) { $this->options['client_secret'] = ELFINDER_GOOGLEDRIVE_CLIENTSECRET; } else { return $this->setError('Required option "client_secret" is undefined.'); } } if (!$this->options['access_token'] && !$this->options['refresh_token']) { return $this->setError('Required option "access_token" or "refresh_token" is undefined.'); } } else { if (!is_readable($this->options['serviceAccountConfigFile'])) { return $this->setError('Option "serviceAccountConfigFile" file is not readable.'); } $serviceAccountConfig = $this->options['serviceAccountConfigFile']; } try { if (!$serviceAccountConfig) { $aTokenFile = ''; if ($this->options['refresh_token']) { // permanent mount $aToken = $this->options['refresh_token']; $this->options['access_token'] = ''; $tmp = elFinder::getStaticVar('commonTempPath'); if (!$tmp) { $tmp = $this->getTempPath(); } if ($tmp) { $aTokenFile = $tmp . DIRECTORY_SEPARATOR . md5($this->options['client_id'] . $this->options['refresh_token']) . '.gtoken'; if (is_file($aTokenFile)) { $this->options['access_token'] = json_decode(file_get_contents($aTokenFile), true); } } } else { // make net mount key for network mount if (is_array($this->options['access_token'])) { $aToken = !empty($this->options['access_token']['refresh_token']) ? $this->options['access_token']['refresh_token'] : $this->options['access_token']['access_token']; } else { return $this->setError('Required option "access_token" is not Array or empty.'); } } } $errors = []; if ($this->needOnline && !$this->service) { if (($this->options['googleApiClient'] || defined('ELFINDER_GOOGLEDRIVE_GOOGLEAPICLIENT')) && !class_exists('Google_Client')) { include_once $this->options['googleApiClient'] ? $this->options['googleApiClient'] : ELFINDER_GOOGLEDRIVE_GOOGLEAPICLIENT; } if (!class_exists('Google_Client')) { return $this->setError('Class Google_Client not found.'); } $this->client = new \Google_Client(); $client = $this->client; if (!$serviceAccountConfig) { if ($this->options['access_token']) { $client->setAccessToken($this->options['access_token']); $access_token = $this->options['access_token']; } if ($client->isAccessTokenExpired()) { $client->setClientId($this->options['client_id']); $client->setClientSecret($this->options['client_secret']); $access_token = $client->fetchAccessTokenWithRefreshToken($this->options['refresh_token'] ?: null); $client->setAccessToken($access_token); if ($aTokenFile) { file_put_contents($aTokenFile, json_encode($access_token)); } else { $access_token['refresh_token'] = $this->options['access_token']['refresh_token']; } if (!empty($this->options['netkey'])) { elFinder::$instance->updateNetVolumeOption($this->options['netkey'], 'access_token', $access_token); } $this->options['access_token'] = $access_token; } $this->expires = empty($access_token['refresh_token']) ? $access_token['created'] + $access_token['expires_in'] - 30 : 0; } else { $client->setAuthConfigFile($serviceAccountConfig); $client->setScopes([Google_Service_Drive::DRIVE]); $aToken = $client->getClientId(); } $this->service = new \Google_Service_Drive($client); } if ($this->needOnline) { $this->netMountKey = md5($aToken . '-' . $this->options['path']); } } catch (InvalidArgumentException $e) { $errors[] = $e->getMessage(); } catch (Google_Service_Exception $e) { $errors[] = $e->getMessage(); } if ($this->needOnline && !$this->service) { $this->session->remove($this->id . $this->netMountKey); if ($aTokenFile) { if (is_file($aTokenFile)) { unlink($aTokenFile); } } $errors[] = 'Google Drive Service could not be loaded.'; return $this->setError($errors); } // normalize root path if ($this->options['path'] == 'root') { $this->options['path'] = '/'; } $this->root = $this->options['path'] = $this->_normpath($this->options['path']); if (empty($this->options['alias'])) { if ($this->needOnline) { $this->options['root'] = ($this->options['root'] === '')? $this->_gd_getNameByPath('root') : $this->options['root']; $this->options['alias'] = ($this->options['path'] === '/') ? $this->options['root'] : sprintf($this->options['gdAlias'], $this->_gd_getNameByPath($this->options['path'])); if (!empty($this->options['netkey'])) { elFinder::$instance->updateNetVolumeOption($this->options['netkey'], 'alias', $this->options['alias']); } } else { $this->options['root'] = ($this->options['root'] === '')? 'GoogleDrive' : $this->options['root']; $this->options['alias'] = $this->options['root']; } } $this->rootName = isset($this->options['alias'])? $this->options['alias'] : 'GoogleDrive'; 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']); if ($this->options['useGoogleTmb']) { $this->options['tmbURL'] = 'https://'; $this->options['tmbPath'] = ''; } // enable command archive $this->options['useRemoteArchive'] = true; return true; } /** * Configure after successfull mount. * * @author Dmitry (dio) Levashov **/ protected function configure() { parent::configure(); // fallback of $this->tmp if (!$this->tmp && $this->tmbPathWritable) { $this->tmp = $this->tmbPath; } if ($this->needOnline && $this->isMyReload()) { $this->_gd_getDirectoryData(false); } } /*********************************************************************/ /* FS API */ /*********************************************************************/ /** * Close opened connection. * * @author Dmitry (dio) Levashov **/ public function umount() { } /** * Cache dir contents. * * @param string $path dir path * * @return array * @author Dmitry Levashov */ protected function cacheDir($path) { $this->dirsCache[$path] = []; $hasDir = false; list(, $pid) = $this->_gd_splitPath($path); $opts = [ 'fields' => self::FETCHFIELDS_LIST, 'q' => sprintf('trashed=false and "%s" in parents', $pid), ]; $res = $this->_gd_query($opts); $mountPath = $this->_normpath($path . '/'); if ($res) { foreach ($res as $raw) { if ($stat = $this->_gd_parseRaw($raw)) { $stat = $this->updateCache($mountPath . $raw->id, $stat); if (empty($stat['hidden']) && $path !== $mountPath . $raw->id) { if (!$hasDir && $stat['mime'] === 'directory') { $hasDir = true; } $this->dirsCache[$path][] = $mountPath . $raw->id; } } } } 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'])) { // has custom match method use elFinderVolumeDriver::doSearch() return parent::doSearch($path, $q, $mimes); } list(, $itemId) = $this->_gd_splitPath($path); $path = $this->_normpath($path . '/'); $result = []; $query = ''; if ($itemId !== 'root') { $dirs = array_merge([$itemId], $this->_gd_getDirectories($itemId)); $query = '(\'' . implode('\' in parents or \'', $dirs) . '\' in parents)'; } $tmp = []; if (!$mimes) { foreach (explode(' ', $q) as $_v) { $tmp[] = 'fullText contains \'' . str_replace('\'', '\\\'', $_v) . '\''; } $query .= ($query ? ' and ' : '') . implode(' and ', $tmp); } else { foreach ($mimes as $_v) { $tmp[] = 'mimeType contains \'' . str_replace('\'', '\\\'', $_v) . '\''; } $query .= ($query ? ' and ' : '') . '(' . implode(' or ', $tmp) . ')'; } $opts = [ 'q' => sprintf('trashed=false and (%s)', $query), ]; $res = $this->_gd_query($opts); $timeout = $this->options['searchTimeout'] ? $this->searchStart + $this->options['searchTimeout'] : 0; foreach ($res as $raw) { if ($timeout && $timeout < time()) { $this->setError(elFinder::ERROR_SEARCH_TIMEOUT, $this->_path($path)); break; } if ($stat = $this->_gd_parseRaw($raw)) { if ($parents = $raw->getParents()) { foreach ($parents as $parent) { $paths = $this->_gd_getMountPaths($parent); foreach ($paths as $path) { $path = ($path === '') ? '/' : (rtrim($path, '/') . '/'); if (!isset($this->cache[$path . $raw->id])) { $stat = $this->updateCache($path . $raw->id, $stat); } else { $stat = $this->cache[$path . $raw->id]; } if (empty($stat['hidden'])) { $stat['path'] = $this->_path($path) . $stat['name']; $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 * @author Dmitry (dio) Levashov * @author Naoki Sawada **/ protected function copy($src, $dst, $name) { $this->clearcache(); $res = $this->_gd_getFile($src); if ($res['mimeType'] == self::DIRMIME) { $newDir = $this->_mkdir($dst, $name); if ($newDir) { list(, $itemId) = $this->_gd_splitPath($newDir); list(, $srcId) = $this->_gd_splitPath($src); $path = $this->_joinPath($dst, $itemId); $opts = [ 'q' => sprintf('trashed=false and "%s" in parents', $srcId), ]; $res = $this->_gd_query($opts); foreach ($res as $raw) { $raw['mimeType'] == self::DIRMIME ? $this->copy($src . '/' . $raw['id'], $path, $raw['name']) : $this->_copy($src . '/' . $raw['id'], $path, $raw['name']); } $ret = $this->_joinPath($dst, $itemId); $this->added[] = $this->stat($ret); } else { $ret = $this->setError(elFinder::ERROR_COPY, $this->_path($src)); } } else { if ($itemId = $this->_copy($src, $dst, $name)) { $ret = $this->_joinPath($dst, $itemId); $this->added[] = $this->stat($ret); } else { $ret = $this->setError(elFinder::ERROR_COPY, $this->_path($src)); } } return $ret; } /** * 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 Dmitry (dio) Levashov * @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 Dmitry (dio) Levashov * @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->_gd_getThumbnail($path)) { return false; } if (!file_put_contents($tmb, $data)) { return false; } $result = false; $tmbSize = $this->tmbSize; if (($s = getimagesize($tmb)) == false) { 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']) { /* 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 (($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'); } $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 Dmitry (dio) Levashov **/ protected function tmbname($stat) { return $this->netMountKey . $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; } } if (($file = $this->file($hash)) == false || !$file['url'] || $file['url'] == 1) { $path = $this->decode($hash); if ($this->_gd_publish($path)) { if ($raw = $this->_gd_getFile($path)) { return $this->_gd_getLink($raw); } } } return false; } /** * Return debug info for client. * * @return array **/ public function debug() { $res = parent::debug(); if (!empty($this->options['netkey']) && empty($this->options['refresh_token']) && $this->options['access_token'] && isset($this->options['access_token']['refresh_token'])) { $res['refresh_token'] = $this->options['access_token']['refresh_token']; } return $res; } /*********************** paths/urls *************************/ /** * Return parent directory path. * * @param string $path file path * * @return string * @author Dmitry (dio) Levashov **/ protected function _dirname($path) { list(, , $parent) = $this->_gd_splitPath($path); return $this->_normpath($parent); } /** * Return file name. * * @param string $path file path * * @return string * @author Dmitry (dio) Levashov **/ protected function _basename($path) { list(, $basename) = $this->_gd_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 $this->_normpath($dir . '/' . str_replace('/', '\\/', $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 (DIRECTORY_SEPARATOR !== '/') { $path = str_replace(DIRECTORY_SEPARATOR, '/', $path); } $path = '/' . ltrim($path, '/'); return $path; } /** * Return file path related to root dir. * * @param string $path file path * * @return string * @author Dmitry (dio) Levashov **/ protected function _relpath($path) { 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) { return $path; } /** * Return fake path started from root dir. * * @param string $path file path * * @return string * @author Dmitry (dio) Levashov **/ protected function _path($path) { if (!$this->names) { $this->_gd_getDirectoryData(); } $path = $this->_normpath(substr($path, strlen($this->root))); $names = []; $paths = explode('/', $path); foreach ($paths as $_p) { $names[] = isset($this->names[$_p]) ? $this->names[$_p] : $_p; } return $this->rootName . implode('/', $names); } /** * 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, $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->_gd_getFile($path)) { $stat = $this->_gd_parseRaw($raw); if ($path === $this->root) { $stat['expires'] = $this->expires; } return $stat; } return false; } /** * 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) { if ($this->directories === null) { $this->_gd_getDirectoryData(); } list(, $itemId) = $this->_gd_splitPath($path); return isset($this->directories[$itemId]); } /** * 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 Dmitry (dio) Levashov */ protected function _dimensions($path, $mime) { if (strpos($mime, 'image') !== 0) { return ''; } $ret = ''; if ($file = $this->_gd_getFile($path)) { if (isset($file['imageMediaMetadata'])) { $ret = array('dim' => $file['imageMediaMetadata']['width'] . 'x' . $file['imageMediaMetadata']['height']); if (func_num_args() > 2) { $args = func_get_arg(2); } else { $args = array(); } if (!empty($args['substitute'])) { $tmbSize = intval($args['substitute']); $srcSize = explode('x', $ret['dim']); if ($srcSize[0] && $srcSize[1]) { if (min(($tmbSize / $srcSize[0]), ($tmbSize / $srcSize[1])) < 1) { if ($this->_gd_isPublished($file)) { $tmbSize = strval($tmbSize); $ret['url'] = 'https://drive.google.com/thumbnail?authuser=0&sz=s' . $tmbSize . '&id=' . $file['id']; } elseif ($subImgLink = $this->getSubstituteImgLink(elFinder::$currentArgs['target'], $srcSize)) { $ret['url'] = $subImgLink; } } } } } } 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) { 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 Dmitry (dio) Levashov **/ protected function _fopen($path, $mode = 'rb') { if ($mode === 'rb' || $mode === 'r') { if ($file = $this->_gd_getFile($path)) { if ($dlurl = $this->_gd_getDownloadUrl($file)) { $token = $this->client->getAccessToken(); if (!$token && $this->client->isUsingApplicationDefaultCredentials()) { $this->client->fetchAccessTokenWithAssertion(); $token = $this->client->getAccessToken(); } $access_token = ''; if (is_array($token)) { $access_token = $token['access_token']; } else { if ($token = json_decode($this->client->getAccessToken())) { $access_token = $token->access_token; } } if ($access_token) { $data = array( 'target' => $dlurl, '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 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); list($parentId, , $parent) = $this->_gd_splitPath($path); try { $file = new \Google_Service_Drive_DriveFile(); $file->setName($name); $file->setMimeType(self::DIRMIME); $file->setParents([$parentId]); //create the Folder in the Parent $obj = $this->service->files->create($file); if ($obj instanceof Google_Service_Drive_DriveFile) { $path = $this->_joinPath($parent, $obj['id']); $this->_gd_getDirectoryData(false); return $path; } else { return false; } } catch (Exception $e) { return $this->setError('GoogleDrive 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 Dmitry (dio) Levashov **/ 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 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) { $source = $this->_normpath($source); $targetDir = $this->_normpath($targetDir); try { $file = new \Google_Service_Drive_DriveFile(); $file->setName($name); //Set the Parent id list(, $parentId) = $this->_gd_splitPath($targetDir); $file->setParents([$parentId]); list(, $srcId) = $this->_gd_splitPath($source); $file = $this->service->files->copy($srcId, $file, ['fields' => self::FETCHFIELDS_GET]); $itemId = $file->id; return $itemId; } catch (Exception $e) { return $this->setError('GoogleDrive 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 Dmitry (dio) Levashov **/ protected function _move($source, $targetDir, $name) { list($removeParents, $itemId) = $this->_gd_splitPath($source); $target = $this->_normpath($targetDir . '/' . $itemId); try { //moving and renaming a file or directory $files = new \Google_Service_Drive_DriveFile(); $files->setName($name); //Set new Parent and remove old parent list(, $addParents) = $this->_gd_splitPath($targetDir); $opts = ['addParents' => $addParents, 'removeParents' => $removeParents]; $file = $this->service->files->update($itemId, $files, $opts); if ($file->getMimeType() === self::DIRMIME) { $this->_gd_getDirectoryData(false); } } catch (Exception $e) { return $this->setError('GoogleDrive error: ' . $e->getMessage()); } return $target; } /** * Remove file. * * @param string $path file path * * @return bool * @author Dmitry (dio) Levashov **/ protected function _unlink($path) { try { $files = new \Google_Service_Drive_DriveFile(); $files->setTrashed(true); list($pid, $itemId) = $this->_gd_splitPath($path); $opts = ['removeParents' => $pid]; $this->service->files->update($itemId, $files, $opts); } catch (Exception $e) { return $this->setError('GoogleDrive error: ' . $e->getMessage()); } return true; } /** * Remove dir. * * @param string $path dir path * * @return bool * @author Dmitry (dio) Levashov **/ protected function _rmdir($path) { $res = $this->_unlink($path); $res && $this->_gd_getDirectoryData(false); return $res; } /** * Create new file and write into it from file pointer. * Return new file path or false on error. * * @param resource $fp file pointer * @param $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, $path, $name, $stat) { if ($name !== '') { $path .= '/' . str_replace('/', '\\/', $name); } list($parentId, $itemId, $parent) = $this->_gd_splitPath($path); if ($name === '') { $stat['iid'] = $itemId; } if (!$stat || empty($stat['iid'])) { $opts = [ 'q' => sprintf('trashed=false and "%s" in parents and name="%s"', $parentId, $name), 'fields' => self::FETCHFIELDS_LIST, ]; $srcFile = $this->_gd_query($opts); $srcFile = empty($srcFile) ? null : $srcFile[0]; } else { $srcFile = $this->_gd_getFile($path); } try { $mode = 'update'; $mime = isset($stat['mime']) ? $stat['mime'] : ''; $file = new Google_Service_Drive_DriveFile(); if ($srcFile) { $mime = $srcFile->getMimeType(); } else { $mode = 'insert'; $file->setName($name); $file->setParents([ $parentId, ]); } if (!$mime) { $mime = self::mimetypeInternalDetect($name); } if ($mime === 'unknown') { $mime = 'application/octet-stream'; } $file->setMimeType($mime); $size = 0; if (isset($stat['size'])) { $size = $stat['size']; } else { $fstat = fstat($fp); if (!empty($fstat['size'])) { $size = $fstat['size']; } } // set chunk size (max: 100MB) $chunkSizeBytes = 100 * 1024 * 1024; if ($size > 0) { $memory = elFinder::getIniBytes('memory_limit'); if ($memory > 0) { $chunkSizeBytes = max(262144, min([$chunkSizeBytes, (intval($memory / 4 / 256) * 256)])); } } if ($size > $chunkSizeBytes) { $client = $this->client; // Call the API with the media upload, defer so it doesn't immediately return. $client->setDefer(true); if ($mode === 'insert') { $request = $this->service->files->create($file, [ 'fields' => self::FETCHFIELDS_GET, ]); } else { $request = $this->service->files->update($srcFile->getId(), $file, [ 'fields' => self::FETCHFIELDS_GET, ]); } // Create a media file upload to represent our upload process. $media = new Google_Http_MediaFileUpload($client, $request, $mime, null, true, $chunkSizeBytes); $media->setFileSize($size); // Upload the various chunks. $status will be false until the process is // complete. $status = false; while (!$status && !feof($fp)) { elFinder::checkAborted(); // read until you get $chunkSizeBytes from TESTFILE // fread will never return more than 8192 bytes if the stream is read buffered and it does not represent a plain file // An example of a read buffered file is when reading from a URL $chunk = $this->_gd_readFileChunk($fp, $chunkSizeBytes); $status = $media->nextChunk($chunk); } // The final value of $status will be the data from the API for the object // that has been uploaded. if ($status !== false) { $obj = $status; } $client->setDefer(false); } else { $params = [ 'data' => stream_get_contents($fp), 'uploadType' => 'media', 'fields' => self::FETCHFIELDS_GET, ]; if ($mode === 'insert') { $obj = $this->service->files->create($file, $params); } else { $obj = $this->service->files->update($srcFile->getId(), $file, $params); } } if ($obj instanceof Google_Service_Drive_DriveFile) { return $this->_joinPath($parent, $obj->getId()); } else { return false; } } catch (Exception $e) { return $this->setError('GoogleDrive error: ' . $e->getMessage()); } } /** * Get file contents. * * @param string $path file path * * @return string|false * @author Dmitry (dio) Levashov **/ protected function _getContents($path) { $contents = ''; try { list(, $itemId) = $this->_gd_splitPath($path); $contents = $this->service->files->get($itemId, [ 'alt' => 'media', ]); $contents = (string)$contents->getBody(); } catch (Exception $e) { return $this->setError('GoogleDrive 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 Dmitry (dio) Levashov **/ 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(); $res = $this->_save($fp, $path, '', []); 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 void * @author Dmitry (dio) Levashov * @author Alexey Sukhotin */ protected function _unpack($path, $arc) { die('Not yet implemented. (_unpack)'); //return false; } /** * Extract files from archive. * * @param string $path archive path * @param array $arc archiver command and arguments (same as in $this->archivers) * * @return void * @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