Nginx伪静态规则写法详解:try_files、rewrite与常见程序配置

· 作者:站长资源 · 6 阅读 · 建站技术

伪静态能让动态网站拥有简洁规范的URL。本文讲解Nginx中location匹配、try_files和rewrite指令的用法,给出单入口PHP程序的通用规则,并说明从Apache规则迁移时的注意事项。

什么是伪静态

伪静态是指网站页面实际上由PHP等程序动态生成,但对外展示的URL看起来像静态页面或简洁的目录形式,例如把“/index.php?c=article&id=12”显示为“/news/12.html”。这样的URL更易读,也更便于搜索引擎抓取。实现伪静态需要Web服务器把这些友好URL转交给程序入口处理。

location的匹配规则

Nginx通过location块匹配请求路径。常见的写法有:精确匹配“location = /path”,前缀匹配“location /path”,正则匹配“location ~ 正则”(区分大小写)和“location ~* 正则”(不区分大小写)。匹配优先级大致是:精确匹配最高,然后是带“^~”的前缀匹配,再是按顺序检查的正则匹配,最后是最长的普通前缀匹配。理解优先级可以避免规则互相覆盖。

try_files:单入口程序的首选

现在大多数PHP框架和CMS都采用单一入口文件,所有请求都交给index.php处理。最通用的写法是:

  • location / { try_files $uri $uri/ /index.php?$query_string; }

它的含义是:先查找与请求路径对应的真实文件,再查找同名目录,都不存在时把请求交给index.php,并保留原有的查询参数。这样静态资源由Nginx直接返回,动态请求交给程序路由,性能和兼容性都很好。Laravel、ThinkPHP(配置为PATHINFO以外的模式时)、WordPress等都可以使用类似规则。

rewrite指令

当需要把一种URL格式转换为另一种时,可以使用rewrite。格式为“rewrite 正则 替换地址 标志”。常用标志有:last(重写后重新匹配location)、break(重写后在当前location内继续处理)、redirect(返回302临时跳转)、permanent(返回301永久跳转)。例如把旧地址永久跳转到新地址:rewrite ^/article/(\d+)\.html$ /news/$1.html permanent;

用return实现跳转更高效

对于整站跳转,例如HTTP跳转HTTPS或不带www跳转到带www,使用return比rewrite更简洁高效:在对应的server块中写“return 301 https://www.example.com$request_uri;”,$request_uri会保留完整的路径和参数。

从Apache规则迁移

很多程序只提供了Apache的.htaccess规则,迁移时要注意几点:Nginx不支持.htaccess,规则需要写进站点配置;Apache中的RewriteCond检查文件是否存在(-f、-d),在Nginx中通常用try_files替代;Apache正则中的路径一般不带开头斜杠,而Nginx的$uri以斜杠开头;Apache的[R=301,L]对应Nginx的permanent标志。复杂规则迁移后一定要逐条测试。

安全相关的规则

伪静态配置中也可以加入一些安全限制,例如禁止访问隐藏文件“location ~ /\.(?!well-known) { deny all; }”,禁止上传目录执行PHP,禁止直接访问配置和日志目录。这些规则能减少程序漏洞被利用的风险。

调试技巧

修改配置后先执行“nginx -t”检查语法,再平滑重载。如果规则不生效,可以检查是否有优先级更高的location抢先匹配了请求,或者查看错误日志中的提示。宝塔面板中修改伪静态后会自动重载配置,但仍建议用浏览器和命令行分别测试几个典型URL。

小结

单入口程序优先使用try_files,URL格式转换使用rewrite,整站跳转使用return。掌握location优先级和几个常用指令,大多数伪静态需求都能轻松实现,同时别忘了加入必要的安全限制。

标签: