feat: add an base collection utl class

Author: inhere

src/Arr/Traits/ArrayValueGetSetTrait.php

@@ -11,6 +11,7 @@
 
 use ArrayAccess;
 use Toolkit\Stdlib\Php;
+use Traversable;
 use function array_filter;
 use function array_shift;
 use function count;
@@ -168,8 +169,8 @@ public static function gets(array &$data, array $needKeys = [], bool $unsetKey =
      * Get data from array or object by path.
      * Example: `DataCollector::getByPath($array, 'foo.bar.yoo')` equals to $array['foo']['bar']['yoo'].
      *
-     * @param array|ArrayAccess $data      An array or object to get value.
-     * @param mixed             $path      The key path.
+     * @param array|Traversable $data      An array or object to get value.
+     * @param string            $path      The key path.
      * @param mixed             $default
      * @param string            $separator Separator of paths.
      *
@@ -188,12 +189,11 @@ public static function getByPath($data, string $path, $default = null, string $s
         }
 
         $dataTmp = $data;
-
         foreach ($nodes as $arg) {
-            if (is_object($dataTmp) && isset($dataTmp->$arg)) {
-                $dataTmp = $dataTmp->$arg;
-            } elseif ((is_array($dataTmp) || $dataTmp instanceof ArrayAccess) && isset($dataTmp[$arg])) {
+            if ((is_array($dataTmp) || $dataTmp instanceof ArrayAccess) && isset($dataTmp[$arg])) {
                 $dataTmp = $dataTmp[$arg];
+            } elseif (is_object($dataTmp) && isset($dataTmp->$arg)) {
+                $dataTmp = $dataTmp->$arg;
             } else {
                 return $default;
             }

src/OS.php

@@ -9,15 +9,20 @@
 
 namespace Toolkit\Stdlib;
 
+use InvalidArgumentException;
 use RuntimeException;
 use function defined;
+use function dirname;
 use function explode;
+use function file_get_contents;
+use function file_put_contents;
 use function function_exists;
 use function getcwd;
 use function getenv;
 use function getmyuid;
 use function in_array;
 use function is_dir;
+use function is_file;
 use function is_writable;
 use function mkdir;
 use function php_uname;
@@ -373,6 +378,36 @@ public static function isInteractive($fileDescriptor): bool
         return function_exists('posix_isatty') && @posix_isatty($fileDescriptor);
     }
 
+    /**
+     * @param string $filepath
+     *
+     * @return string
+     */
+    public static function readFile(string $filepath): string
+    {
+        if (!is_file($filepath)) {
+            throw new InvalidArgumentException('no such file: ' . $filepath);
+        }
+
+        return file_get_contents($filepath);
+    }
+
+    /**
+     * @param string $filepath
+     * @param string $contents
+     * @param int $flags
+     *
+     * @return int
+     */
+    public static function writeFile(string $filepath, string $contents, int $flags = 0): int
+    {
+        // if (!is_dir($dir = dirname($filepath))) {
+        //     self::mkdir($dir);
+        // }
+
+        return (int)file_put_contents($filepath, $contents, $flags);
+    }
+
     /**
      * Support the creation of hierarchical directories
      *