nextcloud / server

apps/files_external/lib/AppInfo/Application.php

Indentation +103 added lines, -103 removed lines

@@ -52,108 +52,108 @@
  */
 class Application extends App implements IBackendProvider, IAuthMechanismProvider {
 
-	public function __construct(array $urlParams = array()) {
-		parent::__construct('files_external', $urlParams);
-
-		$container = $this->getContainer();
-
-		$container->registerService('OCP\Files\Config\IUserMountCache', function (IAppContainer $c) {
-			return $c->getServer()->query('UserMountCache');
-		});
-
-		$backendService = $container->query('OCA\\Files_External\\Service\\BackendService');
-		$backendService->registerBackendProvider($this);
-		$backendService->registerAuthMechanismProvider($this);
-
-		// force-load auth mechanisms since some will register hooks
-		// TODO: obsolete these and use the TokenProvider to get the user's password from the session
-		$this->getAuthMechanisms();
-
-		// app developers: do NOT depend on this! it will disappear with oC 9.0!
-		\OC::$server->getEventDispatcher()->dispatch(
-			'OCA\\Files_External::loadAdditionalBackends'
-		);
-	}
-
-	/**
-	 * Register settings templates
-	 */
-	public function registerSettings() {
-		$container = $this->getContainer();
-		$userSession = $container->getServer()->getUserSession();
-		if (!$userSession->isLoggedIn()) {
-			return;
-		}
-		$backendService = $container->query('OCA\\Files_External\\Service\\BackendService');
-
-		/** @var \OCA\Files_External\Service\UserGlobalStoragesService $userGlobalStoragesService */
-		$userGlobalStoragesService = $container->query('OCA\Files_External\Service\UserGlobalStoragesService');
-		if (count($userGlobalStoragesService->getStorages()) > 0 || $backendService->isUserMountingAllowed()) {
-			\OCP\App::registerPersonal('files_external', 'personal');
-		}
-	}
-
-	/**
-	 * @{inheritdoc}
-	 */
-	public function getBackends() {
-		$container = $this->getContainer();
-
-		$backends = [
-			$container->query(Local::class),
-			$container->query(FTP::class),
-			$container->query(DAV::class),
-			$container->query(OwnCloud::class),
-			$container->query(SFTP::class),
-			$container->query(AmazonS3::class),
-			$container->query(Dropbox::class),
-			$container->query(Google::class),
-			$container->query(Swift::class),
-			$container->query(SFTP_Key::class),
-			$container->query(SMB::class),
-			$container->query(SMB_OC::class),
-			$container->query(SharePoint::class),
-		];
-
-		return $backends;
-	}
-
-	/**
-	 * @{inheritdoc}
-	 */
-	public function getAuthMechanisms() {
-		$container = $this->getContainer();
-
-		return [
-			// AuthMechanism::SCHEME_NULL mechanism
-			$container->query('OCA\Files_External\Lib\Auth\NullMechanism'),
-
-			// AuthMechanism::SCHEME_BUILTIN mechanism
-			$container->query('OCA\Files_External\Lib\Auth\Builtin'),
-
-			// AuthMechanism::SCHEME_PASSWORD mechanisms
-			$container->query('OCA\Files_External\Lib\Auth\Password\Password'),
-			$container->query('OCA\Files_External\Lib\Auth\Password\SessionCredentials'),
-			$container->query('OCA\Files_External\Lib\Auth\Password\LoginCredentials'),
-			$container->query('OCA\Files_External\Lib\Auth\Password\UserProvided'),
-			$container->query('OCA\Files_External\Lib\Auth\Password\GlobalAuth'),
-
-			// AuthMechanism::SCHEME_OAUTH1 mechanisms
-			$container->query('OCA\Files_External\Lib\Auth\OAuth1\OAuth1'),
-
-			// AuthMechanism::SCHEME_OAUTH2 mechanisms
-			$container->query('OCA\Files_External\Lib\Auth\OAuth2\OAuth2'),
-
-			// AuthMechanism::SCHEME_PUBLICKEY mechanisms
-			$container->query('OCA\Files_External\Lib\Auth\PublicKey\RSA'),
-
-			// AuthMechanism::SCHEME_OPENSTACK mechanisms
-			$container->query('OCA\Files_External\Lib\Auth\OpenStack\OpenStack'),
-			$container->query('OCA\Files_External\Lib\Auth\OpenStack\Rackspace'),
-
-			// Specialized mechanisms
-			$container->query('OCA\Files_External\Lib\Auth\AmazonS3\AccessKey'),
-		];
-	}
+    public function __construct(array $urlParams = array()) {
+        parent::__construct('files_external', $urlParams);
+
+        $container = $this->getContainer();
+
+        $container->registerService('OCP\Files\Config\IUserMountCache', function (IAppContainer $c) {
+            return $c->getServer()->query('UserMountCache');
+        });
+
+        $backendService = $container->query('OCA\\Files_External\\Service\\BackendService');
+        $backendService->registerBackendProvider($this);
+        $backendService->registerAuthMechanismProvider($this);
+
+        // force-load auth mechanisms since some will register hooks
+        // TODO: obsolete these and use the TokenProvider to get the user's password from the session
+        $this->getAuthMechanisms();
+
+        // app developers: do NOT depend on this! it will disappear with oC 9.0!
+        \OC::$server->getEventDispatcher()->dispatch(
+            'OCA\\Files_External::loadAdditionalBackends'
+        );
+    }
+
+    /**
+     * Register settings templates
+     */
+    public function registerSettings() {
+        $container = $this->getContainer();
+        $userSession = $container->getServer()->getUserSession();
+        if (!$userSession->isLoggedIn()) {
+            return;
+        }
+        $backendService = $container->query('OCA\\Files_External\\Service\\BackendService');
+
+        /** @var \OCA\Files_External\Service\UserGlobalStoragesService $userGlobalStoragesService */
+        $userGlobalStoragesService = $container->query('OCA\Files_External\Service\UserGlobalStoragesService');
+        if (count($userGlobalStoragesService->getStorages()) > 0 || $backendService->isUserMountingAllowed()) {
+            \OCP\App::registerPersonal('files_external', 'personal');
+        }
+    }
+
+    /**
+     * @{inheritdoc}
+     */
+    public function getBackends() {
+        $container = $this->getContainer();
+
+        $backends = [
+            $container->query(Local::class),
+            $container->query(FTP::class),
+            $container->query(DAV::class),
+            $container->query(OwnCloud::class),
+            $container->query(SFTP::class),
+            $container->query(AmazonS3::class),
+            $container->query(Dropbox::class),
+            $container->query(Google::class),
+            $container->query(Swift::class),
+            $container->query(SFTP_Key::class),
+            $container->query(SMB::class),
+            $container->query(SMB_OC::class),
+            $container->query(SharePoint::class),
+        ];
+
+        return $backends;
+    }
+
+    /**
+     * @{inheritdoc}
+     */
+    public function getAuthMechanisms() {
+        $container = $this->getContainer();
+
+        return [
+            // AuthMechanism::SCHEME_NULL mechanism
+            $container->query('OCA\Files_External\Lib\Auth\NullMechanism'),
+
+            // AuthMechanism::SCHEME_BUILTIN mechanism
+            $container->query('OCA\Files_External\Lib\Auth\Builtin'),
+
+            // AuthMechanism::SCHEME_PASSWORD mechanisms
+            $container->query('OCA\Files_External\Lib\Auth\Password\Password'),
+            $container->query('OCA\Files_External\Lib\Auth\Password\SessionCredentials'),
+            $container->query('OCA\Files_External\Lib\Auth\Password\LoginCredentials'),
+            $container->query('OCA\Files_External\Lib\Auth\Password\UserProvided'),
+            $container->query('OCA\Files_External\Lib\Auth\Password\GlobalAuth'),
+
+            // AuthMechanism::SCHEME_OAUTH1 mechanisms
+            $container->query('OCA\Files_External\Lib\Auth\OAuth1\OAuth1'),
+
+            // AuthMechanism::SCHEME_OAUTH2 mechanisms
+            $container->query('OCA\Files_External\Lib\Auth\OAuth2\OAuth2'),
+
+            // AuthMechanism::SCHEME_PUBLICKEY mechanisms
+            $container->query('OCA\Files_External\Lib\Auth\PublicKey\RSA'),
+
+            // AuthMechanism::SCHEME_OPENSTACK mechanisms
+            $container->query('OCA\Files_External\Lib\Auth\OpenStack\OpenStack'),
+            $container->query('OCA\Files_External\Lib\Auth\OpenStack\Rackspace'),
+
+            // Specialized mechanisms
+            $container->query('OCA\Files_External\Lib\Auth\AmazonS3\AccessKey'),
+        ];
+    }
 
 }

