mojiahui/dafuweng-saiadmin6.x
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

配置后台接口中英文对照

Browse Source
This commit is contained in:
zhenhui
2026-03-17 16:31:31 +08:00
parent 683bd5d97a
commit eb8123c7b3
7 changed files with 295 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files

66
server/app/api/util/ApiLang.php
View File

@@ -6,7 +6,9 @@ namespace app\api\util;
use support\Request;
/**
* API 多语言：根据请求头 lang（en=英文，zh=中文）翻译返回文案
* API 多语言（兼容 Webman 多语言配置）
* 根据请求头 lang（zh=中文，en=英文）返回对应文案；
* 无 lang 请求头时使用 config('translation.locale') 推断（zh_CN/zh→中文，en→英文）
*/
class ApiLang
{
@@ -14,35 +16,34 @@ class ApiLang
private const LANG_EN = 'en';
private const LANG_ZH = 'zh';
/** @var array<string, string>|null */
private static ?array $enMap = null;
/** @var array<string, array<string, string>> locale => [ 中文 => 译文 ] */
private static array $messages = [];
/**
* 从请求中获取语言：lang 请求头 en=英文，zh=中文，默认 zh
* 从请求中获取语言：优先读 header lang，否则按 Webman config('translation.locale') 推断
*/
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;
if ($request !== null) {
$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;
$locale = (string) (function_exists('config') ? config('translation.locale', 'zh_CN') : 'zh_CN');
return stripos($locale, 'en') !== false ? self::LANG_EN : self::LANG_ZH;
}
/**
* 翻译文案：当前请求语言为 en 时返回英文，否则返回原文（中文）
* @param string $message 中文或原文
* @param Request|null $request 当前请求，不传则自动取 request()
* 翻译文案：lang=zh 返回原文（中文），lang=en 返回英文映射
* 语言文件优先从 Webman resource/translations/api/{locale}.php 加载，否则从 app/api/lang 加载
*/
public static function translate(string $message, ?Request $request = null): string
{
@@ -50,11 +51,30 @@ class ApiLang
if ($lang !== self::LANG_EN) {
return $message;
}
if (self::$enMap === null) {
$path = dirname(__DIR__) . '/lang/en.php';
self::$enMap = is_file($path) ? (require $path) : [];
$map = self::loadMessages(self::LANG_EN);
return $map[$message] ?? $message;
}
/**
* 加载某语言的 API 文案（key=中文，value=译文）
*/
private static function loadMessages(string $locale): array
{
if (isset(self::$messages[$locale])) {
return self::$messages[$locale];
}
return self::$enMap[$message] ?? $message;
$path = null;
if (function_exists('config')) {
$base = rtrim((string) config('translation.path', ''), DIRECTORY_SEPARATOR);
if ($base !== '') {
$path = $base . DIRECTORY_SEPARATOR . 'api' . DIRECTORY_SEPARATOR . $locale . '.php';
}
}
if (($path === null || !is_file($path)) && $locale === self::LANG_EN) {
$path = dirname(__DIR__) . DIRECTORY_SEPARATOR . 'lang' . DIRECTORY_SEPARATOR . 'en.php';
}
self::$messages[$locale] = ($path !== null && is_file($path)) ? (require $path) : [];
return self::$messages[$locale];
}
/**