add new func and methods

Author: inhere

composer.json

@@ -26,7 +26,10 @@
   "autoload": {
     "psr-4": {
       "Toolkit\\Stdlib\\": "src/"
-    }
+    },
+    "files": [
+      "src/func.php"
+    ]
   },
   "suggest": {
     "inhere/php-validate": "Very lightweight data validate tool"

src/Helper/PhpHelper.php

@@ -171,6 +171,31 @@ public static function runtime($startTime, $startMem, array $info = [], $realUsa
         return $info;
     }
 
+    /**
+     * Usage:
+     *
+     * $backtrace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 3);
+     * $position = PhpHelper::formatBacktrace($backtrace, 2);
+     *
+     * @param array $traces
+     * @param int   $index
+     *
+     * @return string
+     */
+    public static function formatBacktrace(array $traces, int $index): string
+    {
+        $position = 'UNKNOWN';
+
+        if (isset($traces[$index+1])) {
+            $tInfo = $traces[$index];
+            $prev  = $traces[$index+1];
+
+            $position = sprintf('%s.%s:%d', $prev['class'], $prev['function'] ?? 'UNKNOWN', $tInfo['line']);
+        }
+
+        return $position;
+    }
+
     /**
      * dump vars
      *

src/func.php

@@ -0,0 +1,44 @@
+<?php
+
+if (!function_exists('vdump')) {
+    /**
+     * Dump data like var_dump
+     *
+     * @param mixed ...$vars
+     */
+    function vdump(...$vars)
+    {
+        $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2);
+
+        $line = $trace[0]['line'];
+        $pos  = $trace[1]['class'] ?? $trace[0]['file'];
+
+        if ($pos) {
+            echo "CALL ON $pos($line):\n";
+        }
+
+        echo Toolkit\Stdlib\Php::dumpVars(...$vars), PHP_EOL;
+    }
+}
+
+if (!function_exists('ddump')) {
+    /**
+     * Dump data like var_dump, will call exit on print after.
+     *
+     * @param mixed ...$vars
+     */
+    function ddump(...$vars)
+    {
+        $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2);
+
+        $line = $trace[0]['line'];
+        $pos  = $trace[1]['class'] ?? $trace[0]['file'];
+
+        if ($pos) {
+            echo "CALL ON $pos($line):\n";
+        }
+
+        echo Toolkit\Stdlib\Php::dumpVars(...$vars), PHP_EOL;
+        exit(0);
+    }
+}