up: str - refactor the Str.renderTemplate logic

Author: inhere

src/Str/StringHelper.php

@@ -12,6 +12,7 @@
 use DateTime;
 use Exception;
 use Stringable;
+use Toolkit\Stdlib\Arr;
 use Toolkit\Stdlib\Str\Traits\StringCaseHelperTrait;
 use Toolkit\Stdlib\Str\Traits\StringCheckHelperTrait;
 use Toolkit\Stdlib\Str\Traits\StringConvertTrait;
@@ -33,6 +34,8 @@
 use function mb_strwidth;
 use function microtime;
 use function preg_match;
+use function preg_quote;
+use function preg_replace_callback;
 use function preg_split;
 use function random_bytes;
 use function random_int;
@@ -46,6 +49,7 @@
 use function strlen;
 use function strtr;
 use function substr;
+use function trim;
 use function uniqid;
 use const STR_PAD_LEFT;
 use const STR_PAD_RIGHT;
@@ -279,7 +283,7 @@ public static function genNOV2(string|int|Stringable $prefix = '', array $random
 
     /**
      * @param string $tplCode
-     * @param array  $vars
+     * @param array  $vars [k => v]
      *
      * @return string
      */
@@ -289,28 +293,47 @@ public static function replaces(string $tplCode, array $vars): string
     }
 
     /**
+     * Simple render vars to template string.
+     *
      * @param string $tplCode
      * @param array $vars
-     * @param string $format
+     * @param string $format  Template var format
      *
      * @return string
      */
-    public static function renderTemplate(string $tplCode, array $vars, string $format = '{{%s}}'): string
+    public static function renderVars(string $tplCode, array $vars, string $format = '{{%s}}'): string
     {
         // get left chars
-        [$left, ] = explode('%s', $format);
+        [$left, $right] = explode('%s', $format);
         if (!$vars || !str_contains($tplCode, $left)) {
             return $tplCode;
         }
 
-        $fmtVars = [];
-        foreach ($vars as $name => $var) {
-            $name = sprintf($format, (string)$name);
-            // add
-            $fmtVars[$name] = $var;
-        }
+        $fmtVars = Arr::flattenMap($vars, Arr::FLAT_DOT_JOIN_INDEX);
+        $pattern = sprintf('/%s([\w\s.-]+)%s/', preg_quote($left, '/'), preg_quote($right, '/'));
+
+        return preg_replace_callback($pattern, static function (array $match) use ($fmtVars) {
+            $var = trim($match[1]);
+            if ($var && isset($fmtVars[$var])) {
+                return $fmtVars[$var];
+            }
 
-        return strtr($tplCode, $fmtVars);
+            return $match[0];
+        }, $tplCode);
+    }
+
+    /**
+     * Alias of renderVars().
+     *
+     * @param string $tplCode
+     * @param array $vars
+     * @param string $format Template var format
+     *
+     * @return string
+     */
+    public static function renderTemplate(string $tplCode, array $vars, string $format = '{{%s}}'): string
+    {
+        return self::renderVars($tplCode, $vars, $format);
     }
 
     ////////////////////////////////////////////////////////////

test/Str/StringHelperTest.php

@@ -267,4 +267,22 @@ public function testSplitTypedList(): void
             $this->assertEquals($want, Str::toTypedArray($given));
         }
     }
+
+    public function testRenderVars(): void
+    {
+        $vars = [
+            'name' => 'inhere',
+            'age'  => 200,
+            'tags' => ['php'],
+            'top' => [
+                'key0' => 'val0',
+            ]
+        ];
+
+        $text = Str::renderVars('hello {{ name }}, age: {{ age}}, tags: {{ tags.0 }}, key0: {{top.key0 }}', $vars);
+        $this->assertEquals('hello inhere, age: 200, tags: php, key0: val0', $text);
+
+        $text = Str::renderVars('hello ${ name }, age: ${ age}, tags: ${ tags.0 }, key0: ${top.key0 }', $vars, '${%s}');
+        $this->assertEquals('hello inhere, age: 200, tags: php, key0: val0', $text);
+    }
 }