new: add new method toString convert any value to string

Author: inhere

src/Helper/DataHelper.php

@@ -3,7 +3,13 @@
 namespace Toolkit\Stdlib\Helper;
 
 use function filter_var;
+use function gettype;
+use function is_array;
+use function is_bool;
+use function is_object;
 use function is_scalar;
+use function json_encode;
+use function method_exists;
 use const FILTER_NULL_ON_FAILURE;
 use const FILTER_VALIDATE_BOOLEAN;
 
@@ -46,4 +52,37 @@ public static function toBool($val, $nullAsFalse = false): bool
     {
         return self::boolean($val, $nullAsFalse);
     }
+
+    /**
+     * @param mixed $val
+     *
+     * @return string
+     */
+    public static function toString($val): string
+    {
+        // print_r($value)
+        // var_export($value)
+        if (is_scalar($val)) {
+            if (is_bool($val)) {
+                return $val ? 'bool(TRUE)' : 'bool(FALSE)';
+            }
+
+            return (string)$val;
+        }
+
+        if (is_array($val)) {
+            return json_encode($val);
+        }
+
+        if (is_object($val)) {
+            if (method_exists($val, '__toString')) {
+                return (string)$val;
+            }
+
+            return PhpHelper::dumpVars($val);
+        }
+
+        $typeName = gettype($val);
+        return '<' . $typeName . '>';
+    }
 }

src/Helper/JsonHelper.php

@@ -39,13 +39,15 @@ class JsonHelper
     // ----------- encode -----------
 
     /**
-     * @param $data
+     * @param mixed $data
+     * @param int $flags
+     * @param int $depth
      *
      * @return string
      */
-    public static function enc($data): string
+    public static function enc($data, int $flags = 0, int $depth = 512): string
     {
-        return json_encode($data);
+        return json_encode($data, $flags, $depth);
     }
 
     /**

test/Helper/DataHelperTest.php

@@ -22,4 +22,24 @@ public function testToBool(): void
         self::assertFalse(DataHelper::toBool('off'));
         self::assertFalse(DataHelper::toBool('0'));
     }
+
+    public function testToString(): void
+    {
+        self::assertEquals('1.2', DataHelper::toString(1.2));
+        self::assertEquals('12', DataHelper::toString(12));
+        self::assertEquals('abc', DataHelper::toString('abc'));
+        self::assertEquals('bool(TRUE)', DataHelper::toString(true));
+        self::assertEquals('bool(FALSE)', DataHelper::toString(false));
+        self::assertEquals('<NULL>', DataHelper::toString(null));
+        self::assertEquals('["ab",23]', DataHelper::toString(['ab', 23]));
+
+        $objStr = <<<OBJ
+object(stdClass)#73 (2) {
+  ["0"]=> string(2) "ab"
+  ["1"]=> int(23)
+}
+
+OBJ;
+        self::assertEquals($objStr, DataHelper::toString((object)['ab', 23]));
+    }
 }