PHP多语言应使用gettext而非硬编码数组，需setlocale、bindtextdomain、textdomain三步初始化；_()和ngettext()用于模板，xgettext自动生成.po文件，新增字符串后须重新提取并合并翻译。

用 gettext 做多语言，别硬编码字符串

PHP 动态网站做多语言，最稳妥的方式是用系统级的 gettext，而不是自己写数组映射或 JSON 翻译包。它支持复数、上下文、区域设置切换，且被 Apache/Nginx 和大多数 Linux 发行版原生支持。
关键点：必须用 setlocale(LC_ALL, $locale) + bindtextdomain() + textdomain() 三步配齐，缺一不可；否则 _() 函数始终返回原文。
常见错误现象：gettext 返回空字符串或原文，大概率是 .mo 文件路径不对、文件权限不足（Web 进程需可读）、或 locale 名字拼错（比如用了 zh_CN.utf8 却没在系统里启用）。

$_SESSION['lang'] 控制语言切换，但别只靠它存状态

用户点击语言切换按钮时，把选中的语言代码（如 en_US、zh_CN）存进 $_SESSION['lang'] 是常规操作，但要注意三点：

• 每次请求开头必须先 session_start()，否则 $_SESSION 不可用
• 语言参数应同时写入 cookie（带 SameSite=Lax），避免 session 失效后语言重置
• URL 中显式带 ?lang=xx_XX 更可靠，可作为 fallback，比如用户首次访问时从 $_SERVER['HTTP_ACCEPT_LANGUAGE'] 解析后跳转一次

模板中用 _() 和 ngettext()，别用 echo $lang['xxx']

硬编码语言数组（如 $lang = ['home' => '首页', 'about' => '关于'];）看似简单，实际维护成本极高：新增语言要改所有数组、无法处理复数（如 “1 file” / “3 files”）、不能适配 RTL 布局、IDE 无法提示缺失翻译项。
正确做法是在 HTML 模板里直接调用：

生成 .po 文件要用 xgettext，别手写

翻译源文件（.po）必须由工具自动生成，否则极易漏项、格式错乱、msgid 重复。
命令示例：

xgettext --from-code=UTF-8 -L PHP -o messages.po *.php templates/*.php

• 加 --from-code=UTF-8 防止中文乱码
• 指定 -L PHP 让它识别 _()、ngettext() 等函数
• 生成后用 msginit --input=messages.po --locale=zh_CN 初始化新语言分支
• 每次代码新增字符串后，必须重新跑 xgettext 并用 msgmerge 合并旧翻译，否则上线后出现空白文本

# php  # linux  # html  # js  # json  # apache  # nginx  # cookie  # 编码  # 工具  # echo  # if  # count 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： Laravel Octane如何提升性能_使用Laravel Octane加速你的应用  如何安全更换建站之星模板并保留数据？  什么是JavaScript解构赋值_解构赋值有哪些实用技巧  Laravel怎么使用Markdown渲染文档_Laravel将Markdown内容转HTML页面展示【实战】  Laravel的Blade指令怎么自定义_创建你自己的Laravel Blade Directives  Laravel如何记录日志_Laravel Logging系统配置与自定义日志通道  Win11怎么设置虚拟桌面 Win11新建多桌面切换操作【技巧】  如何获取免费开源的自助建站系统源码？  武汉网站设计制作公司,武汉有哪些比较大的同城网站或论坛，就是里面都是武汉人的？  Laravel如何处理文件上传_Laravel Storage门面实现文件存储与管理  Laravel项目结构怎么组织_大型Laravel应用的最佳目录结构实践  香港服务器网站生成指南：免费资源整合与高速稳定配置方案  网页设计与网站制作内容,怎样注册网站？  Laravel怎么实现软删除SoftDeletes_Laravel模型回收站功能与数据恢复【步骤】  网站建设整体流程解析，建站其实很容易！  1688铺货到淘宝怎么操作 1688一键铺货到自己店铺详细步骤  浅谈redis在项目中的应用  php 三元运算符实例详细介绍  Edge浏览器提示“由你的组织管理”怎么解决_去除浏览器托管提示【修复】  如何用腾讯建站主机快速创建免费网站？  Laravel怎么配置自定义表前缀_Laravel数据库迁移与Eloquent表名映射【步骤】  Laravel如何实现API速率限制？（Rate Limiting教程）  在线制作视频网站免费,都有哪些好的动漫网站？  如何快速搭建二级域名独立网站？  如何用wdcp快速搭建高效网站？  Laravel如何升级到最新的版本_Laravel版本升级流程与兼容性处理  如何获取PHP WAP自助建站系统源码？  如何用IIS7快速搭建并优化网站站点？  Laravel如何使用Telescope进行调试？（安装和使用教程）  网站制作公司哪里好做,成都网站制作公司哪家做得比较好，更正规？  北京网站制作费用多少,建立一个公司网站的费用.有哪些部分,分别要多少钱？  浅谈javascript alert和confirm的美化  Laravel如何发送系统通知？（Notification渠道示例）  香港服务器如何优化才能显著提升网站加载速度？  Windows家庭版如何开启组策略(gpedit.msc)？（安装方法）  Laravel Telescope怎么调试_使用Laravel Telescope进行应用监控与调试  Java解压缩zip - 解压缩多个文件或文件夹实例  详解Android图表 MPAndroidChart折线图  Microsoft Edge如何解决网页加载问题 Edge浏览器加载问题修复  使用PHP下载CSS文件中的所有图片【几行代码即可实现】  javascript中对象的定义、使用以及对象和原型链操作小结  VIVO手机上del键无效OnKeyListener不响应的原因及解决方法  javascript基本数据类型及类型检测常用方法小结  Gemini怎么用新功能实时问答_Gemini实时问答使用【步骤】  Laravel怎么实现一对多关联查询_Laravel Eloquent模型关系定义与预加载【实战】  香港服务器租用费用高吗？如何避免常见误区？  猎豹浏览器开发者工具怎么打开 猎豹浏览器F12调试工具使用【前端必备】  网站广告牌制作方法,街上的广告牌，横幅，用PS还是其他软件做的？  如何在VPS电脑上快速搭建网站？  Laravel如何处理文件下载请求？（Response示例）