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