🌐 多语言

// 如果只支持中文
echo "欢迎使用";  // 中国用户能看懂

// 但外国用户看不懂，需要多语言
echo lang('welcome');  // 根据用户语言自动显示
// 中文用户看到：欢迎使用
// 英文用户看到：Welcome

// ❌ 不推荐：直接写死文本
echo "欢迎使用";

// ✅ 推荐：使用语言键
echo lang('welcome');

<?php
// app/admin/lang/zh-cn.php（中文语言包）
return [
    'welcome' => '欢迎使用',
    'login_success' => '登录成功',
];

// app/admin/lang/en-us.php（英文语言包，必须放在应用语言包目录下）
return [
    'welcome' => 'Welcome',
    'login_success' => 'Login Success',
];

// 用户选择中文
// 系统加载 app/admin/lang/zh-cn.php
echo lang('welcome');  // 输出：欢迎使用

// 用户选择英文
// 系统加载 app/admin/lang/en-us.php（应用语言包）
echo lang('welcome');  // 输出：Welcome

<?php
// app/admin/lang/zh-cn.php（后台管理应用）
return [
    'user_management' => '用户管理',
    'add_user' => '添加用户',
    'edit_user' => '编辑用户',
    'delete_user' => '删除用户',
    'user_list' => '用户列表',
];

// app/index/lang/zh-cn.php（前台应用）
return [
    'user_management' => '个人中心',  // 相同的键，不同的值
    'add_user' => '注册账号',
    'edit_user' => '修改资料',
    'delete_user' => '注销账号',
    'user_list' => '我的信息',
];

<?php
// 在 admin 应用中
echo lang('user_management');  // 输出：用户管理

// 在 index 应用中
echo lang('user_management');  // 输出：个人中心（不同的文本）

<?php
// 在后台数据字典中查看
// 系统管理 → 数据字典 → 查找 type = '英文字典' 或 '英文菜单'

<?php
// app/admin/lang/en-us.php（英文语言包）
use think\admin\model\SystemBase;

// 从数据字典读取英文字典（已有类型，直接使用）
$customLangs = [];
if (count($items = SystemBase::items('英文字典')) > 0) {
    $customLangs = array_column($items, 'name', 'code');
}

// 从数据字典读取英文菜单（已有类型，直接使用）
// ⚠️ 注意：字典和菜单必须同时读取，否则语言切换不完整
if (count($items = SystemBase::items('英文菜单')) > 0) {
    $menus = array_column($items, 'name', 'code');
    foreach ($menus as $key => $name) {
        $customLangs["menus_{$key}"] = $name;
    }
}

// 合并静态翻译和动态翻译
return array_merge([
    // 静态翻译内容
    'welcome' => 'Welcome',
    'login_success' => 'Login Success',
    // ... 其他静态翻译
], $customLangs);  // 合并从数据字典读取的翻译（包括字典和菜单）

<?php
// app/admin/lang/ja-jp.php（日文语言包）
use think\admin\model\SystemBase;

// 从数据字典读取日文字典（需要先在数据字典中创建"日文字典"类型）
$customLangs = [];
if (count($items = SystemBase::items('日文字典')) > 0) {
    $customLangs = array_column($items, 'name', 'code');
}

// 从数据字典读取日文菜单（需要先在数据字典中创建"日文菜单"类型）
if (count($items = SystemBase::items('日文菜单')) > 0) {
    $menus = array_column($items, 'name', 'code');
    foreach ($menus as $key => $name) {
        $customLangs["menus_{$key}"] = $name;
    }
}

return array_merge([
    'welcome' => 'ようこそ',
    'login_success' => 'ログイン成功',
], $customLangs);

<?php
// app/admin/lang/ko-kr.php（韩文语言包）
use think\admin\model\SystemBase;

// 从数据字典读取韩文字典（需要先在数据字典中创建"韩文字典"类型）
$customLangs = [];
if (count($items = SystemBase::items('韩文字典')) > 0) {
    $customLangs = array_column($items, 'name', 'code');
}

return array_merge([
    'welcome' => '환영합니다',
    'login_success' => '로그인 성공',
], $customLangs);

<?php
// 直接使用数据字典中的 code 作为语言键
echo lang('welcome');  
// 系统会从语言包中查找，如果语言包中读取了数据字典，则返回对应的翻译

<?php
return [
    // 默认语言
    'default_lang'    => 'zh-cn',
    
    // 允许的语言列表（必须配置）
    'allow_lang_list' => ['zh-cn', 'en-us'],
    
    // 转义为对应语言包名称（lang 映射关系）
    'accept_language' => [
        'en'         => 'en-us',      // URL 参数 ?lang=en 映射到 en-us
        'zh-hans-cn' => 'zh-cn',      // 浏览器语言 zh-hans-cn 映射到 zh-cn
    ],
    
    // 多语言自动侦测变量名（URL 参数名）
    'detect_var'      => 'lang',
    
    // 多语言 Cookie 变量
    'cookie_var'      => 'lang',
    
    // 多语言 Header 变量
    'header_var'      => 'lang',
    
    // 使用 Cookie 记录
    'use_cookie'      => true,
    
    // 是否支持语言分组
    'allow_group'     => false,
    
    // 扩展语言包
    'extend_list'     => [],
];

<?php
// app/admin/lang/zh-cn.php
// 后台管理应用的中文语言包

return [
    // 用户管理相关
    'user_management' => '用户管理',
    'add_user' => '添加用户',
    'edit_user' => '编辑用户',
    'delete_user' => '删除用户',
    'user_list' => '用户列表',
    'user_detail' => '用户详情',
    
    // 权限管理相关
    'permission_management' => '权限管理',
    'role_management' => '角色管理',
    'menu_management' => '菜单管理',
    
    // 系统配置相关
    'system_config' => '系统配置',
    'site_config' => '站点配置',
    'email_config' => '邮件配置',
];

<?php
// app/admin/lang/en-us.php
// 后台管理应用的英文语言包（支持从数据字典动态读取）

use think\admin\model\SystemBase;

// 从数据字典读取英文字典（已有类型，直接使用）
$customLangs = [];
if (count($items = SystemBase::items('英文字典')) > 0) {
    $customLangs = array_column($items, 'name', 'code');
}

// 合并静态翻译和动态翻译
return array_merge([
    // 静态翻译内容
    'user_management' => 'User Management',
    'add_user' => 'Add User',
    'edit_user' => 'Edit User',
    'delete_user' => 'Delete User',
    'user_list' => 'User List',
    'user_detail' => 'User Detail',
    
    // 权限管理相关
    'permission_management' => 'Permission Management',
    'role_management' => 'Role Management',
    'menu_management' => 'Menu Management',
    
    // 系统配置相关
    'system_config' => 'System Config',
    'site_config' => 'Site Config',
    'email_config' => 'Email Config',
], $customLangs);  // 合并从数据字典读取的翻译（包括字典和菜单）

<?php
// app/admin/controller/User.php
namespace app\admin\controller;

use think\admin\Controller;

class User extends Controller
{
    public function index()
    {
        // 使用应用语言包
        $this->title = lang('user_management');  // 输出：用户管理（中文）或 User Management（英文）
        
        // 在模板中也会自动使用应用语言包
        return $this->fetch();
    }
}

<?php
// app/admin/lang/zh-cn.php（后台管理）
return [
    'user_center' => '用户管理中心',
    'user_list' => '用户列表',
];

// app/index/lang/zh-cn.php（前台应用）
return [
    'user_center' => '个人中心',  // 相同的键，不同的值
    'user_list' => '我的信息',
];

<?php
// 在 admin 应用中
echo lang('user_center');  // 输出：用户管理中心

// 在 index 应用中
echo lang('user_center');  // 输出：个人中心（不同的文本）

<?php
// 在后台数据字典中查看
// 系统管理 → 数据字典 → 查找 type = '英文字典'

<?php
// 在英文语言包中，英文字典会自动合并到语言包中
// 直接使用中文原文作为键即可
echo lang('欢迎使用');  // 输出：Welcome（从数据字典读取）

// 实际应用：将中文菜单翻译为英文
$menu = '用户管理';
$menuEn = lang($menu);  // 从数据字典查找翻译

<?php
// 在后台数据字典中查看
// 系统管理 → 数据字典 → 查找 type = '英文菜单'

<?php
// 在英文语言包文件中，英文菜单会自动合并到语言包中
// 使用 menus_ 前缀访问菜单翻译
// 这是专门用于后台管理系统菜单的翻译
echo lang('menus_admin/user/index');  // 输出：User Management

// 注意：英文菜单数据会自动从数据字典读取并合并到语言包中
// 在 think-library/src/lang/en-us.php 文件中可以看到相关实现
// 系统会将 code 作为键，name 作为值，并添加 menus_ 前缀
// 这些翻译专门用于后台管理系统的菜单栏显示（如左侧导航菜单、顶部菜单等）

<?php
// app/admin/lang/en-us.php（英文语言包）
use think\admin\Library;
use think\admin\model\SystemBase;

// 动态读取英文字典数据字典（带缓存优化）
if (count($customLangs = Library::$sapp->cache->get('lang-custom-en', [])) < 1) {
    // 从数据字典读取英文字典（已有类型，直接使用）
    $customLangs = array_column(SystemBase::items('英文字典'), 'name', 'code');
    
    // 从数据字典读取英文菜单（已有类型，直接使用）
    $menus = array_column(SystemBase::items('英文菜单'), 'name', 'code');
    foreach ($menus as $key => $name) {
        $customLangs["menus_{$key}"] = $name;
    }
    
    Library::$sapp->cache->set('lang-custom-en', $customLangs, 360);
}

// 合并静态翻译和动态翻译
return array_merge([
    // 静态翻译内容
    'welcome' => 'Welcome',
    'login_success' => 'Login Success',
    // ... 其他静态翻译
], $customLangs);  // 合并从数据字典读取的翻译（包括字典和菜单）

<?php
// 直接使用数据字典中的 code 作为语言键
echo lang('welcome');  // 输出：Welcome to Our System（从数据字典读取）
echo lang('login');     // 输出：Please Login（从数据字典读取）

// 如果找不到对应的翻译，会先回退到中文语言包查找
// 如果中文语言包中也找不到，才会返回语言键本身
echo lang('not_found');  // 先查找 en-us.php，找不到则查找 zh-cn.php，都找不到则返回 'not_found'

lang(string $name, array $vars = [], string $lang = '')

<?php
declare(strict_types=1);

namespace app\admin\controller;

use think\admin\Controller;

class Example extends Controller
{
    public function index()
    {
        // 基本用法：获取语言包
        $message = lang('welcome');
        // 如果当前语言是中文，输出：欢迎使用
        // 如果当前语言是英文，输出：Welcome
        
        // 指定语言：强制使用指定语言
        $messageEn = lang('welcome', [], 'en-us');
        // 无论当前语言是什么，都返回英文翻译
        
        // 带参数：使用占位符替换
        $info = lang('welcome_user', ['name' => '张三']);
        // 语言包定义：'welcome_user' => '欢迎，{name}！'
        // 输出：欢迎，张三！
        
        // 指定语言并带参数
        $infoEn = lang('welcome_user', ['name' => 'John'], 'en-us');
        // 输出：Welcome, John!
        
        // 回退机制说明：
        // 1. 系统会先查找当前语言的语言包文件（如 app/admin/lang/en-us.php）
        // 2. 如果当前语言包中找不到翻译，会自动回退到中文语言包（app/admin/lang/zh-cn.php）查找
        // 3. 如果中文语言包中也找不到，才会返回语言键本身
        // 这样可以确保即使某些语言包不完整，也能显示中文内容
        
        // 传递给模板
        $this->assign([
            'message' => $message,
            'messageEn' => $messageEn,
            'info' => $info,
            'infoEn' => $infoEn,
        ]);
        
        return $this->fetch();
    }
}

<?php
declare(strict_types=1);

namespace app\admin\controller;

use think\admin\Controller;
use think\facade\Lang;

class Example extends Controller
{
    public function index()
    {
        // 基本用法
        $message = Lang::get('welcome');
        
        // 指定语言：强制使用指定语言
        $messageEn = Lang::get('welcome', [], 'en-us');
        // 无论当前语言是什么，都返回英文翻译
        
        // 带参数
        $info = Lang::get('welcome_user', ['name' => 'John'], 'en-us');
        
        // 带默认值
        $title = Lang::get('page_title', [], 'zh-cn', '默认标题');
        
        return $this->fetch();
    }
}

<?php
// app/admin/lang/zh-cn.php
return [
    'welcome' => '欢迎使用',
    'login_success' => '登录成功',
    'button_save' => '保存',
];

<?php
// app/admin/lang/zh-cn.php
return [
    // 单个参数
    'welcome_user' => '欢迎，{name}！',
    
    // 多个参数
    'user_count' => '共有 {count} 个用户，其中 {active} 个活跃用户',
    
    // 实际使用
    // lang('welcome_user', ['name' => '张三'])
    // 输出：欢迎，张三！
    
    // lang('user_count', ['count' => 100, 'active' => 80])
    // 输出：共有 100 个用户，其中 80 个活跃用户
];

<?php
// app/admin/lang/zh-cn.php
return [
    // 一级键
    'menu' => [
        'user' => '用户管理',
        'role' => '角色管理',
        'permission' => '权限管理',
    ],
    
    'button' => [
        'save' => '保存',
        'cancel' => '取消',
        'delete' => '删除',
    ],
];

// 使用嵌套语言包
// lang('menu.user')        // 输出：用户管理
// lang('button.save')      // 输出：保存
// lang('menu.role')         // 输出：角色管理

<?php
// app/admin/lang/zh-cn.php
return [
    // 简单键值对
    'welcome' => '欢迎使用',
    
    // 带参数
    'welcome_user' => '欢迎，{name}！',
    
    // 嵌套数组
    'menu' => [
        'user' => '用户管理',
        'role' => '角色管理',
    ],
    
    // 嵌套数组中也支持参数
    'message' => [
        'user_added' => '用户 {name} 已添加',
        'user_deleted' => '用户 {name} 已删除',
    ],
];

// 使用示例
// lang('welcome')                           // 输出：欢迎使用
// lang('welcome_user', ['name' => '张三'])  // 输出：欢迎，张三！
// lang('menu.user')                         // 输出：用户管理
// lang('message.user_added', ['name' => '李四'])  // 输出：用户 李四 已添加

<?php
// app/admin/lang/zh-cn.php
return [
    // 单个参数
    'welcome_user' => '欢迎，{name}！',
    
    // 多个参数
    'user_info' => '用户 {name}，年龄 {age} 岁，来自 {city}',
    
    // 参数可以重复使用
    'user_message' => '{name} 给 {name} 发送了消息',
];

<?php
// 单个参数
echo lang('welcome_user', ['name' => '张三']);
// 输出：欢迎，张三！

// 多个参数
echo lang('user_info', [
    'name' => '李四',
    'age' => 25,
    'city' => '北京'
]);
// 输出：用户 李四，年龄 25 岁，来自 北京

// 参数重复使用
echo lang('user_message', ['name' => '王五']);
// 输出：王五 给 王五 发送了消息

<?php
// 在控制器中切换语言
use think\facade\Lang;

// 切换到英文
Lang::setLangSet('en-us');

// 切换到中文
Lang::setLangSet('zh-cn');

<?php
// 访问：http://domain.com/admin/index?lang=en
// 系统会自动：
// 1. 读取 URL 参数 lang=en
// 2. 根据 config/lang.php 中的 accept_language 映射关系
//    将 'en' 映射到 'en-us'
// 3. 检查 'en-us' 是否在 allow_lang_list 中
// 4. 如果允许，则切换到 en-us 语言包
// 5. 如果启用 use_cookie，会保存到 Cookie 中

// 无需在控制器中手动处理，系统会自动切换
public function index()
{
    // 系统已自动切换语言，直接使用即可
    echo lang('welcome');  // 根据当前语言显示对应文本
}

<?php
// 用户浏览器语言为 en-US
// 系统会自动：
// 1. 检测浏览器 Accept-Language 头
// 2. 根据 accept_language 映射关系将浏览器语言转换为对应的语言包名称（如 en-US 映射到 en-us）
// 3. 如果映射后的语言不在 allow_lang_list 中，使用默认语言

<?php
// app/admin/lang/ja-jp.php
return [
    'welcome' => 'ようこそ',
    'login_success' => 'ログイン成功',
];

<?php
// 支持但不推荐：嵌套过深
return [
    'level1' => [
        'level2' => [
            'level3' => [
                'level4' => '值'  // 不推荐
            ]
        ]
    ]
];

// 推荐：保持 2-3 层
return [
    'menu' => [
        'user' => '用户管理',  // 2 层，推荐
    ],
];