路由通过解析$_server['request_uri']提取首段路径作为locale,需验证其在支持列表中,且不依赖accept-language或session fallback;视图按语言分目录动态加载,查询参数须从parse_url结果中分离并透传。

路由如何识别语言前缀并提取 locale
PHP 本身不处理 URL 路由,关键在 Web 服务器或框架层做前置解析。Nginx/Apache 需把带语言前缀的路径(如 /zh-CN/about)转给 PHP 时不丢掉前缀;否则 $_SERVER['REQUEST_URI'] 里就只剩 /about,locale 彻底丢失。
常见错误:用 mod_rewrite 或 try_files 直接重写成无前缀路径,没把语言信息传进 PHP。正确做法是保留原始 URI,或通过查询参数/请求头补充,但最稳的是让 PHP 自己从 $_SERVER['REQUEST_URI'] 切分。
- 用
parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH)取纯路径 - 用
explode('/', trim($path, '/'))拆段,首段就是locale(如zh-CN) - 检查首段是否在你支持的语言列表里(
['en', 'zh-CN', 'ja']),不是则跳过或 404 - 别依赖
Accept-Language自动 fallback —— SEO 和分享链接会失效
怎么让同一套控制器逻辑加载不同语言的视图文件
核心不是“切换路由”,而是“根据 locale 动态选模板”。硬编码多套路由(/en/about → AboutEnController,/zh/about → AboutZhController)是反模式,维护爆炸。
正确做法:路由只映射到统一控制器(如 PageController::show()),再由它决定渲染哪个语言版本的视图。
- 视图目录按语言分层:
views/pages/about/en.php、views/pages/about/zh-CN.php - 控制器里拼路径:
$viewPath = "views/pages/{$slug}/{$locale}.php" - 加一层存在性检查:
if (!file_exists($viewPath)) { $viewPath = "views/pages/{$slug}/en.php"; } - 避免用
setlocale()+gettext()做页面级翻译 —— 它适合短文本,不适合整页 HTML 结构
$_GET 参数和语言前缀共存时怎么保留下
用户访问 /zh-CN/search?q=php&page=2,你解析出 locale=zh-CN 后,得把剩下的 q 和 page 安全透传给目标页面,否则搜索结果翻页就崩。
直接 parse_str($_SERVER['QUERY_STRING'], $qs) 不行 —— 它会把整个查询串当扁平键值,而语言前缀本身不在 query string 里。必须从原始 URI 中分离路径与查询串。
- 用
$parsed = parse_url($_SERVER['REQUEST_URI'])拿到path和query - 对
$parsed['path']做语言前缀剥离,剩下真实路由路径(如/search) -
$parsed['query']原样保留,后续生成链接或传参时直接拼回去 - 生成跳转链接时别手写
"?q=...&page=...",用http_build_query($qs)防编码错误
为什么不能把语言前缀塞进 session 或 cookie 自动生效
搜索引擎爬虫不带 session,分享链接给别人也带不来你的 cookie。一旦依赖服务端存储语言偏好,/about 这个 URL 就永远无法确定返回哪版内容,Google 会当成重复页面惩罚。
所有语言路由必须是显式、可索引、可分享的 URL。session 只能作为 fallback:当 URL 里没前缀、且用户之前存过偏好,才用它补上;但首次访问、无历史记录时,必须强制跳转到带前缀的版本(如 302 / → /en/)。
- 检测
$_SERVER['REQUEST_URI']是否以合法locale开头,不是就 302 重定向 - 别用
301做这个跳转 —— 会把根路径/永久缓存成某个语言,换语言时点首页就回不去了 - 语言切换按钮的 href 必须是完整带前缀的 URL,例如从
/zh-CN/contact切到英文,链接是/en/contact,不是/contact?lang=en
语言前缀不是装饰,是语义的一部分。漏掉解析逻辑、或把它当成可选配置,后面 SEO、缓存、CDN 都会出不可见的坑。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











