Add langParam method

Author: carry0987

example.php

@@ -21,12 +21,22 @@
     )
 );
 
+// Get current date
+$currentDate = new DateTime();
+$year = $currentDate->format('Y'); // YYYY
+$month = $currentDate->format('m'); // MM
+$day = $currentDate->format('d'); // dd
+
+// Example usage
+$params = [$year, $month, $day];
+
 try {
     $i18n = new I18n($config);
     $i18n->setLangAlias(array('en_US' => 'English', 'zh_TW' => '繁體中文'));
     echo '<h2>Fetch \'hello\' from \'greeting.json\'</h2>';
     echo $i18n->fetch('greeting.hello');
-    echo $i18n->fetch('greeting.world');
+    echo $i18n->fetch('greeting.world').'<br>';
+    echo $i18n->fetch('general.today', $params);
     echo '<h2>Fetch Current Language</h2>';
     echo $i18n->fetchCurrentLang();
     echo '<h2>Fetch List</h2>';

lang/en_US/general.json

@@ -1,3 +1,4 @@
 {
-    "welcome_message": "Welcome to I18n!"
+    "welcome_message": "Welcome to I18n!",
+    "today": "Today is {0}/{1}/{2}"
 }

lang/zh_TW/general.json

@@ -1,3 +1,4 @@
 {
-    "welcome_message": "歡迎使用I18n!"
+    "welcome_message": "歡迎使用I18n!",
+    "today": "今天是{0}/{1}/{2}"
 }

src/I18n.php

@@ -74,7 +74,7 @@ public function getLangAlias(): array
         return $this->fetchLangList();
     }
 
-    public function fetch(string $key): ?string
+    public function fetch(string $key, ?array $param = null): ?string
     {
         if (!$this->initialized) {
             throw new InitializationException('I18n class must be initialized before using fetch().');
@@ -86,6 +86,10 @@ public function fetch(string $key): ?string
             $value = $this->languageLoader->getValue(self::$option['defaultLang'], $key);
         }
 
+        if ($param !== null) {
+            $value = self::langParam($value, $param);
+        }
+
         return $value;
     }
 
@@ -116,6 +120,18 @@ public function fetchCurrentLang(): string
         return $this->currentLang;
     }
 
+    public static function langParam(string $value, array $param): string
+    {
+        $replacements = [];
+
+        // Construct replacement array
+        foreach ($param as $index => $p) {
+            $replacements['{' . $index . '}'] = $p; // Placeholder as key
+        }
+
+        return strtr($value, $replacements);
+    }
+
     private function validateLanguageFolder(string $folder): string
     {
         $folderPath = self::$option['langFilePath'].Utils::DIR_SEP.$folder;