WebSVN – lars-tiefland.laravel_shop – Diff – /trunk/vendor/nette/utils/src/Utils/FileSystem.php

 final class FileSystem
+{
 	use Nette\StaticClass;
 	/**
-	 * Creates a directory if it doesn't exist.
+	 * Creates a directory if it does not exist, including parent directories.
 	 * @throws Nette\IOException  on error occurred
 	 */
 	public static function createDir(string $dir, int $mode = 0777): void
+	{
 		if (!is_dir($dir) && !@mkdir($dir, $mode, true) && !is_dir($dir)) { // @ - dir may already exist
 			throw new Nette\IOException(sprintf(
 				"Unable to create directory '%s' with mode %s. %s",
 				self::normalizePath($dir),
 				decoct($mode),
-				Helpers::getLastError()
+				Helpers::getLastError(),
 			));
+		}
+	}
 	/**
-	 * Copies a file or a directory. Overwrites existing files and directories by default.
+	 * Copies a file or an entire directory. Overwrites existing files and directories by default.
 	 * @throws Nette\IOException  on error occurred
 	 * @throws Nette\InvalidStateException  if $overwrite is set to false and destination already exists
 					static::copy($item->getPathname(), $target . '/' . $iterator->getSubPathName());
+				}
+			}
 		} else {
 			static::createDir(dirname($target));
-			if (
-				($s = @fopen($origin, 'rb'))
-				&& ($d = @fopen($target, 'wb'))
-				&& @stream_copy_to_stream($s, $d) === false
+			if (@stream_copy_to_stream(static::open($origin, 'rb'), static::open($target, 'wb')) === false) { // @ is escalated to exception
-			) { // @ is escalated to exception
 				throw new Nette\IOException(sprintf(
 					"Unable to copy file '%s' to '%s'. %s",
 					self::normalizePath($origin),
 					self::normalizePath($target),
-					Helpers::getLastError()
+					Helpers::getLastError(),
 				));
+			}
+		}
+	}
+	/**
+	 * Opens file and returns resource.
+	 * @return resource
+	 * @throws Nette\IOException  on error occurred
+	 */
+	public static function open(string $path, string $mode)
+	{
+		$f = @fopen($path, $mode); // @ is escalated to exception
+		if (!$f) {
+			throw new Nette\IOException(sprintf(
+				"Unable to open file '%s'. %s",
+				self::normalizePath($path),
+				Helpers::getLastError(),
+			));
+		}
+		return $f;
+	}
 	/**
-	 * Deletes a file or directory if exists.
+	 * Deletes a file or an entire directory if exists. If the directory is not empty, it deletes its contents first.
 	 * @throws Nette\IOException  on error occurred
 	 */
 	public static function delete(string $path): void
+	{
 		if (is_file($path) || is_link($path)) {
 			$func = DIRECTORY_SEPARATOR === '\\' && is_dir($path) ? 'rmdir' : 'unlink';
 			if (!@$func($path)) { // @ is escalated to exception
 				throw new Nette\IOException(sprintf(
 					"Unable to delete '%s'. %s",
 					self::normalizePath($path),
-					Helpers::getLastError()
+					Helpers::getLastError(),
 				));
+			}
 		} elseif (is_dir($path)) {
 			if (!@rmdir($path)) { // @ is escalated to exception
 				throw new Nette\IOException(sprintf(
 					"Unable to delete directory '%s'. %s",
 					self::normalizePath($path),
-					Helpers::getLastError()
+					Helpers::getLastError(),
 				));
+			}
+		}
 			if (!@rename($origin, $target)) { // @ is escalated to exception
 				throw new Nette\IOException(sprintf(
 					"Unable to rename file or directory '%s' to '%s'. %s",
 					self::normalizePath($origin),
 					self::normalizePath($target),
-					Helpers::getLastError()
+					Helpers::getLastError(),
 				));
+			}
+		}
+	}
 		$content = @file_get_contents($file); // @ is escalated to exception
 		if ($content === false) {
 			throw new Nette\IOException(sprintf(
 				"Unable to read file '%s'. %s",
 				self::normalizePath($file),
-				Helpers::getLastError()
+				Helpers::getLastError(),
 			));
+		}
 		return $content;