apps/files_external/lib/Lib/Backend/SharePoint.php

Indentation +13 added lines, -13 removed lines

@@ -32,18 +32,18 @@
 
 class SharePoint extends Backend {
 
-	public function __construct(IL10N $l, Password $legacyAuth) {
-		$this
-			->setIdentifier('sharepoint')
-			->setStorageClass(SharePointStorage::class)
-			->setText($l->t('SharePoint'))
-			->addParameters([
-				(new DefinitionParameter('host', $l->t('Host'))),
-				(new DefinitionParameter('documentLibrary', $l->t('Document Library'))),
-			])
-			->addAuthScheme(AuthMechanism::SCHEME_PASSWORD)
-			->setLegacyAuthMechanism($legacyAuth)
-		;
-	}
+    public function __construct(IL10N $l, Password $legacyAuth) {
+        $this
+            ->setIdentifier('sharepoint')
+            ->setStorageClass(SharePointStorage::class)
+            ->setText($l->t('SharePoint'))
+            ->addParameters([
+                (new DefinitionParameter('host', $l->t('Host'))),
+                (new DefinitionParameter('documentLibrary', $l->t('Document Library'))),
+            ])
+            ->addAuthScheme(AuthMechanism::SCHEME_PASSWORD)
+            ->setLegacyAuthMechanism($legacyAuth)
+        ;
+    }
 
 }

apps/files_external/lib/Lib/SharePoint/ContextsFactory.php

Indentation +6 added lines, -6 removed lines

@@ -30,12 +30,12 @@
 
 class ContextsFactory {
 
-	public function getAuthContext($user, $password) {
-		return new NetworkCredentialContext($user, $password);
-	}
+    public function getAuthContext($user, $password) {
+        return new NetworkCredentialContext($user, $password);
+    }
 
-	public function getClientContext($server, IAuthenticationContext $authContext) {
-		return new ClientContext($server, $authContext);
-	}
+    public function getClientContext($server, IAuthenticationContext $authContext) {
+        return new ClientContext($server, $authContext);
+    }
 
 }

apps/files_external/lib/Lib/SharePoint/SharePointClientFactory.php

Indentation +15 added lines, -15 removed lines

@@ -24,19 +24,19 @@
 namespace OCA\Files_External\Lib\SharePoint;
 
 class SharePointClientFactory {
-	/**
-	 * @param ContextsFactory $contextsFactory
-	 * @param string $sharePointUrl
-	 * @param array $credentials
-	 * @param string $documentLibraryTitle
-	 * @return SharePointClient
-	 */
-	public function getClient(
-		ContextsFactory $contextsFactory,
-		$sharePointUrl,
-		array $credentials,
-		$documentLibraryTitle)
-	{
-		return new SharePointClient($contextsFactory, $sharePointUrl, $credentials, $documentLibraryTitle);
-	}
+    /**
+     * @param ContextsFactory $contextsFactory
+     * @param string $sharePointUrl
+     * @param array $credentials
+     * @param string $documentLibraryTitle
+     * @return SharePointClient
+     */
+    public function getClient(
+        ContextsFactory $contextsFactory,
+        $sharePointUrl,
+        array $credentials,
+        $documentLibraryTitle)
+    {
+        return new SharePointClient($contextsFactory, $sharePointUrl, $credentials, $documentLibraryTitle);
+    }
 }

apps/files_external/lib/Lib/Storage/SharePoint.php

Indentation +387 added lines, -387 removed lines

