Mistralys / application-utils

src/FileHelper/SerializedFile.php

Spacing +1 added lines, -1 removed lines

@@ -50,7 +50,7 @@
             )
         );
 
-        if($result !== false) {
+        if ($result !== false) {
             return $result;
         }
 

src/FileHelper/CLICommandChecker.php

Spacing +4 added lines, -4 removed lines

@@ -59,7 +59,7 @@ 
     {
         $os = $this->getOS();
 
-        if(isset(self::$osCommands[$os]))
+        if (isset(self::$osCommands[$os]))
         {
             return self::$osCommands[$os];
         }
@@ -83,7 +83,7 @@ 
      */
     public function exists(string $command) : bool
     {
-        if(isset(self::$checked[$command]))
+        if (isset(self::$checked[$command]))
         {
             return self::$checked[$command];
         }
@@ -114,7 +114,7 @@ 
             $pipes
         );
 
-        if($process === false)
+        if ($process === false)
         {
             return '';
         }
@@ -126,7 +126,7 @@ 
 
         proc_close($process);
 
-        if($stdout === false)
+        if ($stdout === false)
         {
             return '';
         }

src/FileHelper/FileInfo.php

Braces +1 added lines, -2 removed lines

@@ -255,8 +255,7 @@
         if($this->exists())
         {
             $this->requireWritable();
-        }
-        else
+        } else
         {
             FolderInfo::factory(dirname($this->path))
                 ->create()

Spacing +19 added lines, -19 removed lines

@@ -66,7 +66,7 @@ 
         $pathString = AbstractPathInfo::type2string($path);
         $endingChar = $pathString[strlen($pathString) - 1];
 
-        if(empty($path)) {
+        if (empty($path)) {
             throw new FileHelper_Exception(
                 'Invalid',
                 '',
@@ -74,7 +74,7 @@ 
             );
         }
 
-        if($path instanceof FolderInfo || $endingChar === '/' || $endingChar === '\\')
+        if ($path instanceof FolderInfo || $endingChar === '/' || $endingChar === '\\')
         {
             throw new FileHelper_Exception(
                 'Cannot use a folder as a file',
@@ -88,12 +88,12 @@ 
 
         $key = $pathString.';'.static::class;
 
-        if(!isset(self::$infoCache[$key]))
+        if (!isset(self::$infoCache[$key]))
         {
             $class = static::class;
             $instance = new $class($pathString);
 
-            if(!$instance instanceof self) {
+            if (!$instance instanceof self) {
                 throw new FileHelper_Exception(
                     'Invalid class created',
                     sprintf(
@@ -128,7 +128,7 @@ 
     {
         $path = trim($path);
 
-        if(empty($path) || FolderInfo::is_dir($path))
+        if (empty($path) || FolderInfo::is_dir($path))
         {
             return false;
         }
@@ -136,9 +136,9 @@ 
         return is_file($path) || pathinfo($path, PATHINFO_EXTENSION) !== '';
     }
 
-    public function removeExtension(bool $keepPath=false) : string
+    public function removeExtension(bool $keepPath = false) : string
     {
-        if(!$keepPath)
+        if (!$keepPath)
         {
             return (string)pathinfo($this->getName(), PATHINFO_FILENAME);
         }
@@ -163,11 +163,11 @@ 
         return $this->removeExtension();
     }
 
-    public function getExtension(bool $lowercase=true) : string
+    public function getExtension(bool $lowercase = true) : string
     {
         $ext = (string)pathinfo($this->path, PATHINFO_EXTENSION);
 
-        if($lowercase)
+        if ($lowercase)
         {
             $ext = mb_strtolower($ext);
         }
@@ -188,12 +188,12 @@ 
      */
     public function delete() : FileInfo
     {
-        if(!$this->exists())
+        if (!$this->exists())
         {
             return $this;
         }
 
-        if(unlink($this->path))
+        if (unlink($this->path))
         {
             return $this;
         }
@@ -220,7 +220,7 @@ 
     {
         $target = $this->checkCopyPrerequisites($targetPath);
 
-        if(copy($this->path, (string)$target))
+        if (copy($this->path, (string)$target))
         {
             return $target;
         }
@@ -257,7 +257,7 @@ 
         $target = FileHelper::getPathInfo($targetPath);
 
         // It's a file? Then we can use it as-is.
-        if($target instanceof self) {
+        if ($target instanceof self) {
             return $target
                 ->requireIsFile()
                 ->createFolder();
@@ -267,7 +267,7 @@ 
         // but is not a folder: very likely a file without extension.
         // In this case we create an empty file to be able to return
         // a FileInfo instance.
-        if($target instanceof IndeterminatePath)
+        if ($target instanceof IndeterminatePath)
         {
             return $target->convertToFile();
         }
@@ -296,7 +296,7 @@ 
      */
     public function getLineReader() : LineReader
     {
-        if($this->lineReader === null)
+        if ($this->lineReader === null)
         {
             $this->lineReader = new LineReader($this);
         }
@@ -315,7 +315,7 @@ 
 
         $result = file_get_contents($this->getPath());
 
-        if($result !== false) {
+        if ($result !== false) {
             return $result;
         }
 
@@ -337,7 +337,7 @@ 
      */
     public function putContents(string $content) : FileInfo
     {
-        if($this->exists())
+        if ($this->exists())
         {
             $this->requireWritable();
         }
@@ -348,7 +348,7 @@ 
                 ->requireWritable();
         }
 
-        if(file_put_contents($this->path, $content) !== false)
+        if (file_put_contents($this->path, $content) !== false)
         {
             return $this;
         }
@@ -378,7 +378,7 @@ 
      */
     private function createFolder() : FileInfo
     {
-        if(!$this->exists())
+        if (!$this->exists())
         {
             FolderInfo::factory($this->getFolderPath())
                 ->create()

src/FileHelper/UnicodeHandling.php

Spacing +12 added lines, -12 removed lines

@@ -27,12 +27,12 @@ 
     /**
      * @var array<string,string>|NULL
      */
-    protected static ?array $utfBoms = null;
+    protected static ? array $utfBoms = null;
 
     /**
      * @var string[]|NULL
      */
-    protected static ?array $encodings = null;
+    protected static ? array $encodings = null;
 
     public function __construct()
     {
@@ -70,9 +70,9 @@ 
 
         fclose($fp);
 
-        foreach(self::$utfBoms as $bom => $value)
+        foreach (self::$utfBoms as $bom => $value)
         {
-            if(mb_strpos($text, $value) === 0)
+            if (mb_strpos($text, $value) === 0)
             {
                 return $bom;
             }
@@ -83,23 +83,23 @@ 
 
     private function initBOMs() : void
     {
-        if(isset(self::$utfBoms))
+        if (isset(self::$utfBoms))
         {
             return;
         }
 
         self::$utfBoms = array(
-            'UTF32-BE' => chr(0x00) . chr(0x00) . chr(0xFE) . chr(0xFF),
-            'UTF32-LE' => chr(0xFF) . chr(0xFE) . chr(0x00) . chr(0x00),
-            'UTF16-BE' => chr(0xFE) . chr(0xFF),
-            'UTF16-LE' => chr(0xFF) . chr(0xFE),
-            'UTF8' => chr(0xEF) . chr(0xBB) . chr(0xBF)
+            'UTF32-BE' => chr(0x00).chr(0x00).chr(0xFE).chr(0xFF),
+            'UTF32-LE' => chr(0xFF).chr(0xFE).chr(0x00).chr(0x00),
+            'UTF16-BE' => chr(0xFE).chr(0xFF),
+            'UTF16-LE' => chr(0xFF).chr(0xFE),
+            'UTF8' => chr(0xEF).chr(0xBB).chr(0xBF)
         );
     }
 
     private function initEncodings() : void
     {
-        if(isset(self::$encodings))
+        if (isset(self::$encodings))
         {
             return;
         }
@@ -108,7 +108,7 @@ 
 
         self::$encodings = array();
 
-        foreach($encodings as $string)
+        foreach ($encodings as $string)
         {
             $withHyphen = str_replace('UTF', 'UTF-', $string);
 

src/FileHelper/FileInfo/FileSender.php

Spacing +3 added lines, -3 removed lines

@@ -35,7 +35,7 @@ 
         $this->file = $info;
     }
 
-    public function send(?string $fileName = null, bool $asAttachment=true) : void
+    public function send(?string $fileName = null, bool $asAttachment = true) : void
     {
         $this->file
             ->requireExists()
@@ -53,7 +53,7 @@ 
     {
         header("Cache-Control: public", true);
         header("Content-Description: File Transfer", true);
-        header("Content-Type: " . $this->detectMime(), true);
+        header("Content-Type: ".$this->detectMime(), true);
 
         header(sprintf(
             "Content-Disposition: %s; filename=%s",
@@ -69,7 +69,7 @@ 
 
     private function resolveDisposition(bool $asAttachment) : string
     {
-        if($asAttachment)
+        if ($asAttachment)
         {
             return 'attachment';
         }

src/FileHelper/FileInfo/LineReader.php

Spacing +12 added lines, -12 removed lines

@@ -47,15 +47,15 @@ 
 
         $file = new SplFileObject($this->file->getPath());
 
-        if($file->eof()) {
+        if ($file->eof()) {
             return '';
         }
 
-        $targetLine = $lineNumber-1;
+        $targetLine = $lineNumber - 1;
 
         $file->seek($targetLine);
 
-        if($file->key() !== $targetLine)
+        if ($file->key() !== $targetLine)
         {
             return null;
         }
@@ -76,7 +76,7 @@ 
         $number = $spl->key();
 
         // if seeking to the end the cursor is still at 0, there are no lines.
-        if($number === 0)
+        if ($number === 0)
         {
             // since it's a very small file, to get reliable results,
             // we read its contents and use that to determine what
@@ -84,13 +84,13 @@ 
             // that this is not practical to solve with the SplFileObject.
             $content = file_get_contents($path);
 
-            if(empty($content)) {
+            if (empty($content)) {
                 return 0;
             }
         }
 
         // return the line number we were able to reach + 1 (key is zero-based)
-        return $number+1;
+        return $number + 1;
     }
 
     /**
@@ -98,13 +98,13 @@ 
      * @return string[]
      * @throws FileHelper_Exception
      */
-    public function getLines(int $amount=0) : array
+    public function getLines(int $amount = 0) : array
     {
         $this->file->requireExists();
 
         $fn = fopen($this->file->getPath(), 'rb');
 
-        if($fn === false)
+        if ($fn === false)
         {
             throw new FileHelper_Exception(
                 'Could not open file for reading.',
@@ -120,19 +120,19 @@ 
         $counter = 0;
         $first = true;
 
-        while(!feof($fn))
+        while (!feof($fn))
         {
             $counter++;
 
             $line = fgets($fn);
 
             // can happen with zero length files
-            if($line === false) {
+            if ($line === false) {
                 continue;
             }
 
             // the first line may contain a unicode BOM marker.
-            if($first)
+            if ($first)
             {
                 $line = ConvertHelper::stripUTFBom($line);
                 $first = false;
@@ -140,7 +140,7 @@ 
 
             $result[] = $line;
 
-            if($amount > 0 && $counter === $amount) {
+            if ($amount > 0 && $counter === $amount) {
                 break;
             }
         }

src/FileHelper/FileInfo/NameFixer.php

Spacing +2 added lines, -2 removed lines

@@ -49,13 +49,13 @@
 
         $name = str_replace(array_keys($replaces), array_values($replaces), $name);
 
-        while(strpos($name, '  ') !== false) {
+        while (strpos($name, '  ') !== false) {
             $name = str_replace('  ', ' ', $name);
         }
 
         $name = str_replace(array_keys($replaces), array_values($replaces), $name);
 
-        while(strpos($name, '..') !== false) {
+        while (strpos($name, '..') !== false) {
             $name = str_replace('..', '.', $name);
         }
 

src/FileHelper/PathsReducer.php

Spacing +13 added lines, -13 removed lines

@@ -36,7 +36,7 @@ 
      * @param string[] $paths
      * @throws FileHelper_Exception
      */
-    public function __construct(array $paths=array())
+    public function __construct(array $paths = array())
     {
         $this->addPaths($paths);
     }
@@ -49,7 +49,7 @@ 
      */
     public function addPaths(array $paths) : PathsReducer
     {
-        foreach($paths as $path) {
+        foreach ($paths as $path) {
             $this->addPath($path);
         }
 
@@ -66,7 +66,7 @@ 
     {
         $path = FileHelper::normalizePath($path);
 
-        if(!in_array($path, $this->paths, true)) {
+        if (!in_array($path, $this->paths, true)) {
             $this->paths[] = $path;
         }
 
@@ -83,11 +83,11 @@ 
     {
         $split = $this->splitPaths();
 
-        if(empty($split)) {
+        if (empty($split)) {
             return array();
         }
 
-        while($this->shiftPart($split) === true) {}
+        while ($this->shiftPart($split) === true) {}
 
         return $this->joinPaths($split);
     }
@@ -101,7 +101,7 @@ 
         $result = array();
 
         foreach ($split as $entry) {
-            if(!empty($entry)) {
+            if (!empty($entry)) {
                 $result[] = implode('/', $entry);
             }
         }
@@ -118,22 +118,22 @@ 
         $current = null;
         $result = array();
 
-        foreach($split as $entry)
+        foreach ($split as $entry)
         {
-            if(empty($entry)) {
+            if (empty($entry)) {
                 return false;
             }
 
             $part = array_shift($entry);
-            if(empty($entry)) {
+            if (empty($entry)) {
                 return false;
             }
 
-            if($current === null) {
+            if ($current === null) {
                 $current = $part;
             }
 
-            if($part !== $current) {
+            if ($part !== $current) {
                 return false;
             }
 
@@ -152,9 +152,9 @@ 
     {
         $split = array();
 
-        foreach($this->paths as $path) {
+        foreach ($this->paths as $path) {
             $entry = ConvertHelper::explodeTrim('/', $path);
-            if(!empty($entry)) {
+            if (!empty($entry)) {
                 $split[] = $entry;
             }
         }

src/FileHelper.php

Braces +1 added lines, -2 removed lines

@@ -516,8 +516,7 @@
         if(isset($options['relative-path']) && $options['relative-path'] === true) 
         {
             $finder->setPathmodeRelative();
-        } 
-        else if(isset($options['absolute-path']) && $options['absolute-path'] === true)
+        } else if(isset($options['absolute-path']) && $options['absolute-path'] === true)
         {
             $finder->setPathmodeAbsolute();
         }

Spacing +22 added lines, -22 removed lines

@@ -207,7 +207,7 @@ 
     public static function detectMimeType($fileName) : ?string
     {
         $ext = self::getExtension($fileName);
-        if(empty($ext)) {
+        if (empty($ext)) {
             return null;
         }
 
@@ -251,7 +251,7 @@ 
      * @see FileHelper::ERROR_FILE_DOES_NOT_EXIST
      * @see FileHelper::ERROR_UNKNOWN_FILE_MIME_TYPE
      */
-    public static function sendFile($filePath, ?string $fileName = null, bool $asAttachment=true) : void
+    public static function sendFile($filePath, ?string $fileName = null, bool $asAttachment = true) : void
     {
         self::getFileInfo($filePath)->getDownloader()->send($fileName, $asAttachment);
     }
@@ -268,7 +268,7 @@ 
      * @throws FileHelper_Exception
      * @see FileHelper::ERROR_CANNOT_OPEN_URL
      */
-    public static function downloadFile(string $url, int $timeout=0, bool $SSLEnabled=false) : string
+    public static function downloadFile(string $url, int $timeout = 0, bool $SSLEnabled = false) : string
     {
         return FileDownloader::factory($url)
             ->setTimeout($timeout)
@@ -323,7 +323,7 @@ 
     {
         $info = self::getPathInfo($pathOrDirIterator);
 
-        if($extension === true || $info instanceof FolderInfo)
+        if ($extension === true || $info instanceof FolderInfo)
         {
             return $info->getName();
         }
@@ -345,7 +345,7 @@ 
      * @see FileHelper::ERROR_CANNOT_FIND_JSON_FILE
      * @see FileHelper::ERROR_CANNOT_DECODE_JSON_FILE
      */
-    public static function parseJSONFile($file, string $targetEncoding='', $sourceEncoding=null) : array
+    public static function parseJSONFile($file, string $targetEncoding = '', $sourceEncoding = null) : array
     {
         return JSONFile::factory($file)
             ->setTargetEncoding($targetEncoding)
@@ -398,7 +398,7 @@ 
      * @throws FileHelper_Exception
      * @see FileHelper::createFileFinder()
      */
-    public static function findHTMLFiles($targetFolder, array $options=array()) : array
+    public static function findHTMLFiles($targetFolder, array $options = array()) : array
     {
         return self::findFiles($targetFolder, array('html'), $options);
     }
@@ -417,7 +417,7 @@ 
      * @throws FileHelper_Exception
      * @see FileHelper::createFileFinder()
      */
-    public static function findPHPFiles($targetFolder, array $options=array()) : array
+    public static function findPHPFiles($targetFolder, array $options = array()) : array
     {
         return self::findFiles($targetFolder, array('php'), $options);
     }
@@ -439,7 +439,7 @@ 
     * @see FileHelper::createFileFinder()
     * @deprecated Use the file finder instead.
     */
-    public static function findFiles($targetFolder, array $extensions=array(), array $options=array()) : array
+    public static function findFiles($targetFolder, array $extensions = array(), array $options = array()) : array
     {
         $finder = self::createFileFinder($targetFolder);
 
@@ -449,16 +449,16 @@ 
 
         $finder->setPathmodeStrip();
         
-        if(isset($options['relative-path']) && $options['relative-path'] === true) 
+        if (isset($options['relative-path']) && $options['relative-path'] === true) 
         {
             $finder->setPathmodeRelative();
         } 
-        else if(isset($options['absolute-path']) && $options['absolute-path'] === true)
+        else if (isset($options['absolute-path']) && $options['absolute-path'] === true)
         {
             $finder->setPathmodeAbsolute();
         }
         
-        if(isset($options['strip-extension'])) 
+        if (isset($options['strip-extension'])) 
         {
             $finder->stripExtensions();
         }
@@ -477,16 +477,16 @@ 
      * @return string
      * @throws FileHelper_Exception
      */
-    public static function removeExtension($filename, bool $keepPath=false) : string
+    public static function removeExtension($filename, bool $keepPath = false) : string
     {
         $path = self::getPathInfo($filename);
 
-        if($path instanceof FileInfo)
+        if ($path instanceof FileInfo)
         {
             return $path->removeExtension($keepPath);
         }
 
-        if($keepPath)
+        if ($keepPath)
         {
             return $filename;
         }
@@ -501,7 +501,7 @@ 
 
     public static function createUnicodeHandling() : UnicodeHandling
     {
-        if(!isset(self::$unicodeHandling))
+        if (!isset(self::$unicodeHandling))
         {
             self::$unicodeHandling = new UnicodeHandling();
         }
@@ -535,7 +535,7 @@ 
      * @see FileHelper::ERROR_SAVE_FILE_NOT_WRITABLE
      * @see FileHelper::ERROR_SAVE_FILE_WRITE_FAILED
      */
-    public static function saveAsJSON($data, $file, bool $pretty=false) : JSONFile
+    public static function saveAsJSON($data, $file, bool $pretty = false) : JSONFile
     {
         return JSONFile::factory($file)->putData($data, $pretty);
     }
@@ -553,7 +553,7 @@ 
      * @see FileHelper::ERROR_SAVE_FILE_NOT_WRITABLE
      * @see FileHelper::ERROR_SAVE_FILE_WRITE_FAILED
      */
-    public static function saveFile($filePath, string $content='') : FileInfo
+    public static function saveFile($filePath, string $content = '') : FileInfo
     {
         return self::getFileInfo($filePath)->putContents($content);
     }
@@ -665,7 +665,7 @@ 
     * @param int $depth The folder depth to reduce the path to
     * @return string
     */
-    public static function relativizePathByDepth(string $path, int $depth=2) : string
+    public static function relativizePathByDepth(string $path, int $depth = 2) : string
     {
         return PathRelativizer::relativizeByDepth($path, $depth);
     }
@@ -704,7 +704,7 @@ 
     * @see FileHelper::ERROR_FILE_DOES_NOT_EXIST
     * @see FileHelper::ERROR_REAL_PATH_NOT_FOUND
     */
-    public static function requireFileExists($path, ?int $errorCode=null) : string
+    public static function requireFileExists($path, ?int $errorCode = null) : string
     {
         return self::getPathInfo($path)
             ->requireIsFile()
@@ -718,7 +718,7 @@ 
      * @return string
      * @throws FileHelper_Exception
      */
-    public static function requireFileReadable($path, ?int $errorCode=null) : string
+    public static function requireFileReadable($path, ?int $errorCode = null) : string
     {
         return self::getPathInfo($path)
             ->requireIsFile()
@@ -796,7 +796,7 @@ 
      * @see FileHelper::ERROR_FILE_DOES_NOT_EXIST
      * @see FileHelper::ERROR_CANNOT_OPEN_FILE_TO_READ_LINES
      */
-    public static function readLines($filePath, int $amount=0) : array
+    public static function readLines($filePath, int $amount = 0) : array
     {
         return self::getFileInfo($filePath)
             ->getLineReader()
@@ -846,7 +846,7 @@ 
      *
      * @throws FileHelper_Exception
      */
-    public static function createPathsReducer(array $paths=array()) : PathsReducer
+    public static function createPathsReducer(array $paths = array()) : PathsReducer
     {
         return new PathsReducer($paths);
     }

Indentation +162 added lines, -162 removed lines

@@ -73,18 +73,18 @@ 
     public const ERROR_PATH_INVALID = 340040;
     public const ERROR_CANNOT_COPY_FILE_TO_FOLDER = 340041;
 
-   /**
-    * Opens a serialized file and returns the unserialized data.
-    *
-    * @param string|PathInfoInterface|SplFileInfo $file
-    * @throws FileHelper_Exception
-    * @return array<int|string,mixed>
-    * @see SerializedFile::parse()
-    * 
-    * @see FileHelper::ERROR_FILE_DOES_NOT_EXIST
-    * @see FileHelper::ERROR_SERIALIZED_FILE_CANNOT_BE_READ
-    * @see FileHelper::ERROR_SERIALIZED_FILE_UNSERIALZE_FAILED
-    */
+    /**
+     * Opens a serialized file and returns the unserialized data.
+     *
+     * @param string|PathInfoInterface|SplFileInfo $file
+     * @throws FileHelper_Exception
+     * @return array<int|string,mixed>
+     * @see SerializedFile::parse()
+     * 
+     * @see FileHelper::ERROR_FILE_DOES_NOT_EXIST
+     * @see FileHelper::ERROR_SERIALIZED_FILE_CANNOT_BE_READ
+     * @see FileHelper::ERROR_SERIALIZED_FILE_UNSERIALZE_FAILED
+     */
     public static function parseSerializedFile($file) : array
     {
         return SerializedFile::factory($file)->parse();
@@ -103,13 +103,13 @@ 
         return FolderTree::delete($rootFolder);
     }
     
-   /**
-    * Create a folder, if it does not exist yet.
-    *  
-    * @param string|PathInfoInterface $path
-    * @throws FileHelper_Exception
-    * @see FileHelper::ERROR_CANNOT_CREATE_FOLDER
-    */
+    /**
+     * Create a folder, if it does not exist yet.
+     *  
+     * @param string|PathInfoInterface $path
+     * @throws FileHelper_Exception
+     * @see FileHelper::ERROR_CANNOT_CREATE_FOLDER
+     */
     public static function createFolder($path) : FolderInfo
     {
         return self::getFolderInfo($path)->create();
@@ -138,36 +138,36 @@ 
         FolderTree::copy($source, $target);
     }
     
-   /**
-    * Copies a file to the target location. Includes checks
-    * for most error sources, like the source file not being
-    * readable. Automatically creates the target folder if it
-    * does not exist yet.
-    * 
-    * @param string|PathInfoInterface|SplFileInfo $sourcePath
-    * @param string|PathInfoInterface|SplFileInfo $targetPath
-    * @throws FileHelper_Exception
-    * 
-    * @see FileHelper::ERROR_CANNOT_CREATE_FOLDER
-    * @see FileHelper::ERROR_SOURCE_FILE_NOT_FOUND
-    * @see FileHelper::ERROR_SOURCE_FILE_NOT_READABLE
-    * @see FileHelper::ERROR_TARGET_COPY_FOLDER_NOT_WRITABLE
-    * @see FileHelper::ERROR_CANNOT_COPY_FILE
-    */
+    /**
+     * Copies a file to the target location. Includes checks
+     * for most error sources, like the source file not being
+     * readable. Automatically creates the target folder if it
+     * does not exist yet.
+     * 
+     * @param string|PathInfoInterface|SplFileInfo $sourcePath
+     * @param string|PathInfoInterface|SplFileInfo $targetPath
+     * @throws FileHelper_Exception
+     * 
+     * @see FileHelper::ERROR_CANNOT_CREATE_FOLDER
+     * @see FileHelper::ERROR_SOURCE_FILE_NOT_FOUND
+     * @see FileHelper::ERROR_SOURCE_FILE_NOT_READABLE
+     * @see FileHelper::ERROR_TARGET_COPY_FOLDER_NOT_WRITABLE
+     * @see FileHelper::ERROR_CANNOT_COPY_FILE
+     */
     public static function copyFile($sourcePath, $targetPath) : void
     {
         self::getFileInfo($sourcePath)->copyTo($targetPath);
     }
     
-   /**
-    * Deletes the target file. Ignored if it cannot be found,
-    * and throws an exception if it fails.
-    * 
-    * @param string|PathInfoInterface|SplFileInfo $filePath
-    * @throws FileHelper_Exception
-    * 
-    * @see FileHelper::ERROR_CANNOT_DELETE_FILE
-    */
+    /**
+     * Deletes the target file. Ignored if it cannot be found,
+     * and throws an exception if it fails.
+     * 
+     * @param string|PathInfoInterface|SplFileInfo $filePath
+     * @throws FileHelper_Exception
+     * 
+     * @see FileHelper::ERROR_CANNOT_DELETE_FILE
+     */
     public static function deleteFile($filePath) : void
     {
         self::getFileInfo($filePath)->delete();
@@ -288,7 +288,7 @@ 
      */
     public static function isPHPFile($filePath) : bool
     {
-    	return self::getExtension($filePath) === 'php';
+        return self::getExtension($filePath) === 'php';
     }
 
     /**
@@ -354,16 +354,16 @@ 
             ->parse();
     }
     
-   /**
-    * Corrects common formatting mistakes when users enter
-    * file names, like too many spaces, dots and the like.
-    * 
-    * NOTE: if the file name contains a path, the path is
-    * stripped, leaving only the file name.
-    * 
-    * @param string $name
-    * @return string
-    */
+    /**
+     * Corrects common formatting mistakes when users enter
+     * file names, like too many spaces, dots and the like.
+     * 
+     * NOTE: if the file name contains a path, the path is
+     * stripped, leaving only the file name.
+     * 
+     * @param string $name
+     * @return string
+     */
     public static function fixFileName(string $name) : string
     {
         return NameFixer::fixName($name);
@@ -423,23 +423,23 @@ 
         return self::findFiles($targetFolder, array('php'), $options);
     }
     
-   /**
-    * Finds files according to the specified options.
-    * 
-    * NOTE: This method only exists for backwards compatibility.
-    * Use the {@see FileHelper::createFileFinder()} method instead,
-    * which offers an object-oriented interface that is much easier
-    * to use.
-    *  
-    * @param string|PathInfoInterface|SplFileInfo $targetFolder
-    * @param string[] $extensions
-    * @param array<string,mixed> $options
-    * @throws FileHelper_Exception
-    * @return string[]
-    *
-    * @see FileHelper::createFileFinder()
-    * @deprecated Use the file finder instead.
-    */
+    /**
+     * Finds files according to the specified options.
+     * 
+     * NOTE: This method only exists for backwards compatibility.
+     * Use the {@see FileHelper::createFileFinder()} method instead,
+     * which offers an object-oriented interface that is much easier
+     * to use.
+     *  
+     * @param string|PathInfoInterface|SplFileInfo $targetFolder
+     * @param string[] $extensions
+     * @param array<string,mixed> $options
+     * @throws FileHelper_Exception
+     * @return string[]
+     *
+     * @see FileHelper::createFileFinder()
+     * @deprecated Use the file finder instead.
+     */
     public static function findFiles($targetFolder, array $extensions=array(), array $options=array()) : array
     {
         $finder = self::createFileFinder($targetFolder);
@@ -510,13 +510,13 @@ 
         return self::$unicodeHandling;
     }
     
-   /**
-    * Normalizes the slash style in a file or folder path,
-    * by replacing any anti-slashes with forward slashes.
-    * 
-    * @param string $path
-    * @return string
-    */
+    /**
+     * Normalizes the slash style in a file or folder path,
+     * by replacing any anti-slashes with forward slashes.
+     * 
+     * @param string $path
+     * @return string
+     */
     public static function normalizePath(string $path) : string
     {
         return str_replace(array('\\', '//'), array('/', '/'), $path);
@@ -641,70 +641,70 @@ 
             ->getPaths();
     }
 
-   /**
-    * Retrieves the maximum allowed upload file size, in bytes.
-    * Takes into account the PHP ini settings <code>post_max_size</code>
-    * and <code>upload_max_filesize</code>. Since these cannot
-    * be modified at runtime, they are the hard limits for uploads.
-    * 
-    * NOTE: Based on binary values, where 1KB = 1024 Bytes.
-    * 
-    * @return int Will return <code>-1</code> if no limit.
-    */
+    /**
+     * Retrieves the maximum allowed upload file size, in bytes.
+     * Takes into account the PHP ini settings <code>post_max_size</code>
+     * and <code>upload_max_filesize</code>. Since these cannot
+     * be modified at runtime, they are the hard limits for uploads.
+     * 
+     * NOTE: Based on binary values, where 1KB = 1024 Bytes.
+     * 
+     * @return int Will return <code>-1</code> if no limit.
+     */
     public static function getMaxUploadFilesize() : int
     {
         return UploadFileSizeInfo::getFileSize();
     }
    
-   /**
-    * Makes a path relative using a folder depth: will reduce the
-    * length of the path so that only the amount of folders defined
-    * in the <code>$depth</code> attribute are shown below the actual
-    * folder or file in the path.
-    *  
-    * @param string  $path The absolute or relative path
-    * @param int $depth The folder depth to reduce the path to
-    * @return string
-    */
+    /**
+     * Makes a path relative using a folder depth: will reduce the
+     * length of the path so that only the amount of folders defined
+     * in the <code>$depth</code> attribute are shown below the actual
+     * folder or file in the path.
+     *  
+     * @param string  $path The absolute or relative path
+     * @param int $depth The folder depth to reduce the path to
+     * @return string
+     */
     public static function relativizePathByDepth(string $path, int $depth=2) : string
     {
         return PathRelativizer::relativizeByDepth($path, $depth);
     }
     
-   /**
-    * Makes the specified path relative to another path,
-    * by removing one from the other if found. Also 
-    * normalizes the path to use forward slashes. 
-    * 
-    * Example:
-    * 
-    * <pre>
-    * relativizePath('c:\some\folder\to\file.txt', 'c:\some\folder');
-    * </pre>
-    * 
-    * Result: <code>to/file.txt</code>
-    * 
-    * @param string $path
-    * @param string $relativeTo
-    * @return string
-    */
+    /**
+     * Makes the specified path relative to another path,
+     * by removing one from the other if found. Also 
+     * normalizes the path to use forward slashes. 
+     * 
+     * Example:
+     * 
+     * <pre>
+     * relativizePath('c:\some\folder\to\file.txt', 'c:\some\folder');
+     * </pre>
+     * 
+     * Result: <code>to/file.txt</code>
+     * 
+     * @param string $path
+     * @param string $relativeTo
+     * @return string
+     */
     public static function relativizePath(string $path, string $relativeTo) : string
     {
         return PathRelativizer::relativize($path, $relativeTo);
     }
     
-   /**
-    * Checks that the target file exists, and throws an exception
-    * if it does not. 
-    * 
-    * @param string|SplFileInfo $path
-    * @param int|NULL $errorCode Optional custom error code
-    * @throws FileHelper_Exception
-    * @return string The real path to the file
-    * 
-    * @see FileHelper::ERROR_FILE_DOES_NOT_EXIST
-    * @see FileHelper::ERROR_REAL_PATH_NOT_FOUND
-    */
+    /**
+     * Checks that the target file exists, and throws an exception
+     * if it does not. 
+     * 
+     * @param string|SplFileInfo $path
+     * @param int|NULL $errorCode Optional custom error code
+     * @throws FileHelper_Exception
+     * @return string The real path to the file
+     * 
+     * @see FileHelper::ERROR_FILE_DOES_NOT_EXIST
+     * @see FileHelper::ERROR_REAL_PATH_NOT_FOUND
+     */
     public static function requireFileExists($path, ?int $errorCode=null) : string
     {
         return self::getPathInfo($path)
@@ -727,18 +727,18 @@ 
             ->getPath();
     }
     
-   /**
-    * Reads a specific line number from the target file and returns its
-    * contents, if the file has such a line. Does so with little memory
-    * usage, as the file is not read entirely into memory.
-    * 
-    * @param string|PathInfoInterface|SplFileInfo $path
-    * @param int $lineNumber Note: 1-based; the first line is number 1.
-    * @return string|NULL Will return null if the requested line does not exist.
-    * @throws FileHelper_Exception
-    * 
-    * @see FileHelper::ERROR_FILE_DOES_NOT_EXIST
-    */
+    /**
+     * Reads a specific line number from the target file and returns its
+     * contents, if the file has such a line. Does so with little memory
+     * usage, as the file is not read entirely into memory.
+     * 
+     * @param string|PathInfoInterface|SplFileInfo $path
+     * @param int $lineNumber Note: 1-based; the first line is number 1.
+     * @return string|NULL Will return null if the requested line does not exist.
+     * @throws FileHelper_Exception
+     * 
+     * @see FileHelper::ERROR_FILE_DOES_NOT_EXIST
+     */
     public static function getLineFromFile($path, int $lineNumber) : ?string
     {
         return self::getFileInfo($path)->getLine($lineNumber);
@@ -804,33 +804,33 @@ 
             ->getLines($amount);
     }
     
-   /**
-    * Reads all content from a file.
-    * 
-    * @param string|PathInfoInterface|SplFileInfo $filePath
-    * @throws FileHelper_Exception
-    * @return string
-    * 
-    * @see FileHelper::ERROR_FILE_DOES_NOT_EXIST
-    * @see FileHelper::ERROR_CANNOT_READ_FILE_CONTENTS
-    */
+    /**
+     * Reads all content from a file.
+     * 
+     * @param string|PathInfoInterface|SplFileInfo $filePath
+     * @throws FileHelper_Exception
+     * @return string
+     * 
+     * @see FileHelper::ERROR_FILE_DOES_NOT_EXIST
+     * @see FileHelper::ERROR_CANNOT_READ_FILE_CONTENTS
+     */
     public static function readContents($filePath) : string
     {
         return self::getFileInfo($filePath)->getContents();
     }
 
-   /**
-    * Ensures that the target path exists on disk, and is a folder.
-    * 
-    * @param string|PathInfoInterface|SplFileInfo $path
-    * @return string The real path, with normalized slashes.
-    * @throws FileHelper_Exception
-    * 
-    * @see FileHelper::normalizePath()
-    * 
-    * @see FileHelper::ERROR_FOLDER_DOES_NOT_EXIST
-    * @see FileHelper::ERROR_PATH_IS_NOT_A_FOLDER
-    */
+    /**
+     * Ensures that the target path exists on disk, and is a folder.
+     * 
+     * @param string|PathInfoInterface|SplFileInfo $path
+     * @return string The real path, with normalized slashes.
+     * @throws FileHelper_Exception
+     * 
+     * @see FileHelper::normalizePath()
+     * 
+     * @see FileHelper::ERROR_FOLDER_DOES_NOT_EXIST
+     * @see FileHelper::ERROR_PATH_IS_NOT_A_FOLDER
+     */
     public static function requireFolderExists($path) : string
     {
         return self::getFolderInfo($path)