配置接口lang请求头

2026-03-10 11:42:39 +08:00
parent 9452fd28e2
commit 275f94f96d
8 changed files with 178 additions and 10 deletions
--- a/server/app/api/util/ApiLang.php
+++ b/server/app/api/util/ApiLang.php
@@ -0,0 +1,72 @@
+<?php
+declare(strict_types=1);
+
+namespace app\api\util;
+
+use support\Request;
+
+/**
+ * API 多语言：根据请求头 lang（en=英文，zh=中文）翻译返回文案
+ */
+class ApiLang
+{
+    private const LANG_HEADER = 'lang';
+    private const LANG_EN = 'en';
+    private const LANG_ZH = 'zh';
+
+    /** @var array<string, string>|null */
+    private static ?array $enMap = null;
+
+    /**
+     * 从请求中获取语言：lang 请求头 en=英文，zh=中文，默认 zh
+     */
+    public static function getLang(?Request $request = null): string
+    {
+        $request = $request ?? (function_exists('request') ? request() : null);
+        if ($request === null) {
+            return self::LANG_ZH;
+        }
+        $lang = $request->header(self::LANG_HEADER);
+        if ($lang !== null && $lang !== '') {
+            $lang = strtolower(trim((string) $lang));
+            if ($lang === self::LANG_EN) {
+                return self::LANG_EN;
+            }
+            if ($lang === self::LANG_ZH || $lang === 'chs') {
+                return self::LANG_ZH;
+            }
+        }
+        return self::LANG_ZH;
+    }
+
+    /**
+     * 翻译文案：当前请求语言为 en 时返回英文，否则返回原文（中文）
+     * @param string $message 中文或原文
+     * @param Request|null $request 当前请求，不传则自动取 request()
+     */
+    public static function translate(string $message, ?Request $request = null): string
+    {
+        $lang = self::getLang($request);
+        if ($lang !== self::LANG_EN) {
+            return $message;
+        }
+        if (self::$enMap === null) {
+            $path = dirname(__DIR__) . '/lang/en.php';
+            self::$enMap = is_file($path) ? (require $path) : [];
+        }
+        return self::$enMap[$message] ?? $message;
+    }
+
+    /**
+     * 带占位符的翻译，如 translateParams('当前玩家余额%s小于%s无法继续游戏', [$coin, $minCoin])
+     * 先翻译再替换（en 文案使用 %s 占位）
+     */
+    public static function translateParams(string $message, array $params = [], ?Request $request = null): string
+    {
+        $translated = self::translate($message, $request);
+        if ($params !== []) {
+            $translated = sprintf($translated, ...$params);
+        }
+        return $translated;
+    }
+}