本文介绍如何利用 Nginx 的 rewrite 指令，将用户访问的语义化 URL（如 /en/index.php）透明地映射到实际存在的 PHP 文件（如 /index.php），从而实现 URL 设计与服务器目录结构的完全分离。
本文介绍如何利用 nginx 的 `rewrite` 指令，将用户访问的语义化 url（如 `/en/index.php`）透明地映射到实际存在的 php 文件（如 `/index.php`），从而实现 url 设计与服务器目录结构的完全分离。
在现代 Web 开发中，URL 应具备可读性、可维护性和国际化支持能力——例如 /en/home、/zh/about 或 /fr/contact.php。但这些路径往往并不对应真实的文件系统结构。Nginx 本身不支持 .htaccess 式的动态重写，但其强大的 rewrite 指令配合正则表达式，能高效、安全地完成 URL 到后端脚本的逻辑映射，无需创建冗余目录或重复文件。
核心原理：URL 重写 ≠ 文件移动
Nginx 的 rewrite 是请求阶段的内部路径重写，发生在请求处理流程的早期（rewrite 阶段），它仅修改 $request_uri 和相关变量（如 $args），后续仍由 location 块匹配并交由 PHP-FPM 执行真实文件。这意味着：
- 用户看到的 URL（如 https://example.com/en/index.php）可以任意设计；
- 服务器上只需维护一套核心 PHP 文件（如 /var/www/html/index.php）；
- 语言标识、版本号、区域代码等上下文信息可通过查询参数（如 ?lang=en）或 $_SERVER['PATH_INFO'] 传递给应用层。
实用配置示例
以下是在 server 块中配置的典型规则（需置于 location ~ \.php$ 之前）：
# 将 /{lang}/index.php → /index.php?lang={lang}
rewrite ^/([a-z]{2})/index\.php$ /index.php?lang=$1 last;
# 将 /{lang}/about → /about.php?lang={lang}（支持无扩展名路由）
rewrite ^/([a-z]{2})/(.+)\.php$ /$2.php?lang=$1 last;
# 更灵活的方案：统一入口 + PATH_INFO 支持（推荐用于现代框架）
rewrite ^/([a-z]{2})/(.*)$ /index.php?lang=$1&path=$2 last;✅ last 表示重写后重新匹配 location，确保 PHP 处理器正确介入；
❌ 避免使用 break（终止重写但不重新匹配，可能导致静态文件误判）；
? 正则中的 ([a-z]{2}) 精确匹配两位小写字母语言码，比 (.*) 更安全，防止路径遍历风险。
后端 PHP 如何获取语言参数？
在 index.php 中，你可直接读取：
立即学习“PHP免费学习笔记（深入）”；
<?php
$lang = $_GET['lang'] ?? 'en';
// 或使用更健壮的方式（过滤+默认值）
$lang = in_array($lang, ['en', 'zh', 'fr', 'ja'], true) ? $lang : 'en';
// 加载对应语言包
require_once "lang/{$lang}.php";
echo "Current language: {$lang}";
?>若采用 PATH_INFO 方式（如 rewrite ^/([a-z]{2})/(.*)$ /index.php/$2?lang=$1 last;），还可通过 $_SERVER['PATH_INFO'] 获取原始路径片段，便于构建 RESTful 风格路由。
注意事项与最佳实践
- 顺序至关重要：rewrite 规则必须放在 location 块外部（通常在 server 级），且位于 location ~ \.php$ 之前，否则不会生效；
- 避免循环重写：确保 last 后能被某个 location 成功捕获，建议搭配 log_not_found off; 和 error_log /var/log/nginx/rewrite.log notice; 调试；
- 安全性加固：始终对提取的参数（如 $lang）做白名单校验，禁止直接拼接文件路径；
- 性能考量：Nginx 的 PCRE 正则编译为字节码，单次匹配开销极低，合理使用不会影响吞吐量；
- 替代方案参考：对于复杂路由需求（如 Laravel、Symfony），推荐结合 try_files $uri $uri/ /index.php?$query_string; + 应用内路由，rewrite 仅用于前置标准化（如强制语言前缀）。
通过以上配置，你既能保持 URL 的清晰语义与多语言友好性，又能极大简化部署结构与维护成本——真正的“所见即所需”，而非“所见即所在”。
