add a seperate storage method to distinguish between 'path exists' and 'path is available'path-available

Signed-off-by: Robin Appelman <robin@icewind.nl>

1 files changed, 12 insertions, 0 deletions

diff --git a/lib/private/Files/Storage/Storage.php b/lib/private/Files/Storage/Storage.php
index 0a2511de164..040de66afe2 100644
--- a/lib/private/Files/Storage/Storage.php
+++ b/lib/private/Files/Storage/Storage.php
@@ -136,4 +136,16 @@ interface Storage extends \OCP\Files\Storage {
 	 * - permissions
 	 */
 	public function getDirectoryContent($directory): \Traversable;
+
+	/**
+	 * Check if a filepath is available/unused
+	 *
+	 * This is usually the inverse of `file_exists` but some filesystems might have additional restrictions for
+	 * which file names are available.
+	 * For example with case-insensitive filesystems where names that only differ by case would conflict.
+	 *
+	 * @param string $path
+	 * @return bool
+	 */
+	public function pathAvailable(string $path): bool;
 }