Apache通过RewriteRule实现多语言路由,常见方式有路径前缀(如/en/about)、子域名(zh.example.com)和Accept-Language自动跳转,后端解析lang参数或环境变量加载对应语言内容,而非依赖mod_negotiation的内容协商。

Apache 本身不直接“切换语言”,而是通过 URL 重写把用户请求导向对应语言的内容路径或参数,再由后端(如 PHP、Joomla、自定义脚本)读取并渲染相应语言版本。核心是让 URL 可读、可预测、且与后端语言逻辑对齐。
用 RewriteRule 实现路径前缀式多语言
这是最常见、最利于 SEO 的方式,比如:/en/about → 英文版关于页/zh/about → 中文版关于页
在 .htaccess 或虚拟主机配置中添加:
- 启用重写引擎:
RewriteEngine On - 排除真实存在的文件和目录,避免干扰静态资源:
RewriteCond %{REQUEST_FILENAME} !-f和RewriteCond %{REQUEST_FILENAME} !-d - 将带语言前缀的请求转发给统一入口(如 index.php),同时传递语言码:
RewriteRule ^/(en|zh|ja)/(.*)$ /index.php?lang=$1&path=$2 [L,QSA] - 处理根路径(如
/en/或/zh/):RewriteRule ^/(en|zh|ja)/?$ /index.php?lang=$1 [L,QSA]
后端脚本(如 PHP)只需解析 $_GET['lang'],加载对应语言包或查询多语言数据库字段即可。
基于域名的多语言路由
适合不同语言市场独立运营,例如:example.com → 默认(如英文)zh.example.com → 中文站ja.example.com → 日文站
Apache Superset 是一个广泛采用的开源 BI 平台,用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时,此技能非常有用。
配置示例(需提前配置好 DNS 和虚拟主机):
- 为每个子域单独设置 VirtualHost,DocumentRoot 可指向同一套代码,但通过
SetEnv注入语言变量:SetEnv APP_LANG zh - 或统一用主域名 + RewriteCond 判断 Host:
RewriteCond %{HTTP_HOST} ^zh\.example\.com$RewriteRule ^(.*)$ /index.php?lang=zh$1 [QSA,L]
这种方式无需修改 URL 路径结构,后端统一读取环境变量或 Host 头即可识别语言。
配合 Accept-Language 的自动跳转(非协商,是重定向)
如果希望首次访问时根据浏览器语言偏好自动跳转到对应语言首页(如访问 / 自动跳到 /zh/),可用:
- 先获取
%{HTTP:Accept-Language}头:RewriteCond %{HTTP:Accept-Language} ^zh [NC] - 再重定向(注意加 R=302 或 R=301):
RewriteRule ^/$ /zh/ [R=302,L] - 多个语言按顺序判断,避免覆盖(把最具体的放前面,如
zh-TW在zh前)
⚠️ 注意:这种跳转只适用于首页引导,不能替代路径或参数式语言识别,否则会影响书签、分享链接和搜索引擎收录。
与 mod_negotiation 的区别要分清
别混淆「URL 重写」和「内容协商」:
- mod_negotiation(靠 MultiViews)是 Apache 自动匹配 about.en.html、about.zh.html 这类同名不同后缀文件,依赖 Accept-Language,不改 URL;
- mod_rewrite 是你主动控制 URL 形式,并把请求映射到统一逻辑,灵活性更高,也更可控。
实际项目中,90% 的多语言站点用的是 rewrite 方案,因为它兼容 CMS、支持 SEO 友好的路径、便于用户手动切换、也方便做语言 cookie 或 session 持久化。

















