ThinkPHP分页实战：多语言站点中分页链接的本地化处理-ThinkPHP-PHP中文网

根本原因是paginate()只解析page和list_rows，不自动处理lang参数；必须手动通过query透传lang、where过滤语言、缓存key含语言、render前用lang::get()翻译文案，并显式指定page参数以避免重复解析。

thinkphp分页实战：多语言站点中分页链接的本地化处理

ThinkPHP 多语言分页链接掉回默认语言，根本原因不是语言没设好，而是 paginate() 根本不认 lang 参数——它只解析 page 和 list_rows，其他全靠你手动塞。

为什么分页一翻页就变中文（或变英文）？

因为 render() 生成的上一页/下一页链接里没带 lang=zh-cn 这类参数。即使 Lang::setLocale('ja-jp') 已生效，链接本身不含语言标识，浏览器点过去就是裸 ?page=2，框架只能 fallback 到 app.default_lang。

常见错误写法：
User::where('status', 1)->paginate(15) —— 没传 query，lang 彻底丢失
input('lang') 直接写死在 where 里，但没透传到分页链接中

语言来源可能是 URL、cookie、session 或 header，但 paginate() 不自动读取其中任何一个
appends(['lang' => 'en-us']) 看似可行，但若用户本来是通过 ?lang=fr-fr&keyword=abc 进来的，appends 会覆盖掉 keyword，搜索条件反而丢了
漏掉 false 第二个参数（即关闭自动解析 URL）会导致 page 被重复提取，比如 ?page=2&lang=de 可能被当成第 4 页

必须显式传入 `query` 参数并过滤 `page`

正确做法是：先统一取当前语言值，再把它和其他有效查询参数一起塞进 query 数组，同时确保 page 键由 input('page/d', 1) 显式控制。

示例代码：

实现基于qmt智能交易终端的A股交易数据本地化

基于QMT平台，支持自然语言指令下载并实时监控A股多周期历史行情，含智能错误处理与任务控制。

下载

$lang = input('lang', config('app.default_lang'));
$users = User::where('lang', $lang)
    ->paginate(15, false, [
        'page' => input('page/d', 1),
        'query' => array_merge(
            array_diff_key(input(), ['page' => '']),
            ['lang' => $lang]
        ),
    ]);

array_diff_key(input(), ['page' => '']) 是为了安全剔除原始 page，避免和上面显式的 'page' => ... 冲突
如果语言来自 session，就用 session('lang', config('app.default_lang')) 替代 input('lang', ...)，再同样塞进 query
query 里的键名必须和你实际需要的 URL 参数名一致，比如用 locale 就写 ['locale' => $lang]，不能硬套 lang

`render()` 前必须用 `lang::get()` 翻译文案

分页 HTML 中的“上一页”“共 12 页”等文字不会自动走多语言翻译。如果你模板里直接写 @#@#@#@#@#@#@#@#@#@0，切换语言后这些字永远是英文。

ThinkPHP 的 render() 默认模板用的是内置字符串，不经过 Lang::get()。所以要么重写模板，要么在调用前临时替换文案：

$users->setConfig([
    'prev_page' => lang::get('Previous'),
    'next_page' => lang::get('Next'),
    'first_page' => lang::get('First'),
    'last_page' => lang::get('Last'),
    'total_rows' => lang::get('Total %d rows'),
]);
echo $users->render();

所有文案必须提前定义在对应语言的 lang/zh-cn.php 或 lang/en-us.php 里，否则返回空字符串
像 "Page %d of %d" 这种带占位符的，要用 sprintf(lang::get('Page %d of %d'), $users->currentPage(), $users->lastPage())，不能拼字符串
别在视图层用 __('Previous') 这类函数——render() 输出的是已渲染完的 HTML 字符串，不是模板变量