@@ -37,392 +37,392 @@
 use Office365\PHP\Client\SharePoint\ListItem;
 
 class SharePoint extends Common {
-	const SP_PROPERTY_SIZE = 'Length';
-	const SP_PROPERTY_MTIME = 'TimeLastModified';
-	const SP_PROPERTY_URL = 'ServerRelativeUrl';
-
-	/** @var  string */
-	protected $server;
-
-	/** @var  string */
-	protected $documentLibrary;
-
-	/** @var  string */
-	protected $authUser;
-
-	/** @var  string */
-	protected $authPwd;
-
-	/** @var  SharePointClient */
-	protected $spClient;
-
-	/** @var  CappedMemoryCache */
-	protected $fileCache;
-
-	/** @var ContextsFactory */
-	private $contextsFactory;
-
-	public function __construct($parameters) {
-		$this->server = $parameters['host'];
-		$this->documentLibrary = $parameters['documentLibrary'];
-
-		if(strpos($this->documentLibrary, '"') !== false) {
-			// they are, amongst others, not allowed and we use it in the filter
-			// cf. https://support.microsoft.com/en-us/kb/2933738
-			// TODO: verify, it talks about files and folders mostly
-			throw new \InvalidArgumentException('Illegal character in Document Library Name');
-		}
-
-		if(!isset($parameters['user']) || !isset($parameters['password'])) {
-			throw new \UnexpectedValueException('No user or password given');
-		}
-		$this->authUser = $parameters['user'];
-		$this->authPwd  = $parameters['password'];
-
-		$this->fixDI($parameters);
-	}
-
-	/**
-	 * Get the identifier for the storage,
-	 * the returned id should be the same for every storage object that is created with the same parameters
-	 * and two storage objects with the same id should refer to two storages that display the same files.
-	 *
-	 * @return string
-	 * @since 6.0.0
-	 */
-	public function getId() {
-		return 'SharePoint::' . $this->server . '::' . $this->documentLibrary . '::' . $this->authUser;
-	}
-
-	/**
-	 * see http://php.net/manual/en/function.mkdir.php
-	 * implementations need to implement a recursive mkdir
-	 *
-	 * @param string $path
-	 * @return bool
-	 * @since 6.0.0
-	 */
-	public function mkdir($path) {
-		$serverUrl = $this->formatPath($path);
-		try {
-			$folder = $this->spClient->createFolder($serverUrl);
-			$this->fileCache->set($serverUrl, [
-				'instance' => $folder,
-				'children' => [
-					'folders' => $folder->getFolders(),
-					'files' => $folder->getFiles()
-				]
-			]);
-			return true;
-		} catch (\Exception $e) {
-			$this->fileCache->remove($serverUrl);
-			return false;
-		}
-	}
-
-	/**
-	 * see http://php.net/manual/en/function.rmdir.php
-	 *
-	 * @param string $path
-	 * @return bool
-	 * @since 6.0.0
-	 */
-	public function rmdir($path) {
-		$serverUrl = $this->formatPath($path);
-		try {
-			$cacheEntry = $this->fileCache->get($serverUrl);
-			$folder = null;
-			if(is_array($cacheEntry) && isset($cacheEntry['instance'])) {
-				$folder = $cacheEntry['instance'];
-			}
-			$this->spClient->deleteFolder($serverUrl, $folder);
-			$this->fileCache->set($serverUrl, false);
-			return true;
-		} catch (\Exception $e) {
-			$this->fileCache->remove($serverUrl);
-			return false;
-		}
-	}
-
-	/**
-	 * see http://php.net/manual/en/function.opendir.php
-	 *
-	 * @param string $path
-	 * @return resource|false
-	 * @since 6.0.0
-	 */
-	public function opendir($path) {
-		try {
-			$serverUrl = $this->formatPath($path);
-			//$collections = $this->spClient->fetchFolderContents($serverUrl, ['Name', 'ListItemAllFields']);	// does not work for some reason :(
-			$collections = $this->getFolderContents($serverUrl);
-			$files = [];
-
-			foreach ($collections as $collection) {
-				/** @var File[]|Folder[] $items */
-				$items = $collection->getData();
-				foreach ($items as $item) {
-					/** @var ListItem $fields */
-					if(!$this->spClient->isHidden($item)) {
-						$files[] = $item->getProperty('Name');
-					}
-				}
-			}
-
-			return IteratorDirectory::wrap($files);
-		} catch (NotFoundException $e) {
-			return false;
-		}
-	}
-
-	/**
-	 * see http://php.net/manual/en/function.stat.php
-	 * only the following keys are required in the result: size and mtime
-	 *
-	 * @param string $path
-	 * @return array|false
-	 * @since 6.0.0
-	 */
-	public function stat($path) {
-		$serverUrl = $this->formatPath($path);
-		try {
-			$file = $this->getFileOrFolder($serverUrl);
-		} catch (\Exception $e) {
-			return false;
-		}
-
-		$size = $file->getProperty(self::SP_PROPERTY_SIZE) ?: FileInfo::SPACE_UNKNOWN;
-		$mtimeValue = $file->getProperty(self::SP_PROPERTY_MTIME);
-		$mtime = $mtimeValue ? new \DateTime($mtimeValue) : null;
-
-		$stat = [
-			// int64, size in bytes, excluding the size of any Web Parts that are used in the file.
-			'size'  => $size,
-			'mtime' => $mtime->getTimestamp(),
-			// no property in SP 2013 & 2016, other storages do the same  :speak_no_evil:
-			'atime' => time(),
-		];
-
-		if(!is_null($stat['mtime'])) {
-			return $stat;
-		}
-
-		// If we do not get a mtime from SP, we treat it as an error
-		// thus returning false, according to PHP documentation on stat()
-		return false;
-	}
-
-	/**
-	 * see http://php.net/manual/en/function.filetype.php
-	 *
-	 * @param string $path
-	 * @return false|string
-	 * @throws \Exception
-	 * @since 6.0.0
-	 */
-	public function filetype($path) {
-		try {
-			$serverUrl = $this->formatPath($path);
-			$object = $this->getFileOrFolder($serverUrl);
-		} catch (NotFoundException $e) {
-			return false;
-		}
-		if($object instanceof File) {
-			return 'file';
-		} else if($object instanceof Folder) {
-			return 'dir';
-		} else {
-			return false;
-		}
-	}
-
-	/**
-	 * see http://php.net/manual/en/function.file_exists.php
-	 *
-	 * @param string $path
-	 * @return bool
-	 * @since 6.0.0
-	 */
-	public function file_exists($path) {
-		try {
-			$serverUrl = $this->formatPath($path);
-			// alternative approach is to use a CAML query instead of querying
-			// for file and folder. It is not necessarily faster, though.
-			// Would need evaluation of typical use cases (I assume most often
-			// existing files are checked) and measurements.
-			$this->getFileOrFolder($serverUrl);
-			return true;
-		} catch (NotFoundException $e) {
-			return false;
-		}
-	}
-
-	/**
-	 * see http://php.net/manual/en/function.unlink.php
-	 *
-	 * @param string $path
-	 * @return bool
-	 * @since 6.0.0
-	 */
-	public function unlink($path) {
-		//  FIXME:: all is totally wrong
-		$path = trim($path);
-		if($path === '/' || $path === '') {
-			return false;
-		}
-		foreach([true, false] as $asFile) {
-			try {
-				$fsObject = $this->spClient->fetchFileOrFolder($path, $asFile);
-				$fsObject->deleteObject();
-				return true;
-			} catch(\Exception $e) {
-				// NOOP
-			}
-		}
-		return false;
-	}
-
-	/**
-	 * see http://php.net/manual/en/function.fopen.php
-	 *
-	 * @param string $path
-	 * @param string $mode
-	 * @return resource|false
-	 * @since 6.0.0
-	 */
-	public function fopen($path, $mode) {
-		// TODO: Implement fopen() method.
-		return false;
-	}
-
-	/**
-	 * see http://php.net/manual/en/function.touch.php
-	 * If the backend does not support the operation, false should be returned
-	 *
-	 * @param string $path
-	 * @param int $mtime
-	 * @return bool
-	 * @since 6.0.0
-	 */
-	public function touch($path, $mtime = null) {
-		// TODO: Implement touch() method.
-		return true;
-	}
-
-
-	/**
-	 * work around dependency injection issues so we can test this class properly
-	 *
-	 * @param array $parameters
-	 */
-	private function fixDI(array $parameters) {
-		if(isset($parameters['contextFactory'])
-			&& $parameters['contextFactory'] instanceof ContextsFactory)
-		{
-			$this->contextsFactory = $parameters['contextFactory'];
-		} else {
-			$this->contextsFactory = new ContextsFactory();
-		}
-
-		if(isset($parameters['sharePointClientFactory'])
-			&& $parameters['sharePointClientFactory'] instanceof SharePointClientFactory)
-		{
-			$spcFactory = $parameters['sharePointClientFactory'];
-		} else {
-			$spcFactory = new SharePointClientFactory();
-		}
-		$this->spClient = $spcFactory->getClient(
-			$this->contextsFactory,
-			$this->server,
-			[ 'user' => $this->authUser, 'password' => $this->authPwd],
-			$this->documentLibrary
-		);
-
-		if(isset($parameters['cappedMemoryCache'])) {
-			$this->fileCache = $parameters['cappedMemoryCache'];
-		} else {
-			$this->fileCache = new CappedMemoryCache('256');
-		}
-	}
-
-	/**
-	 * @param $serverUrl
-	 * @return ClientObjectCollection[]
-	 */
-	private function getFolderContents($serverUrl) {
-		$entry = $this->fileCache->get($serverUrl);
-		if($entry === null || !isset($entry['children'])) {
-			$folder = isset($entry['instance']) ? $entry['instance'] : null;
-			$contents = $this->spClient->fetchFolderContents($serverUrl, null, $folder);
-			$cacheItem = $entry ?: [];
-			$cacheItem['children'] = $contents;
-			$this->fileCache->set($serverUrl, $cacheItem);
-
-			// cache children instances
-			foreach ($contents as $collection) {
-				foreach ($collection->getData() as $item) {
-					/** @var  File|Folder $item */
-					$url = $item->getProperty(self::SP_PROPERTY_URL);
-					$itemEntry = $this->fileCache->get($url);
-					$itemEntry = $itemEntry ?: [];
-					if(!isset($itemEntry['instance'])) {
-						$itemEntry['instance'] = $item;
-						$this->fileCache->set($url, $itemEntry);
-					}
-				}
-			}
-		} else {
-			$contents = $entry['children'];
-		}
-		return $contents;
-	}
-
-	/**
-	 * @param $serverUrl
-	 * @return File|Folder
-	 * @throws NotFoundException
-	 */
-	private function getFileOrFolder($serverUrl) {
-		$entry = $this->fileCache->get($serverUrl);
-		if($entry === false) {
-			throw new NotFoundException('File or Folder not found');
-		} else if($entry === null || !isset($entry['instance'])) {
-			try {
-				$file = $this->spClient->fetchFileOrFolder($serverUrl, [self::SP_PROPERTY_SIZE, self::SP_PROPERTY_MTIME]);
-			} catch (NotFoundException $e) {
-				$this->fileCache->set($serverUrl, false);
-				throw $e;
-			}
-			$cacheItem = $entry ?: [];
-			$cacheItem['instance'] = $file;
-			$this->fileCache->set($serverUrl, $cacheItem);
-		} else {
-			$file = $entry['instance'];
-		}
-		return $file;
-	}
-
-	/**
-	 * creates the relative server "url" out of the provided path
-	 *
-	 * @param $path
-	 * @return string
-	 */
-	private function formatPath($path) {
-		$path = trim($path, '/');
-		$serverUrl = '/' . $this->documentLibrary;
-		if($path !== '') {
-			$serverUrl .= '/' . $path;
-		}
-
-		$pathParts = explode('/', $serverUrl);
-		$filename = array_pop($pathParts);
-		if($filename === '.') {
-			// remove /. from the end of the path
-			$serverUrl = mb_substr($serverUrl, 0, mb_strlen($serverUrl) - 2);
-		}
-
-		return $serverUrl;
-	}
+    const SP_PROPERTY_SIZE = 'Length';
+    const SP_PROPERTY_MTIME = 'TimeLastModified';
+    const SP_PROPERTY_URL = 'ServerRelativeUrl';
+
+    /** @var  string */
+    protected $server;
+
+    /** @var  string */
+    protected $documentLibrary;
+
+    /** @var  string */
+    protected $authUser;
+
+    /** @var  string */
+    protected $authPwd;
+
+    /** @var  SharePointClient */
+    protected $spClient;
+
+    /** @var  CappedMemoryCache */
+    protected $fileCache;
+
+    /** @var ContextsFactory */
+    private $contextsFactory;
+
+    public function __construct($parameters) {
+        $this->server = $parameters['host'];
+        $this->documentLibrary = $parameters['documentLibrary'];
+
+        if(strpos($this->documentLibrary, '"') !== false) {
+            // they are, amongst others, not allowed and we use it in the filter
+            // cf. https://support.microsoft.com/en-us/kb/2933738
+            // TODO: verify, it talks about files and folders mostly
+            throw new \InvalidArgumentException('Illegal character in Document Library Name');
+        }
+
+        if(!isset($parameters['user']) || !isset($parameters['password'])) {
+            throw new \UnexpectedValueException('No user or password given');
+        }
+        $this->authUser = $parameters['user'];
+        $this->authPwd  = $parameters['password'];
+
+        $this->fixDI($parameters);
+    }
+
+    /**
+     * Get the identifier for the storage,
+     * the returned id should be the same for every storage object that is created with the same parameters
+     * and two storage objects with the same id should refer to two storages that display the same files.
+     *
+     * @return string
+     * @since 6.0.0
+     */
+    public function getId() {
+        return 'SharePoint::' . $this->server . '::' . $this->documentLibrary . '::' . $this->authUser;
+    }
+
+    /**
+     * see http://php.net/manual/en/function.mkdir.php
+     * implementations need to implement a recursive mkdir
+     *
+     * @param string $path
+     * @return bool
+     * @since 6.0.0
+     */
+    public function mkdir($path) {
+        $serverUrl = $this->formatPath($path);
+        try {
+            $folder = $this->spClient->createFolder($serverUrl);
+            $this->fileCache->set($serverUrl, [
+                'instance' => $folder,
+                'children' => [
+                    'folders' => $folder->getFolders(),
+                    'files' => $folder->getFiles()
+                ]
+            ]);
+            return true;
+        } catch (\Exception $e) {
+            $this->fileCache->remove($serverUrl);
+            return false;
+        }
+    }
+
+    /**
+     * see http://php.net/manual/en/function.rmdir.php
+     *
+     * @param string $path
+     * @return bool
+     * @since 6.0.0
+     */
+    public function rmdir($path) {
+        $serverUrl = $this->formatPath($path);
+        try {
+            $cacheEntry = $this->fileCache->get($serverUrl);
+            $folder = null;
+            if(is_array($cacheEntry) && isset($cacheEntry['instance'])) {
+                $folder = $cacheEntry['instance'];
+            }
+            $this->spClient->deleteFolder($serverUrl, $folder);
+            $this->fileCache->set($serverUrl, false);
+            return true;
+        } catch (\Exception $e) {
+            $this->fileCache->remove($serverUrl);
+            return false;
+        }
+    }
+
+    /**
+     * see http://php.net/manual/en/function.opendir.php
+     *
+     * @param string $path
+     * @return resource|false
+     * @since 6.0.0
+     */
+    public function opendir($path) {
+        try {
+            $serverUrl = $this->formatPath($path);
+            //$collections = $this->spClient->fetchFolderContents($serverUrl, ['Name', 'ListItemAllFields']);	// does not work for some reason :(
+            $collections = $this->getFolderContents($serverUrl);
+            $files = [];
+
+            foreach ($collections as $collection) {
+                /** @var File[]|Folder[] $items */
+                $items = $collection->getData();
+                foreach ($items as $item) {
+                    /** @var ListItem $fields */
+                    if(!$this->spClient->isHidden($item)) {
+                        $files[] = $item->getProperty('Name');
+                    }
+                }
+            }
+
+            return IteratorDirectory::wrap($files);
+        } catch (NotFoundException $e) {
+            return false;
+        }
+    }
+
+    /**
+     * see http://php.net/manual/en/function.stat.php
+     * only the following keys are required in the result: size and mtime
+     *
+     * @param string $path
+     * @return array|false
+     * @since 6.0.0
+     */
+    public function stat($path) {
+        $serverUrl = $this->formatPath($path);
+        try {
+            $file = $this->getFileOrFolder($serverUrl);
+        } catch (\Exception $e) {
+            return false;
+        }
+
+        $size = $file->getProperty(self::SP_PROPERTY_SIZE) ?: FileInfo::SPACE_UNKNOWN;
+        $mtimeValue = $file->getProperty(self::SP_PROPERTY_MTIME);
+        $mtime = $mtimeValue ? new \DateTime($mtimeValue) : null;
+
+        $stat = [
+            // int64, size in bytes, excluding the size of any Web Parts that are used in the file.
+            'size'  => $size,
+            'mtime' => $mtime->getTimestamp(),
+            // no property in SP 2013 & 2016, other storages do the same  :speak_no_evil:
+            'atime' => time(),
+        ];
+
+        if(!is_null($stat['mtime'])) {
+            return $stat;
+        }
+
+        // If we do not get a mtime from SP, we treat it as an error
+        // thus returning false, according to PHP documentation on stat()
+        return false;
+    }
+
+    /**
+     * see http://php.net/manual/en/function.filetype.php
+     *
+     * @param string $path
+     * @return false|string
+     * @throws \Exception
+     * @since 6.0.0
+     */
+    public function filetype($path) {
+        try {
+            $serverUrl = $this->formatPath($path);
+            $object = $this->getFileOrFolder($serverUrl);
+        } catch (NotFoundException $e) {
+            return false;
+        }
+        if($object instanceof File) {
+            return 'file';
+        } else if($object instanceof Folder) {
+            return 'dir';
+        } else {
+            return false;
+        }
+    }
+
+    /**
+     * see http://php.net/manual/en/function.file_exists.php
+     *
+     * @param string $path
+     * @return bool
+     * @since 6.0.0
+     */
+    public function file_exists($path) {
+        try {
+            $serverUrl = $this->formatPath($path);
+            // alternative approach is to use a CAML query instead of querying
+            // for file and folder. It is not necessarily faster, though.
+            // Would need evaluation of typical use cases (I assume most often
+            // existing files are checked) and measurements.
+            $this->getFileOrFolder($serverUrl);
+            return true;
+        } catch (NotFoundException $e) {
+            return false;
+        }
+    }
+
+    /**
+     * see http://php.net/manual/en/function.unlink.php
+     *
+     * @param string $path
+     * @return bool
+     * @since 6.0.0
+     */
+    public function unlink($path) {
+        //  FIXME:: all is totally wrong
+        $path = trim($path);
+        if($path === '/' || $path === '') {
+            return false;
+        }
+        foreach([true, false] as $asFile) {
+            try {
+                $fsObject = $this->spClient->fetchFileOrFolder($path, $asFile);
+                $fsObject->deleteObject();
+                return true;
+            } catch(\Exception $e) {
+                // NOOP
+            }
+        }
+        return false;
+    }
+
+    /**
+     * see http://php.net/manual/en/function.fopen.php
+     *
+     * @param string $path
+     * @param string $mode
+     * @return resource|false
+     * @since 6.0.0
+     */
+    public function fopen($path, $mode) {
+        // TODO: Implement fopen() method.
+        return false;
+    }
+
+    /**
+     * see http://php.net/manual/en/function.touch.php
+     * If the backend does not support the operation, false should be returned
+     *
+     * @param string $path
+     * @param int $mtime
+     * @return bool
+     * @since 6.0.0
+     */
+    public function touch($path, $mtime = null) {
+        // TODO: Implement touch() method.
+        return true;
+    }
+
+
+    /**
+     * work around dependency injection issues so we can test this class properly
+     *
+     * @param array $parameters
+     */
+    private function fixDI(array $parameters) {
+        if(isset($parameters['contextFactory'])
+            && $parameters['contextFactory'] instanceof ContextsFactory)
+        {
+            $this->contextsFactory = $parameters['contextFactory'];
+        } else {
+            $this->contextsFactory = new ContextsFactory();
+        }
+
+        if(isset($parameters['sharePointClientFactory'])
+            && $parameters['sharePointClientFactory'] instanceof SharePointClientFactory)
+        {
+            $spcFactory = $parameters['sharePointClientFactory'];
+        } else {
+            $spcFactory = new SharePointClientFactory();
+        }
+        $this->spClient = $spcFactory->getClient(
+            $this->contextsFactory,
+            $this->server,
+            [ 'user' => $this->authUser, 'password' => $this->authPwd],
+            $this->documentLibrary
+        );
+
+        if(isset($parameters['cappedMemoryCache'])) {
+            $this->fileCache = $parameters['cappedMemoryCache'];
+        } else {
+            $this->fileCache = new CappedMemoryCache('256');
+        }
+    }
+
+    /**
+     * @param $serverUrl
+     * @return ClientObjectCollection[]
+     */
+    private function getFolderContents($serverUrl) {
+        $entry = $this->fileCache->get($serverUrl);
+        if($entry === null || !isset($entry['children'])) {
+            $folder = isset($entry['instance']) ? $entry['instance'] : null;
+            $contents = $this->spClient->fetchFolderContents($serverUrl, null, $folder);
+            $cacheItem = $entry ?: [];
+            $cacheItem['children'] = $contents;
+            $this->fileCache->set($serverUrl, $cacheItem);
+
+            // cache children instances
+            foreach ($contents as $collection) {
+                foreach ($collection->getData() as $item) {
+                    /** @var  File|Folder $item */
+                    $url = $item->getProperty(self::SP_PROPERTY_URL);
+                    $itemEntry = $this->fileCache->get($url);
+                    $itemEntry = $itemEntry ?: [];
+                    if(!isset($itemEntry['instance'])) {
+                        $itemEntry['instance'] = $item;
+                        $this->fileCache->set($url, $itemEntry);
+                    }
+                }
+            }
+        } else {
+            $contents = $entry['children'];
+        }
+        return $contents;
+    }
+
+    /**
+     * @param $serverUrl
+     * @return File|Folder
+     * @throws NotFoundException
+     */
+    private function getFileOrFolder($serverUrl) {
+        $entry = $this->fileCache->get($serverUrl);
+        if($entry === false) {
+            throw new NotFoundException('File or Folder not found');
+        } else if($entry === null || !isset($entry['instance'])) {
+            try {
+                $file = $this->spClient->fetchFileOrFolder($serverUrl, [self::SP_PROPERTY_SIZE, self::SP_PROPERTY_MTIME]);
+            } catch (NotFoundException $e) {
+                $this->fileCache->set($serverUrl, false);
+                throw $e;
+            }
+            $cacheItem = $entry ?: [];
+            $cacheItem['instance'] = $file;
+            $this->fileCache->set($serverUrl, $cacheItem);
+        } else {
+            $file = $entry['instance'];
+        }
+        return $file;
+    }
+
+    /**
+     * creates the relative server "url" out of the provided path
+     *
+     * @param $path
+     * @return string
+     */
+    private function formatPath($path) {
+        $path = trim($path, '/');
+        $serverUrl = '/' . $this->documentLibrary;
+        if($path !== '') {
+            $serverUrl .= '/' . $path;
+        }
+
+        $pathParts = explode('/', $serverUrl);
+        $filename = array_pop($pathParts);
+        if($filename === '.') {
+            // remove /. from the end of the path
+            $serverUrl = mb_substr($serverUrl, 0, mb_strlen($serverUrl) - 2);
+        }
+
+        return $serverUrl;
+    }
 
 }

