TP5函数文件如何写多语言-ThinkPHP-PHP中文网

tp5的common.php中不能直接调用lang()，因其加载早于语言环境初始化；应使用l()函数，但需确保lang_switch_on为true、allow_lang_list包含当前语言、语言包路径为application/lang/zh-cn.php且文件合法。

tp5函数文件如何写多语言

TP5 的 `common.php` 里不能直接写 `lang()`

ThinkPHP 5.x 的 application/common.php 是全局函数文件，加载时机早于语言包初始化，此时 lang() 函数尚未可用，也未设置语言环境。直接在里面调用 lang('xxx') 会报错或返回原 key 字符串。

常见错误现象：页面空白、Call to undefined function lang()、或输出 'login_failed' 而非翻译内容。

TP5 中真正可用的语言函数是 L()（lang() 是 TP6+ 主推，TP5 不原生支持）
L() 在 TP5 中是全局函数，无需提前 setLang，但依赖 lang_switch_on => true 和自动探测机制
common.php 可安全使用 L()，前提是语言配置已生效且语言包路径正确

TP5 的 `common.php` 多语言写法示例

在 application/common.php 中定义带语言支持的辅助函数时，应封装 L() 调用，而非硬编码中文：

function show_status($code) {
    $map = [
        'success' => L('operation_success'),
        'fail'    => L('operation_failed'),
        'pending' => L('pending_review'),
    ];
    return $map[$code] ?? L('unknown_status');
}

对应语言包需存在：application/lang/zh-cn.php（或 zh-cn/common.php，取决于 TP5 版本和配置），内容为：

vika维格云

vika维格云是一款AI数据处理工具，智能多维表格和数据生产力平台。

下载

<?php return [
    'operation_success' => '操作成功',
    'operation_failed'  => '操作失败',
    'pending_review'    => '待审核',
    'unknown_status'    => '未知状态',
];

为什么 `common.php` 里用 `L()` 有时仍不生效

即使写了 L()，也可能静默返回原 key —— 这不是函数问题，而是环境没就位：

lang_switch_on 必须为 true，且在 config.php 或模块配置中启用
default_lang 和 allow_lang_list 需显式配置，例如：'allow_lang_list' => ['zh-cn', 'en-us']
语言包路径必须是 application/lang/zh-cn.php（TP5.0/5.1 常用单文件模式）或 application/lang/zh-cn/common.php（部分定制版），注意大小写
TP5 默认不自动加载 common.php 中的语言包，L() 会在首次调用时尝试按当前检测到的语言码加载，若路径错或文件不存在，就 fallback 到原字符串