FileSystem: Add method makeWritable() (#244)

Author: janbarasek

src/Utils/FileSystem.php

@@ -148,6 +148,29 @@ public static function write(string $file, string $content, ?int $mode = 0666):
 	}
 
 
+	/**
+	 * Fixes permissions to a specific file or directory. Directories can be fixed recursively.
+	 * @throws Nette\IOException  on error occurred
+	 */
+	public static function makeWritable(string $path, int $dirMode = 0777, int $fileMode = 0666): void
+	{
+		if (is_file($path)) {
+			if (!@chmod($path, $fileMode)) { // @ is escalated to exception
+				throw new Nette\IOException("Unable to chmod file '$path' to mode " . decoct($fileMode) . '. ' . Helpers::getLastError());
+			}
+		} elseif (is_dir($path)) {
+			foreach (new \FilesystemIterator($path) as $item) {
+				static::makeWritable($item->getPathname(), $dirMode, $fileMode);
+			}
+			if (!@chmod($path, $dirMode)) { // @ is escalated to exception
+				throw new Nette\IOException("Unable to chmod directory '$path' to mode " . decoct($dirMode) . '. ' . Helpers::getLastError());
+			}
+		} else {
+			throw new Nette\IOException("File or directory '$path' not found.");
+		}
+	}
+
+
 	/**
 	 * Determines if the path is absolute.
 	 */

tests/Utils/FileSystem.phpt

@@ -165,3 +165,24 @@ test('isAbsolute', function () {
 	Assert::true(FileSystem::isAbsolute('http://file'));
 	Assert::true(FileSystem::isAbsolute('remote://file'));
 });
+
+
+if (!defined('PHP_WINDOWS_VERSION_BUILD')) {
+	test('makeWritable', function () {
+		FileSystem::createDir(getTempDir() . '/12/x');
+		FileSystem::write(getTempDir() . '/12/x/file', 'Hello');
+		chmod(getTempDir() . '/12/x/file', 0444);
+		chmod(getTempDir() . '/12/x', 0555);
+		chmod(getTempDir() . '/12', 0555);
+
+		FileSystem::makeWritable(getTempDir() . '/12');
+
+		Assert::same(0777, fileperms(getTempDir() . '/12') & 0777);
+		Assert::same(0777, fileperms(getTempDir() . '/12/x') & 0777);
+		Assert::same(0666, fileperms(getTempDir() . '/12/x/file') & 0777);
+	});
+}
+
+Assert::exception(function () {
+	FileSystem::makeWritable(getTempDir() . '/13');
+}, Nette\IOException::class, "File or directory '%S%' not found.");