first commit

wp-content/plugins/updraftplus/includes/onedrive/folder.php

@@ -0,0 +1,68 @@
+<?php
+namespace Onedrive;
+
+/*
+ * A Folder instance is an Object instance referencing to a OneDrive folder. It
+ * may contain other OneDrive objects but may not have content.
+ */
+class Folder extends Instance {
+	/**
+	 * Determines whether the OneDrive object referenced by this Object instance
+	 * is a folder.
+	 *
+	 * @return (bool) true if the OneDrive object referenced by this Object
+	 *         instance is a folder, false otherwise.
+	 */
+	public function isFolder() {
+		return true;
+	}
+
+	/**
+	 * Constructor.
+	 *
+	 * @param  (Client) $client - The Client instance owning this Object instance.
+	 * @param  (null|string) $id - The unique ID of the OneDrive object referenced
+	 *         by this Object instance, or null to reference the OneDrive root
+	 *         folder. Default: null.
+	 * @param  (array|object) $options.
+	 */
+	public function __construct(Client $client, $id = null, $options = array()) {
+		parent::__construct($client, $id, $options);
+	}
+
+	/**
+	 * Gets the objects in the OneDrive folder referenced by this Folder instance.
+	 *
+	 * @return (array) The objects in the OneDrive folder referenced by this
+	 *         Folder instance, as Object instances.
+	 */
+	public function fetchObjects() {
+		return $this->_client->fetchObjects($this->_id);
+	}
+
+	/**
+	 * Creates a folder in the OneDrive folder referenced by this Folder instance.
+	 *
+	 * @param  (string) $name - The name of the OneDrive folder to be created.
+	 * @param  (null|string) $description - The description of the OneDrive folder
+	 *         to be created, or null to create it without a description. Default:
+	 *         null.
+	 * @return (Folder) The folder created, as a Folder instance.
+	 */
+	public function createFolder($name, $description = null) {
+		return $this->_client->createFolder($name, $this->_id, $description);
+	}
+
+	/**
+	 * Creates a file in the OneDrive folder referenced by this Folder instance.
+	 *
+	 * @param  (string) $name - The name of the OneDrive file to be created.
+	 * @param  (string) $content - The content of the OneDrive file to be created.
+	 *         Default: ''.
+	 * @return (File) The file created, as a File instance.
+	 * @throw  (\Exception) Thrown on I/O errors.
+	 */
+	public function createFile($name, $content = '') {
+		return $this->_client->createFile($name, $this->_id, $content);
+	}
+}