+	}
+	/**
+	 * Reads the file content line by line. Because it reads continuously as we iterate over the lines,
+	 * it is possible to read files larger than the available memory.
+	 * @return \Generator<int, string>
+	 * @throws Nette\IOException  on error occurred
+	 */
+	public static function readLines(string $file, bool $stripNewLines = true): \Generator
+	{
+		return (function ($f) use ($file, $stripNewLines) {
+			$counter = 0;
+			do {
+				$line = Callback::invokeSafe('fgets', [$f], fn($error) => throw new Nette\IOException(sprintf(
+					"Unable to read file '%s'. %s",
+					self::normalizePath($file),
+					$error,
+				)));
+				if ($line === false) {
+					fclose($f);
+					break;
+				}
+				if ($stripNewLines) {
+					$line = rtrim($line, "\r\n");
+				}
+				yield $counter++ => $line;
+			} while (true);
+		})(static::open($file, 'r'));
+	}
 	/**
 	 * Writes the string to a file.
 	 * @throws Nette\IOException  on error occurred
 	 */
 	public static function write(string $file, string $content, ?int $mode = 0666): void
+	{
 		static::createDir(dirname($file));
 		if (@file_put_contents($file, $content) === false) { // @ is escalated to exception
 			throw new Nette\IOException(sprintf(
 				"Unable to write file '%s'. %s",
 				self::normalizePath($file),
-				Helpers::getLastError()
+				Helpers::getLastError(),
 			));
+		}
 		if ($mode !== null && !@chmod($file, $mode)) { // @ is escalated to exception
 			throw new Nette\IOException(sprintf(
 				"Unable to chmod file '%s' to mode %s. %s",
 				self::normalizePath($file),
 				decoct($mode),
-				Helpers::getLastError()
+				Helpers::getLastError(),
 			));
+		}
+	}
 	/**
-	/**
+	 * Sets file permissions to `$fileMode` or directory permissions to `$dirMode`.
-	 * Fixes permissions to a specific file or directory. Directories can be fixed recursively.
+	 * Recursively traverses and sets permissions on the entire contents of the directory as well.
 	 * @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(sprintf(
 					"Unable to chmod file '%s' to mode %s. %s",
 					self::normalizePath($path),
 					decoct($fileMode),
 			if (!@chmod($path, $dirMode)) { // @ is escalated to exception
 				throw new Nette\IOException(sprintf(
 					"Unable to chmod directory '%s' to mode %s. %s",
 					self::normalizePath($path),
 					decoct($dirMode),
-					Helpers::getLastError()
+					Helpers::getLastError(),
 				));
+			}
 		} else {
 			throw new Nette\IOException(sprintf("File or directory '%s' not found.", self::normalizePath($path)));
+		}
 	 */
 	public static function joinPaths(string ...$paths): string
+	{
 		return self::normalizePath(implode('/', $paths));
+	}
+	/**
+	 * Converts backslashes to slashes.
+	 */
+	public static function unixSlashes(string $path): string
+	{
+		return strtr($path, '\\', '/');
+	}
+	/**
+	 * Converts slashes to platform-specific directory separators.
+	 */
+	public static function platformSlashes(string $path): string
+	{
+		return DIRECTORY_SEPARATOR === '/'
+			? strtr($path, '\\', '/')
+			: str_replace(':\\\\', '://', strtr($path, '/', '\\')); // protocol://
+	}
+}

Subversion-Projekte lars-tiefland.laravel_shop

(root)/trunk/vendor/nette/utils/src/Utils/FileSystem.php – Revision 148 → 399