在Debian系统上为ThinkPHP应用添加多语言支持，其实是一个既系统又灵活的过程。遵循清晰的步骤，可以让你轻松地管理不同语言的文本内容。下面这张图概括了核心的操作流程：

1. 安装ThinkPHP

一切的基础，自然是先有一个ThinkPHP项目。如果你的Debian服务器上还没有，使用Composer来创建是最快捷的方式：

composer create-project topthink/think your_project_name
cd your_project_name

2. 配置多语言支持

ThinkPHP内置的多语言功能相当友好，其核心在于配置文件和语言包的组织。

2.1 配置文件

打开项目中的 application/config.php 文件，找到或添加以下配置项。这里定义了默认语言以及各个语言包文件的存放路径：

return [
    // 默认语言
    'default_locale' => 'zh-cn',
    // 语言包路径
    'locale_list' => [
        'zh-cn' => APP_PATH . 'language/zh-cn.php',
        'en-us' => APP_PATH . 'language/en-us.php',
    ],
];

2.2 创建语言包

接下来，需要在 application/language 目录下创建上一步配置中对应的语言文件。例如，我们创建两个：

• zh-cn.php （简体中文）
• en-us.php （美式英语）

文件内容就是简单的键值对数组，键名保持一致，值则是对应的翻译文本：

zh-cn.php

 '欢迎来到ThinkPHP',
    'hello'   => '你好，ThinkPHP',
];

en-us.php

 'Welcome to ThinkPHP',
    'hello'   => 'Hello, ThinkPHP',
];

3. 使用多语言

配置好语言包后，就可以在代码中调用了。ThinkPHP提供了在控制器和视图中使用的多种方式。

3.1 在控制器中使用

namespace app\index\controller;

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

class Index extends Controller
{
    public function index()
    {
        // 手动加载指定语言包
        Lang::load('zh-cn');
        // 或者，更常见的做法是使用配置的默认语言，直接调用 Lang::load() 即可

        return $this->fetch();
    }
}

3.2 在视图中使用

在模板文件中，使用 {:__(‘键名’)} 的语法来输出翻译后的文本，这非常直观：

{:__(‘welcome’)}
{:__(‘hello’)}

4. 切换语言

一个完整的多语言应用，必然要允许用户动态切换。这通常通过会话（Session）来记录用户的选择。

4.1 在控制器中切换语言

namespace app\index\controller;

use think\Controller;
use think\facade\Session;
use think\facade\Lang;

class Index extends Controller
{
    public function index()
    {
        // 从Session中获取用户选择的语言，默认为‘zh-cn’
        $currentLang = Session::get('lang', 'zh-cn');
        Lang::load($currentLang); // 加载对应的语言包

        return $this->fetch();
    }

    // 一个用于设置语言的方法
    public function setLang($lang)
    {
        // 安全起见，限定可切换的语言范围
        if (in_array($lang, ['zh-cn', 'en-us'])) {
            Session::set('lang', $lang);
        }
        // 设置完成后，跳转回上一页
        return redirect()->back();
    }
}

4.2 在视图中添加语言切换链接

最后，在页面上提供切换入口，比如两个链接或按钮，它们会触发上面定义的 setLang 方法：

中文
English

5. 测试

所有代码就绪后，是时候验证成果了。在项目根目录启动内置服务器：

php think run

访问你的应用页面。现在，你应该能看到根据当前语言显示的不同文本，并且点击“中文”或“English”链接，页面内容应该能够即时切换。

遵循以上步骤，在Debian上为ThinkPHP搭建一套可用的多语言支持体系就完成了。整个过程结构清晰，从安装、配置到使用和动态切换，每一步都环环相扣，易于管理和扩展。