发布于2026-07-17 阅读(0)
扫一扫,手机访问
在 CentOS 上部署 ThinkPHP 的多语言支持,其实比你想象的要简单。只要把几个关键环节理清楚,后面就像搭积木一样顺畅。下面咱们一步步来,先看整体流程。

动手之前,先确认环境里有没有 ThinkPHP。如果还没装,用 Composer 拉一个最新版本下来就行,命令很简单:
composer create-project topthink/think=latest-version your_project_name
cd your_project_name
装好之后,项目目录就建起来了,后续所有操作都在这个目录里进行。
ThinkPHP 对多语言的支持很友好,核心就是两个东西:配置文件和语言包。你只需要告诉框架默认语言是什么,语言包放在哪,剩下的交给它就行。
打开 application/config.php,找到或添加下面这两项:
return [
// 默认语言
'default_locale' => 'zh-cn',
// 语言包路径
'locale_path' => APP_PATH . 'language',
];
这里把默认语言设为中文(zh-cn),语言包路径指向 application/language 目录。当然,你可以根据实际需求改成其他语言。
在 application/language 目录下,按语言建子文件夹。比如中英文,就分别建 zh-cn 和 en-us:
mkdir -p application/language/zh-cn
mkdir -p application/language/en-us
每个文件夹里放一个 config.php 文件,里面定义该语言对应的字符串。以中文为例:
return [
'welcome' => '欢迎来到ThinkPHP',
// 其他配置项...
];
英文版就写成:
return [
'welcome' => 'Welcome to ThinkPHP',
// 其他配置项...
];
注意,语言包里的键名必须保持一致,这样框架才能根据当前语言自动取出对应的值。
在控制器或视图里,想拿到当前语言的字符串,直接用 __() 函数就行了。这个函数会自动根据当前语言设置去查找对应的语言包内容。
namespace app\index\controller;
use think\Controller;
class Index extends Controller
{
public function index()
{
$this->assign('welcome_message', __('welcome'));
return $this->fetch();
}
}
这里把语言包里的 welcome 键值赋给了模板变量 welcome_message。
在模板文件(比如 application/index/view/index/index.html)里,直接输出变量:
{: $welcome_message}
这样页面就会根据当前语言显示对应的欢迎语。
用户想切换语言怎么办?通常有两种方式:通过 URL 参数或者 Session。下面以 URL 参数为例,演示一个完整的切换流程。
在 route/route.php 里加一条路由规则:
use think\Route;
Route::get('lang/:lang', 'index/Index/lang');
这条规则的意思是:当用户访问 /lang/zh-cn 或 /lang/en-us 时,交给 Index 控制器的 lang 方法处理。
在 Index 控制器里加上处理语言切换的方法:
namespace app\index\controller;
use think\Controller;
use think\Request;
class Index extends Controller
{
public function lang(Request $request)
{
$lang = $request->param('lang');
if (in_array($lang, ['zh-cn', 'en-us'])) {
session('locale', $lang);
}
return redirect()->back();
}
}
逻辑很简单:拿到 URL 参数中的语言代码,如果合法就存入 Session,然后跳回上一页。这样后续请求就能从 Session 中读取语言设置。
在模板里添加两个切换按钮:
中文
English
点击后就会触发上面定义的路由,完成语言切换。
启动应用服务器(比如用 php artisan serve),然后访问首页,看看默认显示的是中文还是英文。接着点击语言切换链接,页面应该能立即切换语言。如果一切正常,那恭喜你,多语言支持已经稳稳地跑起来了。
整个流程走下来,你会发现 ThinkPHP 的多语言机制其实很轻量,没有太多弯弯绕绕。只要把语言包整理好,切换逻辑写清楚,后续扩展新语言也就是加个文件夹、写个配置文件的事。
售后无忧
立即购买>office旗舰店
售后无忧
立即购买>office旗舰店
售后无忧
立即购买>office旗舰店
售后无忧
立即购买>office旗舰店
正版软件
正版软件
正版软件
正版软件
正版软件
1
2
3
7
8