在 nginx 中去除 url 后缀(如 .html、.php)的核心做法是使用 rewrite 指令配合正则表达式,将带后缀的请求重写到无后缀的路径。具体而言,需要在 location 块中定义匹配规则,例如使用 ~ \.html$ 匹配以 .html 结尾的 uri,并通过 $1 捕获前缀部分,最终指向 /index.php?u=$1 或类似后端处理逻辑。若请求本身不带后缀但文件存在,通常需结合 try_files 进行回退检查,以确保静态资源优先加载。

如何配置正则匹配并提取路径前缀
要准确去除后缀,必须使用带有 ~ 修饰符的正则表达式来区分大小写匹配,并利用括号捕获组提取核心路径。例如,当用户访问 /about.html 时,正则 (.+)\.html$ 会将 /about 存入变量 $1。随后通过 rewrite 指令将请求内部重定向到后端入口脚本,如 /index.php?path=$1。这种写法确保了只有明确带有指定后缀的请求才会被重写,避免误伤正常查询参数。

server {
listen 80;
server_name example.com;
root /var/www/html;
index index.php index.html;
location / {
# 尝试直接查找静态文件或目录
try_files $uri $uri/ @rewrite;
}
location @rewrite {
# 如果未命中静态资源,进入重写逻辑
rewrite ^(.+)\.html$ /index.php?path=$1 last;
rewrite ^(.+)\.php$ /index.php?path=$1 last;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
上述配置中,try_files 首先检查请求是否对应真实存在的文件或目录。若不存在,则跳转到命名位置 @rewrite。在 @rewrite 中,rewrite 指令使用 last 标志终止当前轮询并重试新的 URI。对于输入 /about.html,系统会先尝试查找 /var/www/html/about.html,若文件不存在,则触发重写,最终由 PHP 接收参数 path=/about 进行处理。
如何处理无后缀请求的文件存在性检查
当用户直接访问无后缀 URL(如 /about)时,Nginx 默认不会自动添加后缀去查找文件,除非显式配置。此时应利用 try_files 的链式特性,依次检查 $uri、$uri/ 以及带后缀的变体。例如,配置 try_files $uri $uri.html $uri.php $uri/ =404; 可以让 Nginx 按顺序尝试寻找精确匹配、加 .html 后缀、加 .php 后缀的资源。这种机制避免了使用 rewrite 带来的性能损耗和循环风险,是更推荐的现代 Nginx 配置方式。

# 简化的 try_files 配置示例
location / {
try_files $uri $uri.html $uri.php $uri/ =404;
}
# 对应的 PHP 入口处理逻辑(伪代码)
// $_SERVER['REQUEST_URI'] 仍为 /about
// 后端框架需根据路由表解析 /about
// 若找到对应控制器,则渲染页面
// 否则返回 404
在此场景下,输入 /about 将依次触发以下检查:首先查找 /var/www/html/about,若不存在则查找 /var/www/html/about.html。一旦找到匹配文件,Nginx 直接返回该文件内容,不再执行后续步骤。若所有变体均失败,则返回 404 错误。这种方式无需修改后端代码即可实现“伪静态”效果,且对搜索引擎友好,因为最终输出的 URL 保持无后缀状态。
基于 try_files 链式检查的具体执行结果是什么
当启用 try_files $uri $uri.html $uri.php $uri/ =404; 配置时,针对输入 /contact,若服务器目录下存在 contact.html 但不存在 contact 或 contact.php,Nginx 将直接返回 contact.html 的内容,HTTP 状态码为 200,且浏览器地址栏 URL 保持不变。若同时存在 contact.html 和 contact.php,由于 $uri.html 排在 $uri.php 之前,Nginx 优先返回 HTML 文件。若仅存在 contact.php,则请求将被转发至 PHP-FPM 处理器,由 PHP 脚本生成响应。此行为完全由 try_files 列表中文件的实际存在性决定,而非正则匹配。











