- File: elFinderVolumeBox.class.php
- Full Path: /home/matthif/www/wp-content/plugins/wp-file-manager/lib/php/elFinderVolumeBox.class.php
- Date Modified: 02/06/2026 3:42 AM
- File size: 60.32 KB
- MIME-type: text/x-php
- Charset: utf-8
<?php
/**
* Simple elFinder driver for BoxDrive
* Box.com API v2.0.
*
* @author Dmitry (dio) Levashov
* @author Cem (discofever)
**/
class elFinderVolumeBox extends elFinderVolumeDriver
{
/**
* Driver id
* Must be started from letter and contains [a-z0-9]
* Used as part of volume id.
*
* @var string
**/
protected $driverId = 'bd';
/**
* @var string The base URL for API requests
*/
const API_URL = 'https://api.box.com/2.0';
/**
* @var string The base URL for authorization requests
*/
const AUTH_URL = 'https://account.box.com/api/oauth2/authorize';
/**
* @var string The base URL for token requests
*/
const TOKEN_URL = 'https://api.box.com/oauth2/token';
/**
* @var string The base URL for upload requests
*/
const UPLOAD_URL = 'https://upload.box.com/api/2.0';
/**
* Fetch fields list.
*
* @var string
*/
const FETCHFIELDS = 'type,id,name,created_at,modified_at,description,size,parent,permissions,file_version,shared_link';
/**
* Box.com token object.
*
* @var object
**/
protected $token = null;
/**
* 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 = '';
/**
* Thumbnail prefix.
*
* @var string
**/
private $tmbPrefix = '';
/**
* Path to access token file for permanent mount
*
* @var string
*/
private $aTokenFile = '';
/**
* hasCache by folders.
*
* @var array
**/
protected $HasdirsCache = array();
/**
* Constructor
* Extend options with required fields.
*
* @author Dmitry (dio) Levashov
* @author Cem (DiscoFever)
**/
public function __construct()
{
$opts = array(
'client_id' => '',
'client_secret' => '',
'accessToken' => '',
'root' => 'Box.com',
'path' => '/',
'separator' => '/',
'tmbPath' => '',
'tmbURL' => '',
'tmpPath' => '',
'acceptedName' => '#^[^\\\/]+$#',
'rootCssClass' => 'elfinder-navbar-root-box',
);
$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 _bd_splitPath($path)
{
$path = trim($path, '/');
$pid = '';
if ($path === '') {
$id = '0';
$parent = '';
} else {
$paths = explode('/', trim($path, '/'));
$id = array_pop($paths);
if ($paths) {
$parent = '/' . implode('/', $paths);
$pid = array_pop($paths);
} else {
$pid = '0';
$parent = '/';
}
}
return array($pid, $id, $parent);
}
/**
* Obtains a new access token from OAuth. This token is valid for one hour.
*
* @param string $clientSecret The Box client secret
* @param string $code The code returned by Box after
* successful log in
* @param string $redirectUri Must be the same as the redirect URI passed
* to LoginUrl
*
* @return bool|object
* @throws \Exception Thrown if this Client instance's clientId is not set
* @throws \Exception Thrown if the redirect URI of this Client instance's
* state is not set
*/
protected function _bd_obtainAccessToken($client_id, $client_secret, $code)
{
if (null === $client_id) {
return $this->setError('The client ID must be set to call obtainAccessToken()');
}
if (null === $client_secret) {
return $this->setError('The client Secret must be set to call obtainAccessToken()');
}
if (null === $code) {
return $this->setError('Authorization code must be set to call obtainAccessToken()');
}
$url = self::TOKEN_URL;
$curl = curl_init();
$fields = http_build_query(
array(
'client_id' => $client_id,
'client_secret' => $client_secret,
'code' => $code,
'grant_type' => 'authorization_code',
)
);
curl_setopt_array($curl, array(
// General options.
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $fields,
CURLOPT_URL => $url,
));
$decoded = $this->_bd_curlExec($curl, true, array('Content-Length: ' . strlen($fields)));
$res = (object)array(
'expires' => time() + $decoded->expires_in - 30,
'initialToken' => '',
'data' => $decoded
);
if (!empty($decoded->refresh_token)) {
$res->initialToken = md5($client_id . $decoded->refresh_token);
}
return $res;
}
/**
* Get token and auto refresh.
*
* @return true|string error message
* @throws Exception
*/
protected function _bd_refreshToken()
{
if (!property_exists($this->token, 'expires') || $this->token->expires < time()) {
if (!$this->options['client_id']) {
$this->options['client_id'] = ELFINDER_BOX_CLIENTID;
}
if (!$this->options['client_secret']) {
$this->options['client_secret'] = ELFINDER_BOX_CLIENTSECRET;
}
if (empty($this->token->data->refresh_token)) {
throw new \Exception(elFinder::ERROR_REAUTH_REQUIRE);
} else {
$refresh_token = $this->token->data->refresh_token;
$initialToken = $this->_bd_getInitialToken();
}
$lock = '';
$aTokenFile = $this->aTokenFile? $this->aTokenFile : $this->_bd_getATokenFile();
if ($aTokenFile && is_file($aTokenFile)) {
$lock = $aTokenFile . '.lock';
if (file_exists($lock)) {
// Probably updating on other instance
return true;
}
touch($lock);
$GLOBALS['elFinderTempFiles'][$lock] = true;
}
$postData = array(
'client_id' => $this->options['client_id'],
'client_secret' => $this->options['client_secret'],
'grant_type' => 'refresh_token',
'refresh_token' => $refresh_token
);
$url = self::TOKEN_URL;
$curl = curl_init();
curl_setopt_array($curl, array(
// General options.
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true, // i am sending post data
CURLOPT_POSTFIELDS => http_build_query($postData),
CURLOPT_URL => $url,
));
$decoded = $error = '';
try {
$decoded = $this->_bd_curlExec($curl, true, array(), $postData);
} catch (Exception $e) {
$error = $e->getMessage();
}
if (!$decoded && !$error) {
$error = 'Tried to renew the access token, but did not get a response from the Box server.';
}
if ($error) {
$lock && unlink($lock);
throw new \Exception('Box access token update failed. ('.$error.') If this message appears repeatedly, please notify the administrator.');
}
if (empty($decoded->access_token)) {
if ($aTokenFile) {
if (is_file($aTokenFile)) {
unlink($aTokenFile);
}
}
$err = property_exists($decoded, 'error')? ' ' . $decoded->error : '';
$err .= property_exists($decoded, 'error_description')? ' ' . $decoded->error_description : '';
throw new \Exception($err? $err : elFinder::ERROR_REAUTH_REQUIRE);
}
$token = (object)array(
'expires' => time() + $decoded->expires_in - 300,
'initialToken' => $initialToken,
'data' => $decoded,
);
$this->token = $token;
$json = json_encode($token);
if (!empty($decoded->refresh_token)) {
if (empty($this->options['netkey']) && $aTokenFile) {
file_put_contents($aTokenFile, json_encode($token), LOCK_EX);
$this->options['accessToken'] = $json;
} else if (!empty($this->options['netkey'])) {
// OAuth2 refresh token can be used only once,
// so update it if it is the same as the token file
if ($aTokenFile && is_file($aTokenFile)) {
if ($_token = json_decode(file_get_contents($aTokenFile))) {
if ($_token->data->refresh_token === $refresh_token) {
file_put_contents($aTokenFile, $json, LOCK_EX);
}
}
}
$this->options['accessToken'] = $json;
// update session value
elFinder::$instance->updateNetVolumeOption($this->options['netkey'], 'accessToken', $json);
$this->session->set('BoxTokens', $token);
} else {
throw new \Exception(ERROR_CREATING_TEMP_DIR);
}
}
$lock && unlink($lock);
}
return true;
}
/**
* Creates a base cURL object which is compatible with the Box.com API.
*
* @param array $options cURL options
*
* @return resource A compatible cURL object
*/
protected function _bd_prepareCurl($options = array())
{
$curl = curl_init();
$defaultOptions = array(
// General options.
CURLOPT_RETURNTRANSFER => true,
);
curl_setopt_array($curl, $options + $defaultOptions);
return $curl;
}
/**
* Creates a base cURL object which is compatible with the Box.com API.
*
* @param $url
* @param bool $contents
*
* @return boolean|array
* @throws Exception
*/
protected function _bd_fetch($url, $contents = false)
{
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
if ($contents) {
return $this->_bd_curlExec($curl, false);
} else {
$result = $this->_bd_curlExec($curl);
if (isset($result->entries)) {
$res = $result->entries;
$cnt = count($res);
$total = $result->total_count;
$offset = $result->offset;
$single = ($result->limit == 1) ? true : false;
if (!$single && $total > ($offset + $cnt)) {
$offset = $offset + $cnt;
if (strpos($url, 'offset=') === false) {
$url .= '&offset=' . $offset;
} else {
$url = preg_replace('/^(.+?offset=)\d+(.*)$/', '${1}' . $offset . '$2', $url);
}
$more = $this->_bd_fetch($url);
if (is_array($more)) {
$res = array_merge($res, $more);
}
}
return $res;
} else {
if (isset($result->type) && $result->type === 'error') {
return false;
} else {
return $result;
}
}
}
}
/**
* Call curl_exec().
*
* @param resource $curl
* @param bool|string $decodeOrParent
* @param array $headers
*
* @throws \Exception
* @return mixed
*/
protected function _bd_curlExec($curl, $decodeOrParent = true, $headers = array(), $postData = array())
{
if ($this->token) {
$headers = array_merge(array(
'Authorization: Bearer ' . $this->token->data->access_token,
), $headers);
}
$result = elFinder::curlExec($curl, array(), $headers, $postData);
if (!$decodeOrParent) {
return $result;
}
$decoded = json_decode($result);
if ($error = !empty($decoded->error_code)) {
$errmsg = $decoded->error_code;
if (!empty($decoded->message)) {
$errmsg .= ': ' . $decoded->message;
}
throw new \Exception($errmsg);
} else if ($error = !empty($decoded->error)) {
$errmsg = $decoded->error;
if (!empty($decoded->error_description)) {
$errmsg .= ': ' . $decoded->error_description;
}
throw new \Exception($errmsg);
}
// make catch
if ($decodeOrParent && $decodeOrParent !== true) {
$raws = null;
if (isset($decoded->entries)) {
$raws = $decoded->entries;
} elseif (isset($decoded->id)) {
$raws = array($decoded);
}
if ($raws) {
foreach ($raws as $raw) {
if (isset($raw->id)) {
$stat = $this->_bd_parseRaw($raw);
$itemPath = $this->_joinPath($decodeOrParent, $raw->id);
$this->updateCache($itemPath, $stat);
}
}
}
}
return $decoded;
}
/**
* Drive query and fetchAll.
*
* @param $itemId
* @param bool $fetch_self
* @param bool $recursive
*
* @return bool|object
* @throws Exception
*/
protected function _bd_query($itemId, $fetch_self = false, $recursive = false)
{
$result = [];
if (null === $itemId) {
$itemId = '0';
}
if ($fetch_self) {
$path = '/folders/' . $itemId . '?fields=' . self::FETCHFIELDS;
} else {
$path = '/folders/' . $itemId . '/items?limit=1000&fields=' . self::FETCHFIELDS;
}
$url = self::API_URL . $path;
if ($recursive) {
foreach ($this->_bd_fetch($url) as $file) {
if ($file->type == 'folder') {
$result[] = $file;
$result = array_merge($result, $this->_bd_query($file->id, $fetch_self = false, $recursive = true));
} elseif ($file->type == 'file') {
$result[] = $file;
}
}
} else {
$result = $this->_bd_fetch($url);
if ($fetch_self && !$result) {
$path = '/files/' . $itemId . '?fields=' . self::FETCHFIELDS;
$url = self::API_URL . $path;
$result = $this->_bd_fetch($url);
}
}
return $result;
}
/**
* Get dat(box metadata) from Box.com.
*
* @param string $path
*
* @return object box metadata
* @throws Exception
*/
protected function _bd_getRawItem($path)
{
if ($path == '/') {
return $this->_bd_query('0', $fetch_self = true);
}
list(, $itemId) = $this->_bd_splitPath($path);
try {
return $this->_bd_query($itemId, $fetch_self = true);
} catch (Exception $e) {
$empty = new stdClass;
return $empty;
}
}
/**
* Parse line from box metadata output and return file stat (array).
*
* @param object $raw line from ftp_rawlist() output
*
* @return array
* @author Dmitry Levashov
**/
protected function _bd_parseRaw($raw)
{
$stat = array();
$stat['rev'] = isset($raw->id) ? $raw->id : 'root';
$stat['name'] = $raw->name;
if (!empty($raw->modified_at)) {
$stat['ts'] = strtotime($raw->modified_at);
}
if ($raw->type === 'folder') {
$stat['mime'] = 'directory';
$stat['size'] = 0;
$stat['dirs'] = -1;
} else {
$stat['size'] = (int)$raw->size;
if (!empty($raw->shared_link->url) && $raw->shared_link->access == 'open') {
if ($url = $this->getSharedWebContentLink($raw)) {
$stat['url'] = $url;
}
} elseif (!$this->disabledGetUrl) {
$stat['url'] = '1';
}
}
return $stat;
}
/**
* Get thumbnail from Box.com.
*
* @param string $path
* @param string $size
*
* @return string | boolean
*/
protected function _bd_getThumbnail($path)
{
list(, $itemId) = $this->_bd_splitPath($path);
try {
$url = self::API_URL . '/files/' . $itemId . '/thumbnail.png?min_height=' . $this->tmbSize . '&min_width=' . $this->tmbSize;
$contents = $this->_bd_fetch($url, true);
return $contents;
} catch (Exception $e) {
return false;
}
}
/**
* Remove item.
*
* @param string $path file path
*
* @return bool
**/
protected function _bd_unlink($path, $type = null)
{
try {
list(, $itemId) = $this->_bd_splitPath($path);
if ($type == 'folders') {
$url = self::API_URL . '/' . $type . '/' . $itemId . '?recursive=true';
} else {
$url = self::API_URL . '/' . $type . '/' . $itemId;
}
$curl = $this->_bd_prepareCurl(array(
CURLOPT_URL => $url,
CURLOPT_CUSTOMREQUEST => 'DELETE',
));
//unlink or delete File or Folder in the Parent
$this->_bd_curlExec($curl);
} catch (Exception $e) {
return $this->setError('Box error: ' . $e->getMessage());
}
return true;
}
/**
* Get AccessToken file path
*
* @return string ( description_of_the_return_value )
*/
protected function _bd_getATokenFile()
{
$tmp = $aTokenFile = '';
if (!empty($this->token->data->refresh_token)) {
if (!$this->tmp) {
$tmp = elFinder::getStaticVar('commonTempPath');
if (!$tmp) {
$tmp = $this->getTempPath();
}
$this->tmp = $tmp;
}
if ($tmp) {
$aTokenFile = $tmp . DIRECTORY_SEPARATOR . $this->_bd_getInitialToken() . '.btoken';
}
}
return $aTokenFile;
}
/**
* Get Initial Token (MD5 hash)
*
* @return string
*/
protected function _bd_getInitialToken()
{
return (empty($this->token->initialToken)? md5($this->options['client_id'] . (!empty($this->token->data->refresh_token)? $this->token->data->refresh_token : $this->token->data->access_token)) : $this->token->initialToken);
}
/*********************************************************************/
/* OVERRIDE FUNCTIONS */
/*********************************************************************/
/**
* Prepare
* Call from elFinder::netmout() before volume->mount().
*
* @return array
* @author Naoki Sawada
* @author Raja Sharma updating for Box
**/
public function netmountPrepare($options)
{
if (empty($options['client_id']) && defined('ELFINDER_BOX_CLIENTID')) {
$options['client_id'] = ELFINDER_BOX_CLIENTID;
}
if (empty($options['client_secret']) && defined('ELFINDER_BOX_CLIENTSECRET')) {
$options['client_secret'] = ELFINDER_BOX_CLIENTSECRET;
}
if (isset($options['pass']) && $options['pass'] === 'reauth') {
$options['user'] = 'init';
$options['pass'] = '';
$this->session->remove('BoxTokens');
}
if (isset($options['id'])) {
$this->session->set('nodeId', $options['id']);
} else if ($_id = $this->session->get('nodeId')) {
$options['id'] = $_id;
$this->session->set('nodeId', $_id);
}
if (!empty($options['tmpPath'])) {
if ((is_dir($options['tmpPath']) || mkdir($this->options['tmpPath'])) && is_writable($options['tmpPath'])) {
$this->tmp = $options['tmpPath'];
}
}
try {
if (empty($options['client_id']) || empty($options['client_secret'])) {
return array('exit' => true, 'body' => '{msg:errNetMountNoDriver}');
}
$itpCare = isset($options['code']);
$code = $itpCare? $options['code'] : (isset($_GET['code'])? $_GET['code'] : '');
if ($code) {
try {
if (!empty($options['id'])) {
// Obtain the token using the code received by the Box.com API
$this->session->set('BoxTokens',
$this->_bd_obtainAccessToken($options['client_id'], $options['client_secret'], $code));
$out = array(
'node' => $options['id'],
'json' => '{"protocol": "box", "mode": "done", "reset": 1}',
'bind' => 'netmount'
);
} else {
$nodeid = ($_GET['host'] === '1')? 'elfinder' : $_GET['host'];
$out = array(
'node' => $nodeid,
'json' => json_encode(array(
'protocol' => 'box',
'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']);
}
} catch (Exception $e) {
$out = array(
'node' => $options['id'],
'json' => json_encode(array('error' => $e->getMessage())),
);
return array('exit' => 'callback', 'out' => $out);
}
} elseif (!empty($_GET['error'])) {
$out = array(
'node' => $options['id'],
'json' => json_encode(array('error' => elFinder::ERROR_ACCESS_DENIED)),
);
return array('exit' => 'callback', 'out' => $out);
}
if ($options['user'] === 'init') {
$this->token = $this->session->get('BoxTokens');
if ($this->token) {
try {
$this->_bd_refreshToken();
} catch (Exception $e) {
$this->setError($e->getMessage());
$this->token = null;
$this->session->remove('BoxTokens');
}
}
if (empty($this->token)) {
$result = false;
} else {
$path = $options['path'];
if ($path === '/' || $path === 'root') {
$path = '0';
}
$result = $this->_bd_query($path, $fetch_self = false, $recursive = false);
}
if ($result === false) {
$redirect = elFinder::getConnectorUrl();
$redirect .= (strpos($redirect, '?') !== false? '&' : '?') . 'cmd=netmount&protocol=box&host=' . ($options['id'] === 'elfinder'? '1' : $options['id']);
try {
$this->session->set('BoxTokens', (object)array('token' => null));
$url = self::AUTH_URL . '?' . http_build_query(array('response_type' => 'code', 'client_id' => $options['client_id'], 'redirect_uri' => $redirect));
} catch (Exception $e) {
return array('exit' => true, 'body' => '{msg:errAccess}');
}
$html = '<input id="elf-volumedriver-box-host-btn" class="ui-button ui-widget ui-state-default ui-corner-all ui-button-text-only" value="{msg:btnApprove}" type="button">';
$html .= '<script>
jQuery("#' . $options['id'] . '").elfinder("instance").trigger("netmount", {protocol: "box", mode: "makebtn", url: "' . $url . '"});
</script>';
return array('exit' => true, 'body' => $html);
} else {
$folders = [];
if ($result) {
foreach ($result as $res) {
if ($res->type == 'folder') {
$folders[$res->id . ' '] = $res->name;
}
}
natcasesort($folders);
}
if ($options['pass'] === 'folders') {
return ['exit' => true, 'folders' => $folders];
}
$folders = ['root' => 'My Box'] + $folders;
$folders = json_encode($folders);
$expires = empty($this->token->data->refresh_token) ? (int)$this->token->expires : 0;
$mnt2res = empty($this->token->data->refresh_token) ? '' : ', "mnt2res": 1';
$json = '{"protocol": "box", "mode": "done", "folders": ' . $folders . ', "expires": ' . $expires . $mnt2res . '}';
$html = 'Box.com';
$html .= '<script>
jQuery("#' . $options['id'] . '").elfinder("instance").trigger("netmount", ' . $json . ');
</script>';
return array('exit' => true, 'body' => $html);
}
}
} catch (Exception $e) {
return array('exit' => true, 'body' => '{msg:errNetMountNoDriver}');
}
if ($_aToken = $this->session->get('BoxTokens')) {
$options['accessToken'] = json_encode($_aToken);
if ($this->options['path'] === 'root' || !$this->options['path']) {
$this->options['path'] = '/';
}
} else {
$this->session->remove('BoxTokens');
$this->setError(elFinder::ERROR_NETMOUNT, $options['host'], implode(' ', $this->error()));
return array('exit' => true, 'error' => $this->error());
}
$this->session->remove('nodeId');
unset($options['user'], $options['pass'], $options['id']);
return $options;
}
/**
* process of on netunmount
* Drop `box` & rm thumbs.
*
* @param $netVolumes
* @param $key
*
* @return bool
*/
public function netunmount($netVolumes, $key)
{
if ($tmbs = glob(rtrim($this->options['tmbPath'], '\\/') . DIRECTORY_SEPARATOR . $this->tmbPrefix . '*.png')) {
foreach ($tmbs as $file) {
unlink($file);
}
}
return true;
}
/**
* Return debug info for client.
*
* @return array
**/
public function debug()
{
$res = parent::debug();
if (!empty($this->options['netkey']) && !empty($this->options['accessToken'])) {
$res['accessToken'] = $this->options['accessToken'];
}
return $res;
}
/*********************************************************************/
/* 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
* @throws Exception
* @author Dmitry (dio) Levashov
* @author Cem (DiscoFever)
*/
protected function init()
{
if (!$this->options['accessToken']) {
return $this->setError('Required option `accessToken` is undefined.');
}
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'];
}
}
$error = false;
try {
$this->token = json_decode($this->options['accessToken']);
if (!is_object($this->token)) {
throw new Exception('Required option `accessToken` is invalid JSON.');
}
// make net mount key
if (empty($this->options['netkey'])) {
$this->netMountKey = $this->_bd_getInitialToken();
} else {
$this->netMountKey = $this->options['netkey'];
}
if ($this->aTokenFile = $this->_bd_getATokenFile()) {
if (empty($this->options['netkey'])) {
if ($this->aTokenFile) {
if (is_file($this->aTokenFile)) {
$this->token = json_decode(file_get_contents($this->aTokenFile));
if (!is_object($this->token)) {
unlink($this->aTokenFile);
throw new Exception('Required option `accessToken` is invalid JSON.');
}
} else {
file_put_contents($this->aTokenFile, json_encode($this->token), LOCK_EX);
}
}
} else if (is_file($this->aTokenFile)) {
// If the refresh token is the same as the permanent volume
$this->token = json_decode(file_get_contents($this->aTokenFile));
}
}
$this->needOnline && $this->_bd_refreshToken();
} catch (Exception $e) {
$this->token = null;
$error = true;
$this->setError($e->getMessage());
}
if ($this->netMountKey) {
$this->tmbPrefix = 'box' . base_convert($this->netMountKey, 16, 32);
}
if ($error) {
if (empty($this->options['netkey']) && $this->tmbPrefix) {
// for delete thumbnail
$this->netunmount(null, null);
}
return false;
}
// normalize root path
if ($this->options['path'] == 'root') {
$this->options['path'] = '/';
}
$this->root = $this->options['path'] = $this->_normpath($this->options['path']);
$this->options['root'] = ($this->options['root'] == '')? 'Box.com' : $this->options['root'];
if (empty($this->options['alias'])) {
if ($this->needOnline) {
list(, $itemId) = $this->_bd_splitPath($this->options['path']);
$this->options['alias'] = ($this->options['path'] === '/') ? $this->options['root'] :
$this->_bd_query($itemId, $fetch_self = true)->name . '@Box';
if (!empty($this->options['netkey'])) {
elFinder::$instance->updateNetVolumeOption($this->options['netkey'], 'alias', $this->options['alias']);
}
} else {
$this->options['alias'] = $this->options['root'];
}
}
$this->rootName = $this->options['alias'];
// This driver dose not support `syncChkAsTs`
$this->options['syncChkAsTs'] = false;
// 'lsPlSleep' minmum 10 sec
$this->options['lsPlSleep'] = max(10, $this->options['lsPlSleep']);
// enable command archive
$this->options['useRemoteArchive'] = true;
return true;
}
/**
* Configure after successfull mount.
*
* @author Dmitry (dio) Levashov
* @throws elFinderAbortException
*/
protected function configure()
{
parent::configure();
// fallback of $this->tmp
if (!$this->tmp && $this->tmbPathWritable) {
$this->tmp = $this->tmbPath;
}
}
/*********************************************************************/
/* FS API */
/*********************************************************************/
/**
* Close opened connection.
*
* @author Dmitry (dio) Levashov
**/
public function umount()
{
}
/**
* 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|boolean
* @throws elFinderAbortException
*/
protected function isNameExists($path)
{
list(, $name, $parent) = $this->_bd_splitPath($path);
// We can not use it because the search of Box.com there is a time lag.
// ref. https://docs.box.com/reference#searching-for-content
// > Note: If an item is added to Box then it becomes accessible through the search endpoint after ten minutes.
/***
* $url = self::API_URL.'/search?limit=1&offset=0&content_types=name&ancestor_folder_ids='.rawurlencode($pid)
* .'&query='.rawurlencode('"'.$name.'"')
* .'fields='.self::FETCHFIELDS;
* $raw = $this->_bd_fetch($url);
* if (is_array($raw) && count($raw)) {
* return $this->_bd_parseRaw($raw);
* }
***/
$phash = $this->encode($parent);
// do not recursive search
$searchExDirReg = $this->options['searchExDirReg'];
$this->options['searchExDirReg'] = '/.*/';
$search = $this->search($name, array(), $phash);
$this->options['searchExDirReg'] = $searchExDirReg;
if ($search) {
$f = false;
foreach($search as $f) {
if ($f['name'] !== $name) {
$f = false;
}
if ($f) {
break;
}
}
return $f;
}
return false;
}
/**
* Cache dir contents.
*
* @param string $path dir path
*
* @return
* @throws Exception
* @author Dmitry Levashov
*/
protected function cacheDir($path)
{
$this->dirsCache[$path] = array();
$hasDir = false;
if ($path == '/') {
$items = $this->_bd_query('0', $fetch_self = true); // get root directory with folder & files
$itemId = $items->id;
} else {
list(, $itemId) = $this->_bd_splitPath($path);
}
$res = $this->_bd_query($itemId);
if ($res) {
foreach ($res as $raw) {
if ($stat = $this->_bd_parseRaw($raw)) {
$itemPath = $this->_joinPath($path, $raw->id);
$stat = $this->updateCache($itemPath, $stat);
if (empty($stat['hidden'])) {
if (!$hasDir && $stat['mime'] === 'directory') {
$hasDir = true;
}
$this->dirsCache[$path][] = $itemPath;
}
}
}
}
if (isset($this->sessionCache['subdirs'])) {
$this->sessionCache['subdirs'][$path] = $hasDir;
}
return $this->dirsCache[$path];
}
/**
* 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)
{
if ($res = $this->_copy($src, $dst, $name)) {
$this->added[] = $this->stat($res);
return $res;
} else {
return $this->setError(elFinder::ERROR_COPY, $this->_path($src));
}
}
/**
* Remove file/ recursive remove dir.
*
* @param string $path file path
* @param bool $force try to remove even if file locked
*
* @return bool
* @throws elFinderAbortException
* @author Dmitry (dio) Levashov
* @author Naoki Sawada
*/
protected function remove($path, $force = 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 (!$this->_rmdir($path)) {
return $this->setError(elFinder::ERROR_RM, $this->_path($path));
}
} else {
if (!$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->_bd_getThumbnail($path)) {
// try get full contents as fallback
if (!$data = $this->_getContents($path)) {
return false;
}
}
if (!file_put_contents($tmb, $data)) {
return false;
}
$tmbSize = $this->tmbSize;
if (($s = getimagesize($tmb)) == false) {
return false;
}
$result = true;
/* If image smaller or equal thumbnail size - just fitting to thumbnail square */
if ($s[0] <= $tmbSize && $s[1] <= $tmbSize) {
$result = $this->imgSquareFit($tmb, $tmbSize, $tmbSize, 'center', 'middle', $this->options['tmbBgColor'], 'png');
} else {
if ($this->options['tmbCrop']) {
/* Resize and crop if image bigger than thumbnail */
if (!(($s[0] > $tmbSize && $s[1] <= $tmbSize) || ($s[0] <= $tmbSize && $s[1] > $tmbSize)) || ($s[0] > $tmbSize && $s[1] > $tmbSize)) {
$result = $this->imgResize($tmb, $tmbSize, $tmbSize, true, false, 'png');
}
if ($result && ($s = getimagesize($tmb)) != false) {
$x = $s[0] > $tmbSize ? intval(($s[0] - $tmbSize) / 2) : 0;
$y = $s[1] > $tmbSize ? intval(($s[1] - $tmbSize) / 2) : 0;
$result = $this->imgCrop($tmb, $tmbSize, $tmbSize, $x, $y, 'png');
}
} else {
$result = $this->imgResize($tmb, $tmbSize, $tmbSize, true, true, 'png');
}
if ($result) {
$result = $this->imgSquareFit($tmb, $tmbSize, $tmbSize, 'center', 'middle', $this->options['tmbBgColor'], 'png');
}
}
if (!$result) {
unlink($tmb);
return false;
}
return $name;
}
/**
* Return thumbnail file name for required file.
*
* @param array $stat file stat
*
* @return string
* @author Dmitry (dio) Levashov
**/
protected function tmbname($stat)
{
return $this->tmbPrefix . $stat['rev'] . $stat['ts'] . '.png';
}
/**
* Return content URL.
*
* @param object $raw data
*
* @return string
* @author Naoki Sawada
**/
protected function getSharedWebContentLink($raw)
{
if ($raw->shared_link->url) {
return sprintf('https://app.box.com/index.php?rm=box_download_shared_file&shared_name=%s&file_id=f_%s', basename($raw->shared_link->url), $raw->id);
} elseif ($raw->shared_link->download_url) {
return $raw->shared_link->download_url;
}
return false;
}
/**
* Return content URL.
*
* @param string $hash file hash
* @param array $options options
*
* @return string
* @throws Exception
* @author Naoki Sawada
*/
public function getContentUrl($hash, $options = array())
{
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);
list(, $itemId) = $this->_bd_splitPath($path);
$params['shared_link']['access'] = 'open'; //open|company|collaborators
$url = self::API_URL . '/files/' . $itemId;
$curl = $this->_bd_prepareCurl(array(
CURLOPT_URL => $url,
CURLOPT_CUSTOMREQUEST => 'PUT',
CURLOPT_POSTFIELDS => json_encode($params),
));
$res = $this->_bd_curlExec($curl, true, array(
// The data is sent as JSON as per Box documentation.
'Content-Type: application/json',
));
if ($url = $this->getSharedWebContentLink($res)) {
return $url;
}
}
return '';
}
/*********************** paths/urls *************************/
/**
* Return parent directory path.
*
* @param string $path file path
*
* @return string
* @author Dmitry (dio) Levashov
**/
protected function _dirname($path)
{
list(, , $dirname) = $this->_bd_splitPath($path);
return $dirname;
}
/**
* Return file name.
*
* @param string $path file path
*
* @return string
* @author Dmitry (dio) Levashov
**/
protected function _basename($path)
{
list(, $basename) = $this->_bd_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)
{
if (strval($dir) === '0') {
$dir = '';
}
return $this->_normpath($dir . '/' . $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)
{
return $this->rootName . $this->_normpath(substr($path, strlen($this->root)));
}
/**
* 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
* @throws Exception
* @author Dmitry (dio) Levashov
*/
protected function _stat($path)
{
if ($raw = $this->_bd_getRawItem($path)) {
return $this->_bd_parseRaw($raw);
}
return false;
}
/**
* Return true if path is dir and has at least one childs directory.
*
* @param string $path dir path
*
* @return bool
* @throws Exception
* @author Dmitry (dio) Levashov
*/
protected function _subdirs($path)
{
list(, $itemId) = $this->_bd_splitPath($path);
$path = '/folders/' . $itemId . '/items?limit=1&offset=0&fields=' . self::FETCHFIELDS;
$url = self::API_URL . $path;
if ($res = $this->_bd_fetch($url)) {
if ($res[0]->type == 'folder') {
return true;
}
}
return false;
}
/**
* Return object width and height
* Ususaly used for images, but can be realize for video etc...
*
* @param string $path file path
* @param string $mime file mime type
*
* @return string
* @throws ImagickException
* @throws elFinderAbortException
* @author Dmitry (dio) Levashov
*/
protected function _dimensions($path, $mime)
{
if (strpos($mime, 'image') !== 0) {
return '';
}
$ret = '';
if ($work = $this->getWorkFile($path)) {
if ($size = @getimagesize($work)) {
$cache['width'] = $size[0];
$cache['height'] = $size[1];
$ret = array('dim' => $size[0] . 'x' . $size[1]);
$srcfp = fopen($work, 'rb');
$target = isset(elFinder::$currentArgs['target'])? elFinder::$currentArgs['target'] : '';
if ($subImgLink = $this->getSubstituteImgLink($target, $size, $srcfp)) {
$ret['url'] = $subImgLink;
}
}
}
is_file($work) && @unlink($work);
return $ret;
}
/******************** file/dir content *********************/
/**
* Return files list in directory.
*
* @param string $path dir path
*
* @return array
* @throws Exception
* @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 string $mode
*
* @return resource|false
* @author Dmitry (dio) Levashov
*/
protected function _fopen($path, $mode = 'rb')
{
if ($mode === 'rb' || $mode === 'r') {
list(, $itemId) = $this->_bd_splitPath($path);
$data = array(
'target' => self::API_URL . '/files/' . $itemId . '/content',
'headers' => array('Authorization: Bearer ' . $this->token->data->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
* @param string $path
*
* @return void
* @author Dmitry (dio) Levashov
*/
protected function _fclose($fp, $path = '')
{
is_resource($fp) && fclose($fp);
if ($path) {
unlink($this->getTempFile($path));
}
}
/******************** file/dir manipulations *************************/
/**
* Create dir and return created dir path or false on failed.
*
* @param string $path parent dir path
* @param string $name new directory name
*
* @return string|bool
* @author Dmitry (dio) Levashov
**/
protected function _mkdir($path, $name)
{
try {
list(, $parentId) = $this->_bd_splitPath($path);
$params = array('name' => $name, 'parent' => array('id' => $parentId));
$url = self::API_URL . '/folders';
$curl = $this->_bd_prepareCurl(array(
CURLOPT_URL => $url,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($params),
));
//create the Folder in the Parent
$folder = $this->_bd_curlExec($curl, $path);
return $this->_joinPath($path, $folder->id);
} catch (Exception $e) {
return $this->setError('Box 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, array());
}
/**
* 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 string|false
* @author Dmitry (dio) Levashov
**/
protected function _copy($source, $targetDir, $name)
{
try {
//Set the Parent id
list(, $parentId) = $this->_bd_splitPath($targetDir);
list(, $srcId) = $this->_bd_splitPath($source);
$srcItem = $this->_bd_getRawItem($source);
$properties = array('name' => $name, 'parent' => array('id' => $parentId));
$data = (object)$properties;
$type = ($srcItem->type === 'folder') ? 'folders' : 'files';
$url = self::API_URL . '/' . $type . '/' . $srcId . '/copy';
$curl = $this->_bd_prepareCurl(array(
CURLOPT_URL => $url,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($data),
));
//copy File in the Parent
$result = $this->_bd_curlExec($curl, $targetDir);
if (isset($result->id)) {
if ($type === 'folders' && isset($this->sessionCache['subdirs'])) {
$this->sessionCache['subdirs'][$targetDir] = true;
}
return $this->_joinPath($targetDir, $result->id);
}
return false;
} catch (Exception $e) {
return $this->setError('Box error: ' . $e->getMessage());
}
}
/**
* 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)
{
try {
//moving and renaming a file or directory
//Set new Parent and remove old parent
list(, $parentId) = $this->_bd_splitPath($targetDir);
list(, $itemId) = $this->_bd_splitPath($source);
$srcItem = $this->_bd_getRawItem($source);
//rename or move file or folder in destination target
$properties = array('name' => $name, 'parent' => array('id' => $parentId));
$type = ($srcItem->type === 'folder') ? 'folders' : 'files';
$url = self::API_URL . '/' . $type . '/' . $itemId;
$data = (object)$properties;
$curl = $this->_bd_prepareCurl(array(
CURLOPT_URL => $url,
CURLOPT_CUSTOMREQUEST => 'PUT',
CURLOPT_POSTFIELDS => json_encode($data),
));
$result = $this->_bd_curlExec($curl, $targetDir, array(
// The data is sent as JSON as per Box documentation.
'Content-Type: application/json',
));
if ($result && isset($result->id)) {
return $this->_joinPath($targetDir, $result->id);
}
return false;
} catch (Exception $e) {
return $this->setError('Box error: ' . $e->getMessage());
}
}
/**
* Remove file.
*
* @param string $path file path
*
* @return bool
* @author Dmitry (dio) Levashov
**/
protected function _unlink($path)
{
return $this->_bd_unlink($path, 'files');
}
/**
* Remove dir.
*
* @param string $path dir path
*
* @return bool
* @author Dmitry (dio) Levashov
**/
protected function _rmdir($path)
{
return $this->_bd_unlink($path, 'folders');
}
/**
* Create new file and write into it from file pointer.
* Return new file path or false on error.
*
* @param resource $fp file pointer
* @param string $dir target dir path
* @param string $name file name
* @param array $stat file stat (required by some virtual fs)
*
* @return bool|string
* @author Dmitry (dio) Levashov
**/
protected function _save($fp, $path, $name, $stat)
{
$itemId = '';
if ($name === '') {
list($parentId, $itemId, $parent) = $this->_bd_splitPath($path);
} else {
if ($stat) {
if (isset($stat['name'])) {
$name = $stat['name'];
}
if (isset($stat['rev']) && strpos($stat['hash'], $this->id) === 0) {
$itemId = $stat['rev'];
}
}
list(, $parentId) = $this->_bd_splitPath($path);
$parent = $path;
}
try {
//Create or Update a file
$metaDatas = stream_get_meta_data($fp);
$tmpFilePath = isset($metaDatas['uri']) ? $metaDatas['uri'] : '';
// remote contents
if (!$tmpFilePath || empty($metaDatas['seekable'])) {
$tmpHandle = $this->tmpfile();
stream_copy_to_stream($fp, $tmpHandle);
$metaDatas = stream_get_meta_data($tmpHandle);
$tmpFilePath = $metaDatas['uri'];
}
if ($itemId === '') {
//upload or create new file in destination target
$properties = array('name' => $name, 'parent' => array('id' => $parentId));
$url = self::UPLOAD_URL . '/files/content';
} else {
//update existing file in destination target
$properties = array('name' => $name);
$url = self::UPLOAD_URL . '/files/' . $itemId . '/content';
}
if (class_exists('CURLFile')) {
$cfile = new CURLFile($tmpFilePath);
} else {
$cfile = '@' . $tmpFilePath;
}
$params = array('attributes' => json_encode($properties), 'file' => $cfile);
$curl = $this->_bd_prepareCurl(array(
CURLOPT_URL => $url,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $params,
));
$file = $this->_bd_curlExec($curl, $parent);
return $this->_joinPath($parent, $file->entries[0]->id);
} catch (Exception $e) {
return $this->setError('Box error: ' . $e->getMessage());
}
}
/**
* Get file contents.
*
* @param string $path file path
*
* @return string|false
* @author Dmitry (dio) Levashov
**/
protected function _getContents($path)
{
try {
list(, $itemId) = $this->_bd_splitPath($path);
$url = self::API_URL . '/files/' . $itemId . '/content';
$contents = $this->_bd_fetch($url, true);
} catch (Exception $e) {
return $this->setError('Box 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, '', array());
fclose($fp);
}
file_exists($local) && unlink($local);
}
return $res;
}
/**
* Detect available archivers.
**/
protected function _checkArchivers()
{
// die('Not yet implemented. (_checkArchivers)');
return array();
}
/**
* chmod implementation.
*
* @return bool
**/
protected function _chmod($path, $mode)
{
return false;
}
/**
* Extract files from archive.
*
* @param string $path archive path
* @param array $arc archiver command and arguments (same as in $this->archivers)
*
* @return true
* @author Dmitry (dio) Levashov,
* @author Alexey Sukhotin
**/
protected function _extract($path, $arc)
{
die('Not yet implemented. (_extract)');
}
/**
* Create archive and return its path.
*
* @param string $dir target dir
* @param array $files files names list
* @param string $name archive name
* @param array $arc archiver options
*
* @return string|bool
* @author Dmitry (dio) Levashov,
* @author Alexey Sukhotin
**/
protected function _archive($dir, $files, $name, $arc)
{
die('Not yet implemented. (_archive)');
}
} // END class