apps/files_external/lib/Lib/SharePoint/SharePointClient.php

Indentation +219 added lines, -219 removed lines

@@ -32,223 +32,223 @@
 use Office365\PHP\Client\SharePoint\SPList;
 
 class SharePointClient {
-	/** @var  ClientContext */
-	protected $context;
-
-	/** @var  AuthenticationContext */
-	protected $authContext;
-
-	/** @var  SPList */
-	protected $documentLibrary;
-
-	/** @var ContextsFactory */
-	private $contextsFactory;
-
-	/** @var  string */
-	private $sharePointUrl;
-
-	/** @var string[] */
-	private $credentials;
-
-	/** @var  string */
-	private $documentLibraryTitle;
-
-	public function __construct(ContextsFactory $contextsFactory, $sharePointUrl, array $credentials, $documentLibraryTitle) {
-		$this->contextsFactory = $contextsFactory;
-		$this->sharePointUrl = $sharePointUrl;
-		$this->credentials = $credentials;
-		$this->documentLibraryTitle = $documentLibraryTitle;
-	}
-
-	/**
-	 * @param string $path
-	 * @param array $properties
-	 * @return File|Folder
-	 * @throws \Exception
-	 */
-	public function fetchFileOrFolder($path, array $properties = null) {
-		$fetchFileFunc = function ($path, $props) { return $this->fetchFile($path, $props);};
-		$fetchFolderFunc = function ($path, $props) { return $this->fetchFolder($path, $props);};
-		$fetchers = [ $fetchFileFunc, $fetchFolderFunc ];
-		if(strpos($path, '.') === false) {
-			$fetchers = array_reverse($fetchers);
-		}
-
-		foreach ($fetchers as $fetchFunction) {
-			try {
-				$instance = call_user_func_array($fetchFunction, [$path, $properties]);
-				return $instance;
-			} catch (\Exception $e) {
-				if(preg_match('/^The file \/.* does not exist\.$/', $e->getMessage()) !== 1
-					&& $e->getMessage() !== 'Unknown Error'
-					&& $e->getMessage() !== 'File Not Found.'
-				) {
-					$this->createClientContext();
-					# Unexpected Exception, pass it on
-					throw $e;
-				}
-			}
-			$this->createClientContext();
-		}
-
-		# Nothing succeeded, quit with not found
-		throw new NotFoundException('File or Folder not found');
-	}
-
-	public function fetchFile($relativeServerPath, array $properties = null) {
-		$this->ensureConnection();
-		$file = $this->context->getWeb()->getFileByServerRelativeUrl($relativeServerPath);
-		$this->loadAndExecute($file, $properties);
-		return $file;
-	}
-
-	public function fetchFolder($relativeServerPath, array $properties = null) {
-		$this->ensureConnection();
-		$folder = $this->context->getWeb()->getFolderByServerRelativeUrl($relativeServerPath);
-		$this->loadAndExecute($folder, $properties);
-		return $folder;
-	}
-
-	/**
-	 * adds a folder on the given server path
-	 *
-	 * @param string $relativeServerPath
-	 * @throws \Exception
-	 */
-	public function createFolder($relativeServerPath) {
-		$this->ensureConnection();
-
-		$serverUrlParts = explode('/', $relativeServerPath);
-		$newFolderName = array_pop($serverUrlParts);
-		$parentUrl =  implode('/', $serverUrlParts);
-
-		$parentFolder = $this->context->getWeb()->getFolderByServerRelativeUrl($parentUrl);
-		$folder = $parentFolder->getFolders()->add($newFolderName);
-
-		try {
-			$this->context->executeQuery();
-			return $folder;
-		} catch (\Exception $e) {
-			$this->createClientContext();
-			throw $e;
-		}
-	}
-
-	public function deleteFolder($relativeServerPath, Folder $folder = null) {
-		$this->ensureConnection();
-
-		try {
-			if($folder === null) {
-				$folder = $this->context->getWeb()->getFolderByServerRelativeUrl($relativeServerPath);
-			}
-			$folder->deleteObject();
-			$this->context->executeQuery();
-		} catch (\Exception $e) {
-			$this->createClientContext();
-			throw $e;
-		}
-	}
-
-	/**
-	 * @param $relativeServerPath
-	 * @param null $properties
-	 * @param Folder $folder
-	 * @return ClientObjectCollection[]
-	 */
-	public function fetchFolderContents($relativeServerPath, $properties = null, Folder $folder = null) {
-		$this->ensureConnection();
-		if($folder === null) {
-			$folder = $this->context->getWeb()->getFolderByServerRelativeUrl($relativeServerPath);
-		}
-
-		$folderCollection = $folder->getFolders();
-		$fileCollection = $folder->getFiles();
-		$this->context->load($folderCollection, $properties);
-		$this->context->load($fileCollection, $properties);
-		$this->context->executeQuery();
-
-		$collections = ['folders' => $folderCollection, 'files' => $fileCollection];
-
-		return $collections;
-	}
-
-	public function isHidden(ClientObject $file) {
-		// ClientObject itself does not have getListItemAllFields but is
-		// the common denominator of File and Folder
-		if(!$file instanceof File && !$file instanceof Folder) {
-			throw new \InvalidArgumentException('File or Folder expected');
-		}
-		if($file instanceof File) {
-			// it's expensive, we only check folders
-			return false;
-		}
-		$fields = $file->getListItemAllFields();
-		if($fields->getProperties() === []) {
-			$this->loadAndExecute($fields, ['Id', 'Hidden']);
-		}
-		$id = $fields->getProperty('Id');
-		$hidden = $fields->getProperty('Hidden'); // TODO: get someone to test this in SP 2013
-		if($hidden === false || $id !== null) {
-			// avoids listing hidden "Forms" folder (and its contents).
-			// Have not found a different mechanism to detect whether
-			// a file or folder is hidden. There used to be a Hidden
-			// field, but seems to have gone (since SP 2016?).
-			return false;
-		}
-		return true;
-	}
-
-	public function loadAndExecute(ClientObject $object, array $properties = null) {
-		$this->context->load($object, $properties);
-		$this->context->executeQuery();
-	}
-
-	/**
-	 * @return SPList
-	 * @throws NotFoundException
-	 */
-	private function getDocumentLibrary() {
-		if(!is_null($this->documentLibrary)) {
-			return $this->documentLibrary;
-		}
-
-		$lists = $this->context->getWeb()->getLists()->filter('Title eq \'' . $this->documentLibraryTitle . '\'')->top(1);
-		$this->context->load($lists)->executeQuery();
-		if ($lists->getCount() === 1 && $lists->getData()[0] instanceof SPList) {
-			$this->documentLibrary = $lists->getData()[0];
-			return $this->documentLibrary;
-		}
-
-		throw new NotFoundException('List not found');
-	}
-
-	/**
-	 * Set up necessary contexts for authentication and access to SharePoint
-	 *
-	 * @throws \InvalidArgumentException
-	 */
-	private function ensureConnection() {
-		if($this->context instanceof ClientContext) {
-			return;
-		}
-
-		if(!is_string($this->credentials['user']) || empty($this->credentials['user'])) {
-			throw new \InvalidArgumentException('No user given');
-		}
-		if(!is_string($this->credentials['password']) || empty($this->credentials['password'])) {
-			throw new \InvalidArgumentException('No password given');
-		}
-		$this->authContext = $this->contextsFactory->getAuthContext($this->credentials['user'], $this->credentials['password']);
-		$this->authContext->AuthType = CURLAUTH_NTLM;		# Basic auth does not work somehow…
-		$this->createClientContext();
-		# Auth is not triggered yet. This will happen when something is requested from SharePoint (on demand), e.g.:
-	}
-
-	/**
-	 * (re)creates the sharepoint client context
-	 */
-	private function createClientContext() {
-		$this->context = null;
-		$this->context = $this->contextsFactory->getClientContext($this->sharePointUrl, $this->authContext);
-	}
+    /** @var  ClientContext */
+    protected $context;
+
+    /** @var  AuthenticationContext */
+    protected $authContext;
+
+    /** @var  SPList */
+    protected $documentLibrary;
+
+    /** @var ContextsFactory */
+    private $contextsFactory;
+
+    /** @var  string */
+    private $sharePointUrl;
+
+    /** @var string[] */
+    private $credentials;
+
+    /** @var  string */
+    private $documentLibraryTitle;
+
+    public function __construct(ContextsFactory $contextsFactory, $sharePointUrl, array $credentials, $documentLibraryTitle) {
+        $this->contextsFactory = $contextsFactory;
+        $this->sharePointUrl = $sharePointUrl;
+        $this->credentials = $credentials;
+        $this->documentLibraryTitle = $documentLibraryTitle;
+    }
+
+    /**
+     * @param string $path
+     * @param array $properties
+     * @return File|Folder
+     * @throws \Exception
+     */
+    public function fetchFileOrFolder($path, array $properties = null) {
+        $fetchFileFunc = function ($path, $props) { return $this->fetchFile($path, $props);};
+        $fetchFolderFunc = function ($path, $props) { return $this->fetchFolder($path, $props);};
+        $fetchers = [ $fetchFileFunc, $fetchFolderFunc ];
+        if(strpos($path, '.') === false) {
+            $fetchers = array_reverse($fetchers);
+        }
+
+        foreach ($fetchers as $fetchFunction) {
+            try {
+                $instance = call_user_func_array($fetchFunction, [$path, $properties]);
+                return $instance;
+            } catch (\Exception $e) {
+                if(preg_match('/^The file \/.* does not exist\.$/', $e->getMessage()) !== 1
+                    && $e->getMessage() !== 'Unknown Error'
+                    && $e->getMessage() !== 'File Not Found.'
+                ) {
+                    $this->createClientContext();
+                    # Unexpected Exception, pass it on
+                    throw $e;
+                }
+            }
+            $this->createClientContext();
+        }
+
+        # Nothing succeeded, quit with not found
+        throw new NotFoundException('File or Folder not found');
+    }
+
+    public function fetchFile($relativeServerPath, array $properties = null) {
+        $this->ensureConnection();
+        $file = $this->context->getWeb()->getFileByServerRelativeUrl($relativeServerPath);
+        $this->loadAndExecute($file, $properties);
+        return $file;
+    }
+
+    public function fetchFolder($relativeServerPath, array $properties = null) {
+        $this->ensureConnection();
+        $folder = $this->context->getWeb()->getFolderByServerRelativeUrl($relativeServerPath);
+        $this->loadAndExecute($folder, $properties);
+        return $folder;
+    }
+
+    /**
+     * adds a folder on the given server path
+     *
+     * @param string $relativeServerPath
+     * @throws \Exception
+     */
+    public function createFolder($relativeServerPath) {
+        $this->ensureConnection();
+
+        $serverUrlParts = explode('/', $relativeServerPath);
+        $newFolderName = array_pop($serverUrlParts);
+        $parentUrl =  implode('/', $serverUrlParts);
+
+        $parentFolder = $this->context->getWeb()->getFolderByServerRelativeUrl($parentUrl);
+        $folder = $parentFolder->getFolders()->add($newFolderName);
+
+        try {
+            $this->context->executeQuery();
+            return $folder;
+        } catch (\Exception $e) {
+            $this->createClientContext();
+            throw $e;
+        }
+    }
+
+    public function deleteFolder($relativeServerPath, Folder $folder = null) {
+        $this->ensureConnection();
+
+        try {
+            if($folder === null) {
+                $folder = $this->context->getWeb()->getFolderByServerRelativeUrl($relativeServerPath);
+            }
+            $folder->deleteObject();
+            $this->context->executeQuery();
+        } catch (\Exception $e) {
+            $this->createClientContext();
+            throw $e;
+        }
+    }
+
+    /**
+     * @param $relativeServerPath
+     * @param null $properties
+     * @param Folder $folder
+     * @return ClientObjectCollection[]
+     */
+    public function fetchFolderContents($relativeServerPath, $properties = null, Folder $folder = null) {
+        $this->ensureConnection();
+        if($folder === null) {
+            $folder = $this->context->getWeb()->getFolderByServerRelativeUrl($relativeServerPath);
+        }
+
+        $folderCollection = $folder->getFolders();
+        $fileCollection = $folder->getFiles();
+        $this->context->load($folderCollection, $properties);
+        $this->context->load($fileCollection, $properties);
+        $this->context->executeQuery();
+
+        $collections = ['folders' => $folderCollection, 'files' => $fileCollection];
+
+        return $collections;
+    }
+
+    public function isHidden(ClientObject $file) {
+        // ClientObject itself does not have getListItemAllFields but is
+        // the common denominator of File and Folder
+        if(!$file instanceof File && !$file instanceof Folder) {
+            throw new \InvalidArgumentException('File or Folder expected');
+        }
+        if($file instanceof File) {
+            // it's expensive, we only check folders
+            return false;
+        }
+        $fields = $file->getListItemAllFields();
+        if($fields->getProperties() === []) {
+            $this->loadAndExecute($fields, ['Id', 'Hidden']);
+        }
+        $id = $fields->getProperty('Id');
+        $hidden = $fields->getProperty('Hidden'); // TODO: get someone to test this in SP 2013
+        if($hidden === false || $id !== null) {
+            // avoids listing hidden "Forms" folder (and its contents).
+            // Have not found a different mechanism to detect whether
+            // a file or folder is hidden. There used to be a Hidden
+            // field, but seems to have gone (since SP 2016?).
+            return false;
+        }
+        return true;
+    }
+
+    public function loadAndExecute(ClientObject $object, array $properties = null) {
+        $this->context->load($object, $properties);
+        $this->context->executeQuery();
+    }
+
+    /**
+     * @return SPList
+     * @throws NotFoundException
+     */
+    private function getDocumentLibrary() {
+        if(!is_null($this->documentLibrary)) {
+            return $this->documentLibrary;
+        }
+
+        $lists = $this->context->getWeb()->getLists()->filter('Title eq \'' . $this->documentLibraryTitle . '\'')->top(1);
+        $this->context->load($lists)->executeQuery();
+        if ($lists->getCount() === 1 && $lists->getData()[0] instanceof SPList) {
+            $this->documentLibrary = $lists->getData()[0];
+            return $this->documentLibrary;
+        }
+
+        throw new NotFoundException('List not found');
+    }
+
+    /**
+     * Set up necessary contexts for authentication and access to SharePoint
+     *
+     * @throws \InvalidArgumentException
+     */
+    private function ensureConnection() {
+        if($this->context instanceof ClientContext) {
+            return;
+        }
+
+        if(!is_string($this->credentials['user']) || empty($this->credentials['user'])) {
+            throw new \InvalidArgumentException('No user given');
+        }
+        if(!is_string($this->credentials['password']) || empty($this->credentials['password'])) {
+            throw new \InvalidArgumentException('No password given');
+        }
+        $this->authContext = $this->contextsFactory->getAuthContext($this->credentials['user'], $this->credentials['password']);
+        $this->authContext->AuthType = CURLAUTH_NTLM;		# Basic auth does not work somehow…
+        $this->createClientContext();
+        # Auth is not triggered yet. This will happen when something is requested from SharePoint (on demand), e.g.:
+    }
+
+    /**
+     * (re)creates the sharepoint client context
+     */
+    private function createClientContext() {
+        $this->context = null;
+        $this->context = $this->contextsFactory->getClientContext($this->sharePointUrl, $this->authContext);
+    }
 }