up: ftb add new method for quick replace tpl vars

Author: inhere

src/Extra/FileTreeBuilder.php

@@ -295,6 +295,50 @@ public function dirFiles(string $name, string ...$files): self
         });
     }
 
+    /**
+     * Simple render template by replace template vars.
+     *
+     * - not support expression on template.
+     *
+     * @param string $tplFile
+     * @param array $tplVars
+     *
+     * @return $this
+     */
+    public function replaceVars(string $tplFile, array $tplVars = []): static
+    {
+        Assert::notBlank($tplFile);
+
+        $dstFile = $this->getRealpath($tplFile);
+        if (!File::isAbsPath($tplFile)) {
+            $tplFile = $this->tplDir . '/' . $tplFile;
+        }
+
+        $this->printMsgf('replace vars: %s', $tplFile);
+        $this->doReplace($tplFile, $dstFile, $tplVars);
+
+        return $this;
+    }
+
+    /**
+     * @param string $tplFile
+     * @param string $dstFile
+     * @param array $tplVars
+     *
+     * @return void
+     */
+    protected function doReplace(string $tplFile, string $dstFile, array $tplVars = []): void
+    {
+        if (!$this->dryRun) {
+            if ($this->tplVars) {
+                $tplVars = array_merge($this->tplVars, $tplVars);
+            }
+
+            $content = Str::renderTemplate(File::readAll($tplFile), $tplVars);
+            File::putContents($dstFile, $content);
+        }
+    }
+
     /**
      * Render template files by glob match.
      *
@@ -360,15 +404,15 @@ public function tplFile(string $tplFile, string $dstFile = '', array $tplVars =
         }
 
         $this->printMsgf('render file: %s', $tplFile);
-        if ($this->tplVars) {
-            $tplVars = array_merge($this->tplVars, $tplVars);
-        }
 
         return $this->doRender($tplFile, $dstFile, $tplVars);
     }
 
     /**
-     * Do render template file
+     * Do render template file with vars
+     *
+     * - should support expression on template.
+     * - TIP: recommended use package: phppkg/easytpl#EasyTemplate
      *
      * @param string $tplFile
      * @param string $dstFile
@@ -378,11 +422,7 @@ public function tplFile(string $tplFile, string $dstFile = '', array $tplVars =
      */
     protected function doRender(string $tplFile, string $dstFile, array $tplVars = []): self
     {
-        if (!$this->dryRun) {
-            $content = Str::renderTemplate(File::readAll($tplFile), $tplVars);
-
-            File::putContents($dstFile, $content);
-        }
+        $this->doReplace($tplFile, $dstFile, $tplVars);
 
         return $this;
     }
@@ -421,6 +461,8 @@ public function backPrev(): self
     }
 
     /**
+     * get realpath relative the workdir
+     *
      * @param string $path
      *
      * @return string