1<?php 2 3elFinder::$netDrivers['dropbox'] = 'Dropbox'; 4 5/** 6 * Simple elFinder driver for FTP 7 * 8 * @author Dmitry (dio) Levashov 9 * @author Cem (discofever) 10 **/ 11class elFinderVolumeDropbox extends elFinderVolumeDriver { 12 13 /** 14 * Driver id 15 * Must be started from letter and contains [a-z0-9] 16 * Used as part of volume id 17 * 18 * @var string 19 **/ 20 protected $driverId = 'd'; 21 22 /** 23 * OAuth object 24 * 25 * @var oauth 26 **/ 27 protected $oauth = null; 28 29 /** 30 * Dropbox object 31 * 32 * @var dropbox 33 **/ 34 protected $dropbox = null; 35 36 /** 37 * Directory for meta data caches 38 * If not set driver not cache meta data 39 * 40 * @var string 41 **/ 42 protected $metaCache = ''; 43 44 /** 45 * Last API error message 46 * 47 * @var string 48 **/ 49 protected $apiError = ''; 50 51 /** 52 * Directory for tmp files 53 * If not set driver will try to use tmbDir as tmpDir 54 * 55 * @var string 56 **/ 57 protected $tmp = ''; 58 59 /** 60 * Dropbox.com uid 61 * 62 * @var string 63 **/ 64 protected $dropboxUid = ''; 65 66 /** 67 * Dropbox download host, replaces 'www.dropbox.com' of shares URL 68 * 69 * @var string 70 */ 71 private $dropbox_dlhost = 'dl.dropboxusercontent.com'; 72 73 private $dropbox_phpFound = false; 74 75 private $DB_TableName = ''; 76 77 private $tmbPrefix = ''; 78 79 /** 80 * Constructor 81 * Extend options with required fields 82 * 83 * @author Dmitry (dio) Levashov 84 * @author Cem (DiscoFever) 85 */ 86 public function __construct() { 87 88 // check with composer 89 $this->dropbox_phpFound = class_exists('Dropbox_API'); 90 91 if (! $this->dropbox_phpFound) { 92 // check with pear 93 if (include_once 'Dropbox/autoload.php') { 94 $this->dropbox_phpFound = in_array('Dropbox_autoload', spl_autoload_functions()); 95 } 96 } 97 98 $opts = array( 99 'consumerKey' => '', 100 'consumerSecret' => '', 101 'accessToken' => '', 102 'accessTokenSecret' => '', 103 'dropboxUid' => '', 104 'root' => 'dropbox', 105 'path' => '/', 106 'separator' => '/', 107 'PDO_DSN' => '', // if empty use 'sqlite:(metaCachePath|tmbPath)/elFinder_dropbox_db_(hash:dropboxUid+consumerSecret)' 108 'PDO_User' => '', 109 'PDO_Pass' => '', 110 'PDO_Options' => array(), 111 'PDO_DBName' => 'dropbox', 112 'treeDeep' => 0, 113 'tmbPath' => '', 114 'tmbURL' => '', 115 'tmpPath' => '', 116 'getTmbSize' => 'large', // small: 32x32, medium or s: 64x64, large or m: 128x128, l: 640x480, xl: 1024x768 117 'metaCachePath' => '', 118 'metaCacheTime' => '600', // 10m 119 'acceptedName' => '#^[^/\\?*:|"<>]*[^./\\?*:|"<>]$#', 120 'rootCssClass' => 'elfinder-navbar-root-dropbox' 121 ); 122 $this->options = array_merge($this->options, $opts); 123 $this->options['mimeDetect'] = 'internal'; 124 } 125 126 /** 127 * Prepare 128 * Call from elFinder::netmout() before volume->mount() 129 * 130 * @param $options 131 * @return Array 132 * @author Naoki Sawada 133 */ 134 public function netmountPrepare($options) { 135 if (empty($options['consumerKey']) && defined('ELFINDER_DROPBOX_CONSUMERKEY')) $options['consumerKey'] = ELFINDER_DROPBOX_CONSUMERKEY; 136 if (empty($options['consumerSecret']) && defined('ELFINDER_DROPBOX_CONSUMERSECRET')) $options['consumerSecret'] = ELFINDER_DROPBOX_CONSUMERSECRET; 137 138 if ($options['user'] === 'init') { 139 140 if (! $this->dropbox_phpFound || empty($options['consumerKey']) || empty($options['consumerSecret']) || !class_exists('PDO', false)) { 141 return array('exit' => true, 'body' => '{msg:errNetMountNoDriver}'); 142 } 143 144 if (defined('ELFINDER_DROPBOX_USE_CURL_PUT')) { 145 $this->oauth = new Dropbox_OAuth_Curl($options['consumerKey'], $options['consumerSecret']); 146 } else { 147 if (class_exists('OAuth', false)) { 148 $this->oauth = new Dropbox_OAuth_PHP($options['consumerKey'], $options['consumerSecret']); 149 } else { 150 if (! class_exists('HTTP_OAuth_Consumer')) { 151 // We're going to try to load in manually 152 include 'HTTP/OAuth/Consumer.php'; 153 } 154 if (class_exists('HTTP_OAuth_Consumer', false)) { 155 $this->oauth = new Dropbox_OAuth_PEAR($options['consumerKey'], $options['consumerSecret']); 156 } 157 } 158 } 159 160 if (! $this->oauth) { 161 return array('exit' => true, 'body' => '{msg:errNetMountNoDriver}'); 162 } 163 164 if ($options['pass'] === 'init') { 165 $html = ''; 166 if ($sessionToken = $this->session->get('DropboxTokens')) { 167 // token check 168 try { 169 list(, $accessToken, $accessTokenSecret) = $sessionToken; 170 $this->oauth->setToken($accessToken, $accessTokenSecret); 171 $this->dropbox = new Dropbox_API($this->oauth, $this->options['root']); 172 $this->dropbox->getAccountInfo(); 173 $script = '<script> 174 $("#'.$options['id'].'").elfinder("instance").trigger("netmount", {protocol: "dropbox", mode: "done"}); 175 </script>'; 176 $html = $script; 177 } catch (Dropbox_Exception $e) { 178 $this->session->remove('DropboxTokens'); 179 } 180 } 181 if (! $html) { 182 // get customdata 183 $cdata = ''; 184 $innerKeys = array('cmd', 'host', 'options', 'pass', 'protocol', 'user'); 185 $this->ARGS = $_SERVER['REQUEST_METHOD'] === 'POST'? $_POST : $_GET; 186 foreach($this->ARGS as $k => $v) { 187 if (! in_array($k, $innerKeys)) { 188 $cdata .= '&' . $k . '=' . rawurlencode($v); 189 } 190 } 191 if (strpos($options['url'], 'http') !== 0 ) { 192 $options['url'] = elFinder::getConnectorUrl(); 193 } 194 $callback = $options['url'] 195 . '?cmd=netmount&protocol=dropbox&host=dropbox.com&user=init&pass=return&node='.$options['id'].$cdata; 196 197 try { 198 $tokens = $this->oauth->getRequestToken(); 199 $url= $this->oauth->getAuthorizeUrl(rawurlencode($callback)); 200 } catch (Dropbox_Exception $e) { 201 return array('exit' => true, 'body' => '{msg:errAccess}'); 202 } 203 204 $this->session->set('DropboxAuthTokens', $tokens); 205 $html = '<input id="elf-volumedriver-dropbox-host-btn" class="ui-button ui-widget ui-state-default ui-corner-all ui-button-text-only" value="{msg:btnApprove}" type="button" onclick="window.open(\''.$url.'\')">'; 206 $html .= '<script> 207 $("#'.$options['id'].'").elfinder("instance").trigger("netmount", {protocol: "dropbox", mode: "makebtn"}); 208 </script>'; 209 } 210 return array('exit' => true, 'body' => $html); 211 } else { 212 $this->oauth->setToken($this->session->get('DropboxAuthTokens')); 213 $this->session->remove('DropboxAuthTokens'); 214 $tokens = $this->oauth->getAccessToken(); 215 $this->session->set('DropboxTokens', array($_GET['uid'], $tokens['token'], $tokens['token_secret'])); 216 217 $out = array( 218 'node' => $_GET['node'], 219 'json' => '{"protocol": "dropbox", "mode": "done"}', 220 'bind' => 'netmount' 221 ); 222 223 return array('exit' => 'callback', 'out' => $out); 224 } 225 } 226 if ($sessionToken = $this->session->get('DropboxTokens')) { 227 list($options['dropboxUid'], $options['accessToken'], $options['accessTokenSecret']) = $sessionToken; 228 } 229 unset($options['user'], $options['pass']); 230 return $options; 231 } 232 233 /** 234 * process of on netunmount 235 * Drop table `dropbox` & rm thumbs 236 * 237 * @param $netVolumes 238 * @param $key 239 * @return bool 240 * @internal param array $options 241 */ 242 public function netunmount($netVolumes, $key) { 243 $count = 0; 244 $dropboxUid = ''; 245 if (isset($netVolumes[$key])) { 246 $dropboxUid = $netVolumes[$key]['dropboxUid']; 247 } 248 foreach($netVolumes as $volume) { 249 if ($volume['host'] === 'dropbox' && $volume['dropboxUid'] === $dropboxUid) { 250 $count++; 251 } 252 } 253 if ($count === 1) { 254 $this->DB->exec('drop table '.$this->DB_TableName); 255 foreach(glob(rtrim($this->options['tmbPath'], '\\/').DIRECTORY_SEPARATOR.$this->tmbPrefix.'*.png') as $tmb) { 256 unlink($tmb); 257 } 258 } 259 return true; 260 } 261 262 /*********************************************************************/ 263 /* INIT AND CONFIGURE */ 264 /*********************************************************************/ 265 266 /** 267 * Prepare FTP connection 268 * Connect to remote server and check if credentials are correct, if so, store the connection id in $ftp_conn 269 * 270 * @return bool 271 * @author Dmitry (dio) Levashov 272 * @author Cem (DiscoFever) 273 **/ 274 protected function init() { 275 if (!class_exists('PDO', false)) { 276 return $this->setError('PHP PDO class is require.'); 277 } 278 279 if (!$this->options['consumerKey'] 280 || !$this->options['consumerSecret'] 281 || !$this->options['accessToken'] 282 || !$this->options['accessTokenSecret']) { 283 return $this->setError('Required options undefined.'); 284 } 285 286 if (empty($this->options['metaCachePath']) && defined('ELFINDER_DROPBOX_META_CACHE_PATH')) { 287 $this->options['metaCachePath'] = ELFINDER_DROPBOX_META_CACHE_PATH; 288 } 289 290 // make net mount key 291 $this->netMountKey = md5(join('-', array('dropbox', $this->options['path']))); 292 293 if (! $this->oauth) { 294 if (defined('ELFINDER_DROPBOX_USE_CURL_PUT')) { 295 $this->oauth = new Dropbox_OAuth_Curl($this->options['consumerKey'], $this->options['consumerSecret']); 296 } else { 297 if (class_exists('OAuth', false)) { 298 $this->oauth = new Dropbox_OAuth_PHP($this->options['consumerKey'], $this->options['consumerSecret']); 299 } else { 300 if (! class_exists('HTTP_OAuth_Consumer')) { 301 // We're going to try to load in manually 302 include 'HTTP/OAuth/Consumer.php'; 303 } 304 if (class_exists('HTTP_OAuth_Consumer', false)) { 305 $this->oauth = new Dropbox_OAuth_PEAR($this->options['consumerKey'], $this->options['consumerSecret']); 306 } 307 } 308 } 309 } 310 311 if (! $this->oauth) { 312 return $this->setError('OAuth extension not loaded.'); 313 } 314 315 // normalize root path 316 $this->root = $this->options['path'] = $this->_normpath($this->options['path']); 317 318 if (empty($this->options['alias'])) { 319 $this->options['alias'] = ($this->options['path'] === '/')? 'Dropbox.com' : 'Dropbox'.$this->options['path']; 320 } 321 322 $this->rootName = $this->options['alias']; 323 324 try { 325 $this->oauth->setToken($this->options['accessToken'], $this->options['accessTokenSecret']); 326 $this->dropbox = new Dropbox_API($this->oauth, $this->options['root']); 327 } catch (Dropbox_Exception $e) { 328 $this->session->remove('DropboxTokens'); 329 return $this->setError('Dropbox error: '.$e->getMessage()); 330 } 331 332 // user 333 if (empty($this->options['dropboxUid'])) { 334 try { 335 $res = $this->dropbox->getAccountInfo(); 336 $this->options['dropboxUid'] = $res['uid']; 337 } catch (Dropbox_Exception $e) { 338 $this->session->remove('DropboxTokens'); 339 return $this->setError('Dropbox error: '.$e->getMessage()); 340 } 341 } 342 343 $this->dropboxUid = $this->options['dropboxUid']; 344 $this->tmbPrefix = 'dropbox'.base_convert($this->dropboxUid, 10, 32); 345 346 if (!empty($this->options['tmpPath'])) { 347 if ((is_dir($this->options['tmpPath']) || mkdir($this->options['tmpPath'])) && is_writable($this->options['tmpPath'])) { 348 $this->tmp = $this->options['tmpPath']; 349 } 350 } 351 if (!$this->tmp && is_writable($this->options['tmbPath'])) { 352 $this->tmp = $this->options['tmbPath']; 353 } 354 if (!$this->tmp && ($tmp = elFinder::getStaticVar('commonTempPath'))) { 355 $this->tmp = $tmp; 356 } 357 358 if (!empty($this->options['metaCachePath'])) { 359 if ((is_dir($this->options['metaCachePath']) || mkdir($this->options['metaCachePath'])) && is_writable($this->options['metaCachePath'])) { 360 $this->metaCache = $this->options['metaCachePath']; 361 } 362 } 363 if (!$this->metaCache && $this->tmp) { 364 $this->metaCache = $this->tmp; 365 } 366 367 if (!$this->metaCache) { 368 return $this->setError('Cache dirctory (metaCachePath or tmp) is require.'); 369 } 370 371 // setup PDO 372 if (! $this->options['PDO_DSN']) { 373 $this->options['PDO_DSN'] = 'sqlite:'.$this->metaCache.DIRECTORY_SEPARATOR.'.elFinder_dropbox_db_'.md5($this->dropboxUid.$this->options['consumerSecret']); 374 } 375 // DataBase table name 376 $this->DB_TableName = $this->options['PDO_DBName']; 377 // DataBase check or make table 378 try { 379 $this->DB = new PDO($this->options['PDO_DSN'], $this->options['PDO_User'], $this->options['PDO_Pass'], $this->options['PDO_Options']); 380 if (! $this->checkDB()) { 381 return $this->setError('Can not make DB table'); 382 } 383 } catch (PDOException $e) { 384 return $this->setError('PDO connection failed: '.$e->getMessage()); 385 } 386 387 $res = $this->deltaCheck($this->isMyReload()); 388 if ($res !== true) { 389 if (is_string($res)) { 390 return $this->setError($res); 391 } else { 392 return $this->setError('Could not check API "delta"'); 393 } 394 } 395 396 if (is_null($this->options['syncChkAsTs'])) { 397 $this->options['syncChkAsTs'] = true; 398 } 399 if ($this->options['syncChkAsTs']) { 400 // 'tsPlSleep' minmum 5 sec 401 $this->options['tsPlSleep'] = max(5, $this->options['tsPlSleep']); 402 } else { 403 // 'lsPlSleep' minmum 10 sec 404 $this->options['lsPlSleep'] = max(10, $this->options['lsPlSleep']); 405 } 406 407 return true; 408 } 409 410 411 /** 412 * Configure after successful mount. 413 * 414 * @return string 415 * @author Dmitry (dio) Levashov 416 **/ 417 protected function configure() { 418 parent::configure(); 419 420 $this->disabled[] = 'archive'; 421 $this->disabled[] = 'extract'; 422 } 423 424 /** 425 * Check DB for delta cache 426 * 427 * @return bool 428 */ 429 private function checkDB() { 430 $res = $this->query('SELECT * FROM sqlite_master WHERE type=\'table\' AND name=\''.$this->DB_TableName.'\''); 431 if ($res && isset($_REQUEST['init'])) { 432 // check is index(nameidx) UNIQUE? 433 $chk = $this->query('SELECT sql FROM sqlite_master WHERE type=\'index\' and name=\'nameidx\''); 434 if (!$chk || strpos(strtoupper($chk[0]), 'UNIQUE') === false) { 435 // remake 436 $this->DB->exec('DROP TABLE '.$this->DB_TableName); 437 $res = false; 438 } 439 } 440 if (! $res) { 441 try { 442 $this->DB->exec('CREATE TABLE '.$this->DB_TableName.'(path text, fname text, dat blob, isdir integer);'); 443 $this->DB->exec('CREATE UNIQUE INDEX nameidx ON '.$this->DB_TableName.'(path, fname)'); 444 $this->DB->exec('CREATE INDEX isdiridx ON '.$this->DB_TableName.'(isdir)'); 445 } catch (PDOException $e) { 446 return $this->setError($e->getMessage()); 447 } 448 } 449 return true; 450 } 451 452 /** 453 * DB query and fetchAll 454 * 455 * @param string $sql 456 * @return boolean|array 457 */ 458 private function query($sql) { 459 if ($sth = $this->DB->query($sql)) { 460 $res = $sth->fetchAll(PDO::FETCH_COLUMN); 461 } else { 462 $res = false; 463 } 464 return $res; 465 } 466 467 /** 468 * Get dat(dropbox metadata) from DB 469 * 470 * @param string $path 471 * @return array dropbox metadata 472 */ 473 private function getDBdat($path) { 474 if ($res = $this->query('select dat from '.$this->DB_TableName.' where path='.$this->DB->quote(strtolower($this->_dirname($path))).' and fname='.$this->DB->quote(strtolower($this->_basename($path))).' limit 1')) { 475 return unserialize($res[0]); 476 } else { 477 return array(); 478 } 479 } 480 481 /** 482 * Update DB dat(dropbox metadata) 483 * 484 * @param string $path 485 * @param array $dat 486 * @return bool|array 487 */ 488 private function updateDBdat($path, $dat) { 489 return $this->query('update '.$this->DB_TableName.' set dat='.$this->DB->quote(serialize($dat)) 490 . ', isdir=' . ($dat['is_dir']? 1 : 0) 491 . ' where path='.$this->DB->quote(strtolower($this->_dirname($path))).' and fname='.$this->DB->quote(strtolower($this->_basename($path)))); 492 } 493 /*********************************************************************/ 494 /* FS API */ 495 /*********************************************************************/ 496 497 /** 498 * Close opened connection 499 * 500 * @return void 501 * @author Dmitry (dio) Levashov 502 **/ 503 public function umount() { 504 505 } 506 507 /** 508 * Get delta data and DB update 509 * 510 * @param boolean $refresh force refresh 511 * @return true|string error message 512 */ 513 protected function deltaCheck($refresh = true) { 514 $chk = false; 515 if (! $refresh && $chk = $this->query('select dat from '.$this->DB_TableName.' where path=\'\' and fname=\'\' limit 1')) { 516 $chk = unserialize($chk[0]); 517 } 518 if ($chk && ($chk['mtime'] + $this->options['metaCacheTime']) > $_SERVER['REQUEST_TIME']) { 519 return true; 520 } 521 522 try { 523 $more = true; 524 $this->DB->beginTransaction(); 525 526 if ($res = $this->query('select dat from '.$this->DB_TableName.' where path=\'\' and fname=\'\' limit 1')) { 527 $res = unserialize($res[0]); 528 $cursor = $res['cursor']; 529 } else { 530 $cursor = ''; 531 } 532 $delete = false; 533 $reset = false; 534 $ptimes = array(); 535 $now = time(); 536 do { 537 ini_set('max_execution_time', 120); 538 $_info = $this->dropbox->delta($cursor); 539 if (! empty($_info['reset'])) { 540 $this->DB->exec('TRUNCATE table '.$this->DB_TableName); 541 $this->DB->exec('insert into '.$this->DB_TableName.' values(\'\', \'\', \''.serialize(array('cursor' => '', 'mtime' => 0)).'\', 0);'); 542 $this->DB->exec('insert into '.$this->DB_TableName.' values(\'/\', \'\', \''.serialize(array( 543 'path' => '/', 544 'is_dir' => 1, 545 'mime_type' => '', 546 'bytes' => 0 547 )).'\', 0);'); 548 $reset = true; 549 } 550 $cursor = $_info['cursor']; 551 552 foreach($_info['entries'] as $entry) { 553 $key = strtolower($entry[0]); 554 $pkey = strtolower($this->_dirname($key)); 555 556 $path = $this->DB->quote($pkey); 557 $fname = $this->DB->quote(strtolower($this->_basename($key))); 558 $where = 'where path='.$path.' and fname='.$fname; 559 560 if (empty($entry[1])) { 561 $ptimes[$pkey] = isset($ptimes[$pkey])? max(array($now, $ptimes[$pkey])) : $now; 562 $this->DB->exec('delete from '.$this->DB_TableName.' '.$where); 563 ! $delete && $delete = true; 564 continue; 565 } 566 567 $_itemTime = strtotime(isset($entry[1]['client_mtime'])? $entry[1]['client_mtime'] : $entry[1]['modified']); 568 $ptimes[$pkey] = isset($ptimes[$pkey])? max(array($_itemTime, $ptimes[$pkey])) : $_itemTime; 569 $sql = 'select path from '.$this->DB_TableName.' '.$where.' limit 1'; 570 if (! $reset && $this->query($sql)) { 571 $this->DB->exec('update '.$this->DB_TableName.' set dat='.$this->DB->quote(serialize($entry[1])).', isdir='.($entry[1]['is_dir']? 1 : 0).' ' .$where); 572 } else { 573 $this->DB->exec('insert into '.$this->DB_TableName.' values ('.$path.', '.$fname.', '.$this->DB->quote(serialize($entry[1])).', '.(int)$entry[1]['is_dir'].')'); 574 } 575 } 576 } while (! empty($_info['has_more'])); 577 578 // update time stamp of parent holder 579 foreach ($ptimes as $_p => $_t) { 580 if ($praw = $this->getDBdat($_p)) { 581 $_update = false; 582 if (isset($praw['client_mtime']) && $_t > strtotime($praw['client_mtime'])) { 583 $praw['client_mtime'] = date('r', $_t); 584 $_update = true; 585 } 586 if (isset($praw['modified']) && $_t > strtotime($praw['modified'])) { 587 $praw['modified'] = date('r', $_t); 588 $_update = true; 589 } 590 if ($_update) { 591 $pwhere = 'where path='.$this->DB->quote(strtolower($this->_dirname($_p))).' and fname='.$this->DB->quote(strtolower($this->_basename($_p))); 592 $this->DB->exec('update '.$this->DB_TableName.' set dat='.$this->DB->quote(serialize($praw)).' '.$pwhere); 593 } 594 } 595 } 596 597 $this->DB->exec('update '.$this->DB_TableName.' set dat='.$this->DB->quote(serialize(array('cursor'=>$cursor, 'mtime'=>$_SERVER['REQUEST_TIME']))).' where path=\'\' and fname=\'\''); 598 if (! $this->DB->commit()) { 599 $e = $this->DB->errorInfo(); 600 return $e[2]; 601 } 602 if ($delete) { 603 $this->DB->exec('vacuum'); 604 } 605 } catch(Dropbox_Exception $e) { 606 return $e->getMessage(); 607 } 608 return true; 609 } 610 611 /** 612 * Parse line from dropbox metadata output and return file stat (array) 613 * 614 * @param string $raw line from ftp_rawlist() output 615 * @return array 616 * @author Dmitry Levashov 617 **/ 618 protected function parseRaw($raw) { 619 $stat = array(); 620 621 $stat['rev'] = isset($raw['rev'])? $raw['rev'] : 'root'; 622 $stat['name'] = $this->_basename($raw['path']); 623 $stat['mime'] = $raw['is_dir']? 'directory' : $raw['mime_type']; 624 $stat['size'] = $stat['mime'] == 'directory' ? 0 : $raw['bytes']; 625 $stat['ts'] = isset($raw['client_mtime'])? strtotime($raw['client_mtime']) : 626 (isset($raw['modified'])? strtotime($raw['modified']) : $_SERVER['REQUEST_TIME']); 627 $stat['dirs'] = 0; 628 if ($raw['is_dir']) { 629 $stat['dirs'] = (int)(bool)$this->query('select path from '.$this->DB_TableName.' where isdir=1 and path='.$this->DB->quote(strtolower($raw['path']))); 630 } 631 632 if (!empty($raw['url'])) { 633 $stat['url'] = $raw['url']; 634 } else if (! $this->disabledGetUrl) { 635 $stat['url'] = '1'; 636 } 637 if (isset($raw['width'])) $stat['width'] = $raw['width']; 638 if (isset($raw['height'])) $stat['height'] = $raw['height']; 639 640 return $stat; 641 } 642 643 /** 644 * Cache dir contents 645 * 646 * @param string $path dir path 647 * @return string 648 * @author Dmitry Levashov 649 **/ 650 protected function cacheDir($path) { 651 $this->dirsCache[$path] = array(); 652 $hasDir = false; 653 654 $res = $this->query('select dat from '.$this->DB_TableName.' where path='.$this->DB->quote(strtolower($path))); 655 656 if ($res) { 657 foreach($res as $raw) { 658 $raw = unserialize($raw); 659 if ($stat = $this->parseRaw($raw)) { 660 $stat = $this->updateCache($raw['path'], $stat); 661 if (empty($stat['hidden']) && $path !== $raw['path']) { 662 if (! $hasDir && $stat['mime'] === 'directory') { 663 $hasDir = true; 664 } 665 $this->dirsCache[$path][] = $raw['path']; 666 } 667 } 668 } 669 } 670 671 if (isset($this->sessionCache['subdirs'])) { 672 $this->sessionCache['subdirs'][$path] = $hasDir; 673 } 674 675 return $this->dirsCache[$path]; 676 } 677 678 /** 679 * Recursive files search 680 * 681 * @param string $path dir path 682 * @param string $q search string 683 * @param array $mimes 684 * @return array 685 * @author Naoki Sawada 686 **/ 687 protected function doSearch($path, $q, $mimes) { 688 $result = array(); 689 $sth = $this->DB->prepare('select dat from '.$this->DB_TableName.' WHERE path LIKE ? AND fname LIKE ?'); 690 $sth->execute(array((($path === '/')? '' : strtolower($path)).'%', '%'.strtolower($q).'%')); 691 $res = $sth->fetchAll(PDO::FETCH_COLUMN); 692 $timeout = $this->options['searchTimeout']? $this->searchStart + $this->options['searchTimeout'] : 0; 693 694 if ($res) { 695 foreach($res as $raw) { 696 if ($timeout && $timeout < time()) { 697 $this->setError(elFinder::ERROR_SEARCH_TIMEOUT, $this->path($this->encode($path))); 698 break; 699 } 700 701 $raw = unserialize($raw); 702 if ($stat = $this->parseRaw($raw)) { 703 if (!isset($this->cache[$raw['path']])) { 704 $stat = $this->updateCache($raw['path'], $stat); 705 } 706 if (!empty($stat['hidden']) || ($mimes && $stat['mime'] === 'directory') || !$this->mimeAccepted($stat['mime'], $mimes)) { 707 continue; 708 } 709 $stat = $this->stat($raw['path']); 710 $stat['path'] = $this->path($stat['hash']); 711 $result[] = $stat; 712 } 713 } 714 } 715 return $result; 716 } 717 718 /** 719 * Copy file/recursive copy dir only in current volume. 720 * Return new file path or false. 721 * 722 * @param string $src source path 723 * @param string $dst destination dir path 724 * @param string $name new file name (optionaly) 725 * @return string|false 726 * @author Dmitry (dio) Levashov 727 * @author Naoki Sawada 728 **/ 729 protected function copy($src, $dst, $name) { 730 731 $this->clearcache(); 732 733 return $this->_copy($src, $dst, $name) 734 ? $this->_joinPath($dst, $name) 735 : $this->setError(elFinder::ERROR_COPY, $this->_path($src)); 736 } 737 738 /** 739 * Remove file/ recursive remove dir 740 * 741 * @param string $path file path 742 * @param bool $force try to remove even if file locked 743 * @param bool $recursive 744 * @return bool 745 * @author Dmitry (dio) Levashov 746 * @author Naoki Sawada 747 */ 748 protected function remove($path, $force = false, $recursive = false) { 749 $stat = $this->stat($path); 750 $stat['realpath'] = $path; 751 $this->rmTmb($stat); 752 $this->clearcache(); 753 754 if (empty($stat)) { 755 return $this->setError(elFinder::ERROR_RM, $this->_path($path), elFinder::ERROR_FILE_NOT_FOUND); 756 } 757 758 if (!$force && !empty($stat['locked'])) { 759 return $this->setError(elFinder::ERROR_LOCKED, $this->_path($path)); 760 } 761 762 if ($stat['mime'] == 'directory') { 763 if (!$recursive && !$this->_rmdir($path)) { 764 return $this->setError(elFinder::ERROR_RM, $this->_path($path)); 765 } 766 } else { 767 if (!$recursive && !$this->_unlink($path)) { 768 return $this->setError(elFinder::ERROR_RM, $this->_path($path)); 769 } 770 } 771 772 $this->removed[] = $stat; 773 return true; 774 } 775 776 /** 777 * Create thumnbnail and return it's URL on success 778 * 779 * @param string $path file path 780 * @param $stat 781 * @return false|string 782 * @internal param string $mime file mime type 783 * @author Dmitry (dio) Levashov 784 * @author Naoki Sawada 785 */ 786 protected function createTmb($path, $stat) { 787 if (!$stat || !$this->canCreateTmb($path, $stat)) { 788 return false; 789 } 790 791 $name = $this->tmbname($stat); 792 $tmb = $this->tmbPath.DIRECTORY_SEPARATOR.$name; 793 794 // copy image into tmbPath so some drivers does not store files on local fs 795 if (! $data = $this->getThumbnail($path, $this->options['getTmbSize'])) { 796 return false; 797 } 798 if (! file_put_contents($tmb, $data)) { 799 return false; 800 } 801 802 $result = false; 803 804 $tmbSize = $this->tmbSize; 805 806 if (($s = getimagesize($tmb)) == false) { 807 return false; 808 } 809 810 /* If image smaller or equal thumbnail size - just fitting to thumbnail square */ 811 if ($s[0] <= $tmbSize && $s[1] <= $tmbSize) { 812 $result = $this->imgSquareFit($tmb, $tmbSize, $tmbSize, 'center', 'middle', $this->options['tmbBgColor'], 'png' ); 813 814 } else { 815 816 if ($this->options['tmbCrop']) { 817 818 /* Resize and crop if image bigger than thumbnail */ 819 if (!(($s[0] > $tmbSize && $s[1] <= $tmbSize) || ($s[0] <= $tmbSize && $s[1] > $tmbSize) ) || ($s[0] > $tmbSize && $s[1] > $tmbSize)) { 820 $result = $this->imgResize($tmb, $tmbSize, $tmbSize, true, false, 'png'); 821 } 822 823 if (($s = getimagesize($tmb)) != false) { 824 $x = $s[0] > $tmbSize ? intval(($s[0] - $tmbSize)/2) : 0; 825 $y = $s[1] > $tmbSize ? intval(($s[1] - $tmbSize)/2) : 0; 826 $result = $this->imgCrop($tmb, $tmbSize, $tmbSize, $x, $y, 'png'); 827 } 828 829 } else { 830 $result = $this->imgResize($tmb, $tmbSize, $tmbSize, true, true, 'png'); 831 } 832 833 $result = $this->imgSquareFit($tmb, $tmbSize, $tmbSize, 'center', 'middle', $this->options['tmbBgColor'], 'png' ); 834 } 835 836 if (!$result) { 837 unlink($tmb); 838 return false; 839 } 840 841 return $name; 842 } 843 844 /** 845 * Return thumbnail file name for required file 846 * 847 * @param array $stat file stat 848 * @return string 849 * @author Dmitry (dio) Levashov 850 **/ 851 protected function tmbname($stat) { 852 return $this->tmbPrefix.$stat['rev'].'.png'; 853 } 854 855 /** 856 * Get thumbnail from dropbox.com 857 * @param string $path 858 * @param string $size 859 * @return string | boolean 860 */ 861 protected function getThumbnail($path, $size = 'small') { 862 try { 863 return $this->dropbox->getThumbnail($path, $size); 864 } catch (Dropbox_Exception $e) { 865 return false; 866 } 867 } 868 869 /** 870 * Return content URL 871 * 872 * @param string $hash file hash 873 * @param array $options options 874 * @return array 875 * @author Naoki Sawada 876 **/ 877 public function getContentUrl($hash, $options = array()) { 878 if (($file = $this->file($hash)) == false || !$file['url'] || $file['url'] == 1) { 879 $path = $this->decode($hash); 880 $cache = $this->getDBdat($path); 881 $url = ''; 882 if (isset($cache['share']) && strpos($cache['share'], $this->dropbox_dlhost) !== false) { 883 $res = $this->getHttpResponseHeader($cache['share']); 884 if (preg_match("/^HTTP\/[01\.]+ ([0-9]{3})/", $res, $match)) { 885 if ($match[1] < 400) { 886 $url = $cache['share']; 887 } 888 } 889 } 890 if (! $url) { 891 try { 892 $res = $this->dropbox->share($path, null, false); 893 $url = $res['url']; 894 if (strpos($url, 'www.dropbox.com') === false) { 895 $res = $this->getHttpResponseHeader($url); 896 if (preg_match('/^location:\s*(http[^\s]+)/im', $res, $match)) { 897 $url = $match[1]; 898 } 899 } 900 list($url) = explode('?', $url); 901 $url = str_replace('www.dropbox.com', $this->dropbox_dlhost, $url); 902 if (! isset($cache['share']) || $cache['share'] !== $url) { 903 $cache['share'] = $url; 904 $this->updateDBdat($path, $cache); 905 } 906 } catch (Dropbox_Exception $e) { 907 return false; 908 } 909 } 910 return $url; 911 } 912 return $file['url']; 913 } 914 915 /** 916 * Get HTTP request response header string 917 * 918 * @param string $url target URL 919 * @return string 920 * @author Naoki Sawada 921 */ 922 private function getHttpResponseHeader($url) { 923 if (function_exists('curl_exec')) { 924 925 $c = curl_init(); 926 curl_setopt( $c, CURLOPT_RETURNTRANSFER, true ); 927 curl_setopt( $c, CURLOPT_CUSTOMREQUEST, 'HEAD' ); 928 curl_setopt( $c, CURLOPT_HEADER, 1 ); 929 curl_setopt( $c, CURLOPT_NOBODY, true ); 930 curl_setopt( $c, CURLOPT_URL, $url ); 931 $res = curl_exec( $c ); 932 933 } else { 934 935 require_once 'HTTP/Request2.php'; 936 try { 937 $request2 = new HTTP_Request2(); 938 $request2->setConfig(array( 939 'ssl_verify_peer' => false, 940 'ssl_verify_host' => false 941 )); 942 $request2->setUrl($url); 943 $request2->setMethod(HTTP_Request2::METHOD_HEAD); 944 $result = $request2->send(); 945 $res = array(); 946 $res[] = 'HTTP/'.$result->getVersion().' '.$result->getStatus().' '.$result->getReasonPhrase(); 947 foreach($result->getHeader() as $key => $val) { 948 $res[] = $key . ': ' . $val; 949 } 950 $res = join("\r\n", $res); 951 } catch( HTTP_Request2_Exception $e ){ 952 $res = ''; 953 } catch (Exception $e){ 954 $res = ''; 955 } 956 957 } 958 return $res; 959 } 960 961 /*********************** paths/urls *************************/ 962 963 /** 964 * Return parent directory path 965 * 966 * @param string $path file path 967 * @return string 968 * @author Dmitry (dio) Levashov 969 **/ 970 protected function _dirname($path) { 971 return $this->_normpath(substr($path, 0, strrpos($path, '/'))); 972 } 973 974 /** 975 * Return file name 976 * 977 * @param string $path file path 978 * @return string 979 * @author Dmitry (dio) Levashov 980 **/ 981 protected function _basename($path) { 982 return substr($path, strrpos($path, '/') + 1); 983 } 984 985 /** 986 * Join dir name and file name and retur full path 987 * 988 * @param string $dir 989 * @param string $name 990 * @return string 991 * @author Dmitry (dio) Levashov 992 **/ 993 protected function _joinPath($dir, $name) { 994 return $this->_normpath($dir.'/'.$name); 995 } 996 997 /** 998 * Return normalized path, this works the same as os.path.normpath() in Python 999 * 1000 * @param string $path path 1001 * @return string 1002 * @author Troex Nevelin 1003 **/ 1004 protected function _normpath($path) { 1005 $path = '/' . ltrim($path, '/'); 1006 return $path; 1007 } 1008 1009 /** 1010 * Return file path related to root dir 1011 * 1012 * @param string $path file path 1013 * @return string 1014 * @author Dmitry (dio) Levashov 1015 **/ 1016 protected function _relpath($path) { 1017 return $path; 1018 } 1019 1020 /** 1021 * Convert path related to root dir into real path 1022 * 1023 * @param string $path file path 1024 * @return string 1025 * @author Dmitry (dio) Levashov 1026 **/ 1027 protected function _abspath($path) { 1028 return $path; 1029 } 1030 1031 /** 1032 * Return fake path started from root dir 1033 * 1034 * @param string $path file path 1035 * @return string 1036 * @author Dmitry (dio) Levashov 1037 **/ 1038 protected function _path($path) { 1039 return $this->rootName . $this->_normpath(substr($path, strlen($this->root))); 1040 } 1041 1042 /** 1043 * Return true if $path is children of $parent 1044 * 1045 * @param string $path path to check 1046 * @param string $parent parent path 1047 * @return bool 1048 * @author Dmitry (dio) Levashov 1049 **/ 1050 protected function _inpath($path, $parent) { 1051 return $path == $parent || strpos($path, $parent.'/') === 0; 1052 } 1053 1054 /***************** file stat ********************/ 1055 /** 1056 * Return stat for given path. 1057 * Stat contains following fields: 1058 * - (int) size file size in b. required 1059 * - (int) ts file modification time in unix time. required 1060 * - (string) mime mimetype. required for folders, others - optionally 1061 * - (bool) read read permissions. required 1062 * - (bool) write write permissions. required 1063 * - (bool) locked is object locked. optionally 1064 * - (bool) hidden is object hidden. optionally 1065 * - (string) alias for symlinks - link target path relative to root path. optionally 1066 * - (string) target for symlinks - link target path. optionally 1067 * 1068 * If file does not exists - returns empty array or false. 1069 * 1070 * @param string $path file path 1071 * @return array|false 1072 * @author Dmitry (dio) Levashov 1073 **/ 1074 protected function _stat($path) { 1075 //if (!empty($this->ARGS['reload']) && isset($this->ARGS['target']) && strpos($this->ARGS['target'], $this->id) === 0) { 1076 if ($this->isMyReload()) { 1077 $this->deltaCheck(); 1078 } 1079 if ($raw = $this->getDBdat($path)) { 1080 return $this->parseRaw($raw); 1081 } 1082 return false; 1083 } 1084 1085 /** 1086 * Return true if path is dir and has at least one childs directory 1087 * 1088 * @param string $path dir path 1089 * @return bool 1090 * @author Dmitry (dio) Levashov 1091 **/ 1092 protected function _subdirs($path) { 1093 return ($stat = $this->stat($path)) && isset($stat['dirs']) ? $stat['dirs'] : false; 1094 } 1095 1096 /** 1097 * Return object width and height 1098 * Ususaly used for images, but can be realize for video etc... 1099 * 1100 * @param string $path file path 1101 * @param string $mime file mime type 1102 * @return string 1103 * @author Dmitry (dio) Levashov 1104 **/ 1105 protected function _dimensions($path, $mime) { 1106 if (strpos($mime, 'image') !== 0) return ''; 1107 $cache = $this->getDBdat($path); 1108 if (isset($cache['width']) && isset($cache['height'])) { 1109 return $cache['width'].'x'.$cache['height']; 1110 } 1111 $ret = ''; 1112 if ($work = $this->getWorkFile($path)) { 1113 if ($size = getimagesize($work)) { 1114 $cache['width'] = $size[0]; 1115 $cache['height'] = $size[1]; 1116 $this->updateDBdat($path, $cache); 1117 $ret = $size[0].'x'.$size[1]; 1118 } 1119 } 1120 is_file($work) && unlink($work); 1121 return $ret; 1122 } 1123 1124 /******************** file/dir content *********************/ 1125 1126 /** 1127 * Return files list in directory. 1128 * 1129 * @param string $path dir path 1130 * @return array 1131 * @author Dmitry (dio) Levashov 1132 * @author Cem (DiscoFever) 1133 **/ 1134 protected function _scandir($path) { 1135 return isset($this->dirsCache[$path]) 1136 ? $this->dirsCache[$path] 1137 : $this->cacheDir($path); 1138 } 1139 1140 /** 1141 * Open file and return file pointer 1142 * 1143 * @param string $path file path 1144 * @param string $mode 1145 * @return false|resource 1146 * @internal param bool $write open file for writing 1147 * @author Dmitry (dio) Levashov 1148 */ 1149 protected function _fopen($path, $mode='rb') { 1150 1151 if (($mode == 'rb' || $mode == 'r')) { 1152 try { 1153 $res = $this->dropbox->media($path); 1154 $url = parse_url($res['url']); 1155 $fp = stream_socket_client('ssl://'.$url['host'].':443'); 1156 fputs($fp, "GET {$url['path']} HTTP/1.0\r\n"); 1157 fputs($fp, "Host: {$url['host']}\r\n"); 1158 fputs($fp, "\r\n"); 1159 while(trim(fgets($fp)) !== ''){}; 1160 return $fp; 1161 } catch (Dropbox_Exception $e) { 1162 return false; 1163 } 1164 } 1165 1166 if ($this->tmp) { 1167 $contents = $this->_getContents($path); 1168 1169 if ($contents === false) { 1170 return false; 1171 } 1172 1173 if ($local = $this->getTempFile($path)) { 1174 if (file_put_contents($local, $contents, LOCK_EX) !== false) { 1175 return fopen($local, $mode); 1176 } 1177 } 1178 } 1179 1180 return false; 1181 } 1182 1183 /** 1184 * Close opened file 1185 * 1186 * @param resource $fp file pointer 1187 * @param string $path 1188 * @return bool 1189 * @author Dmitry (dio) Levashov 1190 */ 1191 protected function _fclose($fp, $path='') { 1192 fclose($fp); 1193 if ($path) { 1194 unlink($this->getTempFile($path)); 1195 } 1196 } 1197 1198 /******************** file/dir manipulations *************************/ 1199 1200 /** 1201 * Create dir and return created dir path or false on failed 1202 * 1203 * @param string $path parent dir path 1204 * @param string $name new directory name 1205 * @return string|bool 1206 * @author Dmitry (dio) Levashov 1207 **/ 1208 protected function _mkdir($path, $name) { 1209 $path = $this->_normpath($path.'/'.$name); 1210 try { 1211 $this->dropbox->createFolder($path); 1212 } catch (Dropbox_Exception $e) { 1213 $this->deltaCheck(); 1214 if ($this->dir($this->encode($path))) { 1215 return $path; 1216 } 1217 return $this->setError('Dropbox error: '.$e->getMessage()); 1218 } 1219 $this->deltaCheck(); 1220 return $path; 1221 } 1222 1223 /** 1224 * Create file and return it's path or false on failed 1225 * 1226 * @param string $path parent dir path 1227 * @param string $name new file name 1228 * @return string|bool 1229 * @author Dmitry (dio) Levashov 1230 **/ 1231 protected function _mkfile($path, $name) { 1232 return $this->_filePutContents($path.'/'.$name, ''); 1233 } 1234 1235 /** 1236 * Create symlink. FTP driver does not support symlinks. 1237 * 1238 * @param string $target link target 1239 * @param string $path symlink path 1240 * @param string $name 1241 * @return bool 1242 * @author Dmitry (dio) Levashov 1243 */ 1244 protected function _symlink($target, $path, $name) { 1245 return false; 1246 } 1247 1248 /** 1249 * Copy file into another file 1250 * 1251 * @param string $source source file path 1252 * @param string $targetDir target directory path 1253 * @param string $name new file name 1254 * @return bool 1255 * @author Dmitry (dio) Levashov 1256 **/ 1257 protected function _copy($source, $targetDir, $name) { 1258 $path = $this->_normpath($targetDir.'/'.$name); 1259 try { 1260 $this->dropbox->copy($source, $path); 1261 } catch (Dropbox_Exception $e) { 1262 return $this->setError('Dropbox error: '.$e->getMessage()); 1263 } 1264 $this->deltaCheck(); 1265 return true; 1266 } 1267 1268 /** 1269 * Move file into another parent dir. 1270 * Return new file path or false. 1271 * 1272 * @param string $source source file path 1273 * @param $targetDir 1274 * @param string $name file name 1275 * @return bool|string 1276 * @internal param string $target target dir path 1277 * @author Dmitry (dio) Levashov 1278 */ 1279 protected function _move($source, $targetDir, $name) { 1280 $target = $this->_normpath($targetDir.'/'.$name); 1281 try { 1282 $this->dropbox->move($source, $target); 1283 } catch (Dropbox_Exception $e) { 1284 return $this->setError('Dropbox error: '.$e->getMessage()); 1285 } 1286 $this->deltaCheck(); 1287 return $target; 1288 } 1289 1290 /** 1291 * Remove file 1292 * 1293 * @param string $path file path 1294 * @return bool 1295 * @author Dmitry (dio) Levashov 1296 **/ 1297 protected function _unlink($path) { 1298 try { 1299 $this->dropbox->delete($path); 1300 } catch (Dropbox_Exception $e) { 1301 return $this->setError('Dropbox error: '.$e->getMessage()); 1302 } 1303 $this->deltaCheck(); 1304 return true; 1305 } 1306 1307 /** 1308 * Remove dir 1309 * 1310 * @param string $path dir path 1311 * @return bool 1312 * @author Dmitry (dio) Levashov 1313 **/ 1314 protected function _rmdir($path) { 1315 return $this->_unlink($path); 1316 } 1317 1318 /** 1319 * Create new file and write into it from file pointer. 1320 * Return new file path or false on error. 1321 * 1322 * @param resource $fp file pointer 1323 * @param string $path 1324 * @param string $name file name 1325 * @param array $stat file stat (required by some virtual fs) 1326 * @return bool|string 1327 * @internal param string $dir target dir path 1328 * @author Dmitry (dio) Levashov 1329 */ 1330 protected function _save($fp, $path, $name, $stat) { 1331 if ($name) $path .= '/'.$name; 1332 $path = $this->_normpath($path); 1333 try { 1334 $this->dropbox->putFile($path, $fp); 1335 } catch (Dropbox_Exception $e) { 1336 return $this->setError('Dropbox error: '.$e->getMessage()); 1337 } 1338 $this->deltaCheck(); 1339 if (is_array($stat)) { 1340 $raw = $this->getDBdat($path); 1341 if (isset($stat['width'])) $raw['width'] = $stat['width']; 1342 if (isset($stat['height'])) $raw['height'] = $stat['height']; 1343 $this->updateDBdat($path, $raw); 1344 } 1345 return $path; 1346 } 1347 1348 /** 1349 * Get file contents 1350 * 1351 * @param string $path file path 1352 * @return string|false 1353 * @author Dmitry (dio) Levashov 1354 **/ 1355 protected function _getContents($path) { 1356 $contents = ''; 1357 try { 1358 $contents = $this->dropbox->getFile($path); 1359 } catch (Dropbox_Exception $e) { 1360 return $this->setError('Dropbox error: '.$e->getMessage()); 1361 } 1362 return $contents; 1363 } 1364 1365 /** 1366 * Write a string to a file 1367 * 1368 * @param string $path file path 1369 * @param string $content new file content 1370 * @return bool 1371 * @author Dmitry (dio) Levashov 1372 **/ 1373 protected function _filePutContents($path, $content) { 1374 $res = false; 1375 1376 if ($local = $this->getTempFile($path)) { 1377 if (file_put_contents($local, $content, LOCK_EX) !== false 1378 && ($fp = fopen($local, 'rb'))) { 1379 clearstatcache(); 1380 $res = $this->_save($fp, $path, '', array()); 1381 fclose($fp); 1382 } 1383 file_exists($local) && unlink($local); 1384 } 1385 1386 return $res; 1387 } 1388 1389 /** 1390 * Detect available archivers 1391 * 1392 * @return array 1393 **/ 1394 protected function _checkArchivers() { 1395 // die('Not yet implemented. (_checkArchivers)'); 1396 return array(); 1397 } 1398 1399 /** 1400 * chmod implementation 1401 * 1402 * @param string $path 1403 * @param string $mode 1404 * @return bool 1405 */ 1406 protected function _chmod($path, $mode) { 1407 return false; 1408 } 1409 1410 /** 1411 * Unpack archive 1412 * 1413 * @param string $path archive path 1414 * @param array $arc archiver command and arguments (same as in $this->archivers) 1415 * @return true 1416 * @return void 1417 * @author Dmitry (dio) Levashov 1418 * @author Alexey Sukhotin 1419 **/ 1420 protected function _unpack($path, $arc) { 1421 die('Not yet implemented. (_unpack)'); 1422 } 1423 1424 /** 1425 * Recursive symlinks search 1426 * 1427 * @param string $path file/dir path 1428 * @return bool 1429 * @author Dmitry (dio) Levashov 1430 **/ 1431 protected function _findSymlinks($path) { 1432 die('Not yet implemented. (_findSymlinks)'); 1433 } 1434 1435 /** 1436 * Extract files from archive 1437 * 1438 * @param string $path archive path 1439 * @param array $arc archiver command and arguments (same as in $this->archivers) 1440 * @return true 1441 * @author Dmitry (dio) Levashov, 1442 * @author Alexey Sukhotin 1443 **/ 1444 protected function _extract($path, $arc) { 1445 die('Not yet implemented. (_extract)'); 1446 1447 } 1448 1449 /** 1450 * Create archive and return its path 1451 * 1452 * @param string $dir target dir 1453 * @param array $files files names list 1454 * @param string $name archive name 1455 * @param array $arc archiver options 1456 * @return string|bool 1457 * @author Dmitry (dio) Levashov, 1458 * @author Alexey Sukhotin 1459 **/ 1460 protected function _archive($dir, $files, $name, $arc) { 1461 die('Not yet implemented. (_archive)'); 1462 } 1463 1464} // END class 1465