feat: add new fs method realpath

Signed-off-by: inhere <in.798@qq.com>

Author: inhere

src/FS.php

@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace Toolkit\FsUtil;
+
+/**
+ * Class FS
+ *
+ * @package Toolkit\FsUtil
+ */
+class FS extends FileSystem
+{
+
+}

src/FileSystem.php

@@ -258,7 +258,7 @@ public static function pathModeInfo(string $filepath): int
     {
         /* 如果不存在，则不可读、不可写、不可改 */
         if (!file_exists($filepath)) {
-            return false;
+            return 0;
         }
 
         $mark = 0;

src/Traits/FileSystemFuncTrait.php

@@ -13,14 +13,21 @@
 use Toolkit\FsUtil\Exception\FileSystemException;
 use Toolkit\FsUtil\Exception\IOException;
 use Toolkit\Stdlib\Arr;
+use Toolkit\Stdlib\OS;
 use Traversable;
+use function array_filter;
+use function array_pop;
 use function copy;
 use function error_get_last;
 use function function_exists;
+use function implode;
 use function is_dir;
 use function mkdir;
+use function realpath;
 use function rmdir;
+use function str_replace;
 use function strlen;
+use const DIRECTORY_SEPARATOR;
 
 /**
  * Trait FileSystemFuncTrait
@@ -148,6 +155,42 @@ public static function chown($files, string $user, $recursive = false): void
         }
     }
 
+    /**
+     * @param string $path
+     *
+     * @return string
+     * @see realpath()
+     * @link https://www.php.net/manual/zh/function.realpath.php#84012
+     */
+    public static function realpath(string $path): string
+    {
+        $path  = str_replace(['/', '\\'], DIRECTORY_SEPARATOR, $path);
+        $parts = array_filter(explode(DIRECTORY_SEPARATOR, $path), 'strlen');
+        if (!$parts) {
+            return '';
+        }
+
+        // ~: is user home dir in *nix OS
+        if ($parts[0] === '~' && false === OS::isWindows()) {
+            $parts[0] = OS::getUserHomeDir();
+        }
+
+        $absolutes = [];
+        foreach ($parts as $part) {
+            if ('.' === $part) {
+                continue;
+            }
+
+            if ('..' === $part) {
+                array_pop($absolutes);
+            } else {
+                $absolutes[] = $part;
+            }
+        }
+
+        return implode(DIRECTORY_SEPARATOR, $absolutes);
+    }
+
     /**********************************************************************************
      * dir functions
      *********************************************************************************/